Skip to content

Commit e02e46a

Browse files
committed
update testflight.md now that alive branches are removed
1 parent 263d703 commit e02e46a

1 file changed

Lines changed: 17 additions & 25 deletions

File tree

fastlane/testflight.md

Lines changed: 17 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -10,12 +10,10 @@ These instructions allow you to build your app without having access to a Mac.
1010
## **Automatic Builds**
1111
>
1212
> 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 updates on 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
1616
>
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-
>
1917
> The [**Optional**](#optional) section provides instructions to modify the default behavior if desired.
2018
2119
> **Repeat Builders**
@@ -191,7 +189,7 @@ You do not need to fill out the next form. That is for submitting to the app sto
191189

192190
## Create Building Certificates
193191

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.
195193

196194
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.
197195

@@ -212,13 +210,7 @@ Please refer to [LoopDocs: TestFlight Overview](https://loopkit.github.io/loopdo
212210

213211
## Automatic Build FAQs
214212

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.
222214

223215
## OPTIONAL
224216

@@ -248,18 +240,18 @@ You can modify the automation by creating and using some variables.
248240

249241
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).
250242

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**.
252244

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
254246
* 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
255247
* **Warning**: if no updates to your default branch are detected within 90 days, your previous TestFlight build may expire requiring a manual build
256248

257249
|`SCHEDULED_SYNC`|`SCHEDULED_BUILD`|Automatic Actions|
258250
|---|---|---|
259-
| `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|
263255

264256
### How to configure a variable
265257

@@ -280,12 +272,12 @@ Note that the weekly and monthly Build Loop actions will continue, but the actio
280272

281273
Your build will run on the following conditions:
282274
- 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 updates or 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
289281

290282
## What if I build using more than one GitHub username
291283

0 commit comments

Comments
 (0)