Skip to content

Commit 9492e47

Browse files
authored
Update LoopDocs for release 3.6.0
Release/3.6.0
2 parents b9c440f + 7a9ead0 commit 9492e47

12 files changed

+184
-6689
lines changed

docs/browser/automatic.md

+9-10
Original file line numberDiff line numberDiff line change
@@ -17,11 +17,12 @@ Regardless of your choice, please [Disable Automatic Installation from *TestFlig
1717
You still need to **take these actions** to ensure a recent build of the *Loop* app is available in *TestFlight* for you to install on your phone when you choose:
1818

1919
* Keep your *Apple Developer* account up to date with agreements signed
20-
* [Renew Certificate](bb-update.md#renew-certificate){: target="_blank" } once a year
20+
* Check your *GitHub* action if you ever get an email saying an automatic action failed
21+
* Look at your *TestFlight* app on the second of every month to make sure a new build is available for you to install when you are ready
2122

2223
### Successful Weekly Action
2324

24-
Normally, you will see a successful `build action` once a week. This happens at 08:00 UTC every Wednesday.
25+
Normally, you will see a successful `build action` once a week. This happens every Wednesday.
2526

2627
If there are no updates to the `main` branch, your actions show a very short, successful `build action` as shown in the graphic below. It only takes about a minute because the logic says - no update then skip the build.
2728

@@ -33,7 +34,7 @@ In that case, you should check your favorite information site to find out what t
3334

3435
### Successful Monthly Action
3536

36-
On the first day of every month at 06:00 UTC, you will see a successful `build action`. The purpose of this build is to provide a recent version of the app in *TestFlight* so you are never in a situation where you have no app on your phone.
37+
On the first day of every month, you will see a successful `build action`. The purpose of this build is to provide a recent version of the app in *TestFlight* so you are never in a situation where you have no app on your phone.
3738

3839
You start getting [Notifications](../operation/features/notifications.md#loop-app-expiration-notification){: target="_blank" } when there are fewer than 20 days until expiration. When you see the warning, install the newest build from your *TestFlight* app. You do not want to get the dreaded "Loop Beta is not available" message on your phone. (The warnings get very agressive when close to expiration.)
3940

@@ -67,9 +68,7 @@ The `alive` branch you need is created automatically when you run the `Build Loo
6768

6869
## Automatic Certificates
6970

70-
Coming soon with `Loop 3.6.0`.
71-
72-
Already here with `LoopCaregiver`, `LoopFollow` and some other Open-Source apps.
71+
Automatic renewal of certificates is included in `Loop 3.6.0`.
7372

7473
### Requirements
7574

@@ -86,11 +85,11 @@ You must have the `ENABLE_NUKE_CERTS` variable set to `true` for your *GitHub* o
8685
* You need a new `Distribution` Certificate at *Apple*
8786
* You need to create new signing credentials for `Match-Secrets`
8887

89-
For the `Loop` app, up through version 3.4.4, you must to do this [Renew Certificate](bb-update.md#renew-certificate){: target="_blank" } process manually. Once version 3.6.0 is released, it will be automatic.
88+
For the `Loop` app, up through version 3.4.4, you had to do this [Renew Certificate](bb-update.md#renew-certificate){: target="_blank" } process manually. Now that version 3.6.0 is released, it is automatic.
9089

9190
### Automatic Certificate Renewal
9291

93-
Some Open-Source apps, in particular `Trio`, `LoopCaregiver` and `LoopFollow` already have this capability. It will be available in with the next release of the *Loop* app (3.6.0).
92+
Some Open-Source apps, in particular `Trio`, `LoopCaregiver`, `LoopFollow` and `Loop` have automatic certificate renewal.
9493

9594
* If your signing credentials for the app being built are invalid and `ENABLE_NUKE_CERTS` is `true`, then signing credentials will be cleared from your `Match-Secrets` repository, a new `Distribution` certificate will be created at *Apple* and signing credentials for the current app will be generated and stored in `Match-Secrets`.
9695

@@ -106,13 +105,13 @@ The times are shifted to make sure only one Open-Source app performs a `nuke` ac
106105

107106
| Open-Source App | AutoCerts? | Wed<br>UTC | 1st of Month<br>UTC |
108107
|:--|:-:|:-:|:-:|
109-
| <span translate="no">Loop</span> | `dev` only | 09:00 | 07:00 |
108+
| <span translate="no">Loop</span> | &#x2705; | 09:00 | 07:00 |
110109
| <span translate="no">LoopCaregiver</span> | &#x2705; | 13:00 | 11:00 |
111110
| <span translate="no">LoopFollow</span> | &#x2705; | 12:00 | 10:00 |
112111
| <span translate="no">LoopFollow_Second</span> | &#x2705; | 12:20 | 10:20 |
113112
| <span translate="no">LoopFollow_Third</span> | &#x2705; | 12:40 | 10:40 |
114113
| <span translate="no">Trio</span> | &#x2705; | 08:00 | 06:00 |
115-
| <span translate="no">xDrip4iOS</span> | n | 16:00 | 14:00 |
114+
| <span translate="no">xDrip4iOS</span> | &#x274C; | 16:00 | 14:00 |
116115

117116

118117
## Modify Automatic Building

docs/browser/bb-errors.md

+7-13
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
!!! important "Get Help, Not Frustrated"
44
For first-time builders, there are a lot of one-time steps that all have to be correct and many screens look similar.
55

6-
If you are updating your build or renewing certificates, the process can be confusing and some error messages can be misleading.
6+
If you are updating your build, the process can be confusing and some error messages can be misleading.
77

88
If you are having trouble, don't hesitate to ask for help.
99

@@ -61,7 +61,6 @@ Mentors can go to your public&nbsp;_<span translate="no">GitHub repository</span
6161
6262
**Solution**:
6363
64-
* For `Loop`: wait for 3.6.0 release (coming soon), all other apps are updated
6564
* Manually sync your fork of the repository: [Update `Fork`](bb-update.md#update-fork){: target="_blank" }
6665
* Manually start your build: [Build](bb-update.md#build-the-app){: target="_blank" }
6766
@@ -78,7 +77,7 @@ If you get an error when building with a browser, you can use this page to figur
7877
!!! important "Certificate is missing"
7978
If you get this build error message: `No code signing identity found and can not create a new one because you enabled`, you do not have certificates needed to run the build.
8079
81-
* See [Renew Certificates](bb-update.md#renew-certificate){: target="_blank" }
80+
* With `Loop 3.6.0` and newer, this should not happen. Make sure you [Add Variable](prepare-fork.md#add-variable){: target="_blank" } to automatically renew certificates.
8281
8382
These are some of the most common errors to date.
8483
@@ -137,13 +136,11 @@ This is an example of a message that is not terribly descriptive - which is why
137136
138137
### Missing Certificates
139138
140-
> Coming soon: when Loop 3.6.0 (or newer) is available, certificates will be automatically renewed if your developer account is up to date, all agreements are signed and you completed the new [Add Variable](prepare-fork.md#add-variable){: target="_blank" } step.
141-
142-
> After Loop 3.6.0 is released, the first attempt to build will update the files required for automatic certificate creation. The second attempt to build will use the new files. So if the first attempt with Loop 3.6.0 fails, try again.
139+
> With `Loop 3.6.0` or newer, certificates are automatically renewed if your developer account is up to date, all agreements are signed and you completed the new [Add Variable](prepare-fork.md#add-variable){: target="_blank" } step.
143140
144141
If your certificates have expired, you will see this error when you try to build. It does not have a clear annotation. The error string starts with: `No code signing identity found and can not create a new one because you enabled`.
145142
146-
* See [Renew Certificates](bb-update.md#renew-certificate){: target="_blank" }
143+
> The first automatic build when Loop 3.6.0 is released will update the files required for automatic certificate creation. The next automatic build will use the new files. So if the first attempt with Loop 3.6.0 fails, try again.
147144
148145
![graphic showing missing distribution certificate](img/missing-distribution-certificate.png){width="800"}
149146
{align="center"}
@@ -441,9 +438,7 @@ Copy the words on the line below and paste them into the search function for you
441438
If that phrase is found, then:
442439
443440
* Make sure you completed the [Create Loop App in App Store Connect](prepare-app.md#create-loop-app-in-app-store-connect) Step
444-
* Once you've resolved that step, run these *Actions* again:
445-
* `Create Certificates`
446-
* `Build Loop`
441+
* Once you've resolved that step, run `Build Loop` action again
447442
448443
449444
* This can also be caused if you correctly created the *Loop* App but entered an incorrect value for the `TEAMID`.
@@ -475,9 +470,8 @@ For example, you might see:
475470
476471
Return to [First-Time: Identifiers for the `Loop` app](prepare-app.md#identifiers-for-the-loop-app) and make sure you followed all the steps.
477472
478-
You must create certificates again before you can build *Loop*:
473+
You can build *Loop*:
479474
480-
* Action: `Create Certificates`
481475
* Action: `Build Loop`
482476
483477
### `Error: A new one cannot be created because you enabled`
@@ -701,4 +695,4 @@ The `Identifier` that is associated with the `Loop` identifier cannot be deleted
701695
702696
If coming here because you enter the wrong `TEAMID` in `Secrets` - return to [Rerun Steps with Correct TEAMID](#rerun-steps-with-correct-teamid) when you've deleted as many identifiers as you can.
703697
704-
After you delete identifiers, you must add them back before you can build a given app. Configure them and create certificates before you can build again.
698+
After you delete identifiers, you must add them back before you can build a given app. Configure them and build again.

docs/browser/bb-overview.md

+1-4
Original file line numberDiff line numberDiff line change
@@ -50,7 +50,6 @@ The steps on these pages must be completed for you to build an app using a brows
5050
1. [Prepare Identifiers](identifiers.md){: target="_blank" }
5151
1. [Prepare App](prepare-app.md){: target="_blank" }
5252
1. [Prepare *TestFlight* Group](tf-users.md){: target="_blank" }
53-
1. [Create Certificates](certs.md){: target="_blank" }
5453
1. [Build the *Loop* App](build-yml.md){: target="_blank" }
5554

5655
The pages of instructions listed above give detailed steps on how to build the *Loop* app. If you are building a different app, you can follow the detailed instructions but will need to know the Fork, App Name, Identifiers and in some cases App Group for the App you intend to build. Once you build one app, subsequent apps are much easier to build.
@@ -101,9 +100,7 @@ There is also a helpful video for this process. Once again, this was prepared fo
101100

102101
* [How to Update and Rebuild DIY Loop with a Web Browser](https://www.youtube.com/watch?v=0ipTsiqbbrQ){: target="_blank" }
103102

104-
After 3.6.0 is released, certificates will be automatically renewed. In the meantime, they must be renewed manually using these instructions:
105-
106-
* [Renew Certificates](bb-update.md#renew-certificate){: target="_blank" }
103+
> With `Loop 3.6.0`, certificates are automatically created and renewed. You no longer need to renew certificates as a separate step.
107104
108105
## Other Topics
109106

0 commit comments

Comments
 (0)