Skip to content

Commit ea40a2f

Browse files
committed
Updates for Browser Build for Loop 3.6.0
1 parent d3e4a6e commit ea40a2f

File tree

9 files changed

+108
-128
lines changed

9 files changed

+108
-128
lines changed

docs/browser/automatic.md

Lines changed: 9 additions & 10 deletions
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

Lines changed: 7 additions & 12 deletions
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

@@ -57,7 +57,7 @@ If you get an error when building with a browser, you can use this page to figur
5757
!!! important "Certificate is missing"
5858
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.
5959
60-
* See [Renew Certificates](bb-update.md#renew-certificate){: target="_blank" }
60+
* 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.
6161
6262
These are some of the most common errors to date.
6363
@@ -116,13 +116,11 @@ This is an example of a message that is not terribly descriptive - which is why
116116
117117
### Missing Certificates
118118
119-
> 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.
120-
121-
> 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.
119+
> 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.
122120
123121
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`.
124122
125-
* See [Renew Certificates](bb-update.md#renew-certificate){: target="_blank" }
123+
> 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.
126124
127125
![graphic showing missing distribution certificate](img/missing-distribution-certificate.png){width="800"}
128126
{align="center"}
@@ -420,9 +418,7 @@ Copy the words on the line below and paste them into the search function for you
420418
If that phrase is found, then:
421419
422420
* Make sure you completed the [Create Loop App in App Store Connect](prepare-app.md#create-loop-app-in-app-store-connect) Step
423-
* Once you've resolved that step, run these *Actions* again:
424-
* `Create Certificates`
425-
* `Build Loop`
421+
* Once you've resolved that step, run `Build Loop` action again
426422
427423
428424
* This can also be caused if you correctly created the *Loop* App but entered an incorrect value for the `TEAMID`.
@@ -454,9 +450,8 @@ For example, you might see:
454450
455451
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.
456452
457-
You must create certificates again before you can build *Loop*:
453+
You can build *Loop*:
458454
459-
* Action: `Create Certificates`
460455
* Action: `Build Loop`
461456
462457
### `Error: A new one cannot be created because you enabled`
@@ -680,4 +675,4 @@ The `Identifier` that is associated with the `Loop` identifier cannot be deleted
680675
681676
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.
682677
683-
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.
678+
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

Lines changed: 1 addition & 4 deletions
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)