You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: fastlane/testflight.md
+17-25Lines changed: 17 additions & 25 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,12 +10,10 @@ These instructions allow you to build your app without having access to a Mac.
10
10
## **Automatic Builds**
11
11
>
12
12
> The browser build **defaults to** automatically updating and building a new version of Loop according to this schedule:
13
-
> - automatically checks for updates weekly on Wednesdays and if updates are found, it will build a new version of the app
14
-
> - automatically builds once a month regardless of whether there are updateson the first of the month
15
-
> - with each scheduled run (weekly or monthly), a successful Build Loop log appears - if the time is very short, it did not need to build - only the long actions (>20 minutes) built a new Loop app
13
+
> - automatically checks for updates weekly and if updates are found, it will build a new version of the app
14
+
> - even when there are no updates, it builds on the second Sunday of the month
15
+
> - with each scheduled weekly run, a successful build log appears - if the time is very short, it did not need to build - only the long actions (>20 minutes) built a new app
16
16
>
17
-
> It also creates an alive branch, if you don't already have one. See [Why do I have an alive branch?](#why-do-i-have-an-alive-branch).
18
-
>
19
17
> The [**Optional**](#optional) section provides instructions to modify the default behavior if desired.
20
18
21
19
> **Repeat Builders**
@@ -191,7 +189,7 @@ You do not need to fill out the next form. That is for submitting to the app sto
191
189
192
190
## Create Building Certificates
193
191
194
-
This step is no longer required. The Build Loop function now takes care of this for you. It does not hurt to run it but is not needed.
192
+
This step is no longer required. The build action now takes care of this for you. It does not hurt to run it but is not needed.
195
193
196
194
Once a year, you will get an email from Apple indicating your certificate will expire in 30 days. You can ignore that email. When it does expire, the next time an automatic or manual build happens, the expired certificate information will be removed (nuked) from your Match-Secrets repository and a new one created. This should happen without you needing to take any action.
197
195
@@ -212,13 +210,7 @@ Please refer to [LoopDocs: TestFlight Overview](https://loopkit.github.io/loopdo
212
210
213
211
## Automatic Build FAQs
214
212
215
-
### Why do I have an `alive` branch?
216
-
217
-
If a GitHub repository has no activity (no commits are made) in 60 days, then GitHub disables the ability to use automated actions for that repository. We need to take action more frequently than that or the automated build process won't work.
218
-
219
-
The updated `build_loop.yml` file uses a special branch called `alive` and adds a dummy commit to the `alive` branch at regular intervals. This "trick" keeps the Actions enabled so the automated build works.
220
-
221
-
The branch `alive` is created automatically for you. Do not delete or rename it! Do not modify `alive` yourself; it is not used for building the app.
213
+
If a GitHub repository has no activity (no commits are made) in 60 days, then GitHub disables the ability to use automated actions for that repository. You may need to manually enable your build action and manually execute it when your fork becomes stale.
222
214
223
215
## OPTIONAL
224
216
@@ -248,18 +240,18 @@ You can modify the automation by creating and using some variables.
248
240
249
241
To configure the automated build more granularly involves creating up to two environment variables: `SCHEDULED_BUILD` and/or `SCHEDULED_SYNC`. See [How to configure a variable](#how-to-configure-a-variable).
250
242
251
-
Note that the weekly and monthly Build Loop actions will continue, but the actions are modified if one or more of these variables is set to false. **A successful Action Log will still appear, even if no automatic activity happens**.
243
+
Note that the weekly build actions will continue, but the actions are modified if one or more of these variables is set to false. **A successful Action Log will still appear, even if no automatic activity happens**.
252
244
253
-
* If you want to manually decide when to update your repository to the latest commit, but you want the monthly builds and keep-alive to continue: set `SCHEDULED_SYNC` to false and either do not create `SCHEDULED_BUILD` or set it to true
245
+
* If you want to manually decide when to update your repository to the latest commit, but you want the monthly builds to continue: set `SCHEDULED_SYNC` to false and either do not create `SCHEDULED_BUILD` or set it to true
254
246
* If you want to only build when an update has been found: set `SCHEDULED_BUILD` to false and either do not create `SCHEDULED_SYNC` or set it to true
255
247
***Warning**: if no updates to your default branch are detected within 90 days, your previous TestFlight build may expire requiring a manual build
|`true` (or NA) |`true` (or NA) |keep-alive, weekly update check (auto update/build), monthly build with auto update|
260
-
|`true` (or NA) |`false`|keep-alive, weekly update check with auto update, only builds if update detected|
261
-
|`false`|`true` (or NA) |keep-alive, monthly build, no auto update |
262
-
|`false`|`false`| no automatic activity, no keep-alive|
251
+
|`true` (or NA) |`true` (or NA) | weekly update check (auto update/build), monthly build with auto update|
252
+
|`true` (or NA) |`false`| weekly update check with auto update, only builds if update detected|
253
+
|`false`|`true` (or NA) | monthly build, no auto update |
254
+
|`false`|`false`| no automatic activity|
263
255
264
256
### How to configure a variable
265
257
@@ -280,12 +272,12 @@ Note that the weekly and monthly Build Loop actions will continue, but the actio
280
272
281
273
Your build will run on the following conditions:
282
274
- Default behaviour:
283
-
- Run weekly, every Wednesday at 08:00 UTC to check for changes; if there are changes, it will update your repository and build
284
-
- Run monthly, every first of the month at 06:00 UTC, if there are changes, it will update your repository; regardless of changes, it will build
285
-
- Each time the action runs, it makes a keep-alive commit to the `alive` branch if necessary
286
-
- If you disable any automation (both variables set to `false`), no updates, keep-alive or building happens when Build Loop runs
287
-
- If you disabled just scheduled synchronization (`SCHEDULED_SYNC` set to`false`), it will only run once a month, on the first of the month, no update will happen; keep-alive will run
288
-
- If you disabled just scheduled build (`SCHEDULED_BUILD` set to`false`), it will run once weekly, every Wednesday, to check for changes; if there are changes, it will update and build; keep-alive will run
275
+
- Run weekly every Sunday
276
+
- If updates are detected, it will update your repository and build
277
+
- If it is the second Sunday of the month, it will build even when no changes are detected
278
+
- If you disable any automation (both variables set to `false`), no updatesor building happens when the build action runs
279
+
- If you disabled just scheduled synchronization (`SCHEDULED_SYNC` set to`false`), it will still build once a month, but no update will happen
280
+
- If you disabled just scheduled build (`SCHEDULED_BUILD` set to`false`), it will run once weekly, to check for changes; if there are changes, it will update and build
289
281
290
282
## What if I build using more than one GitHub username
0 commit comments