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: browser/automatic/index.html
+9-9Lines changed: 9 additions & 9 deletions
Original file line number
Diff line number
Diff line change
@@ -3748,16 +3748,17 @@ <h2 id="overview">Overview<a class="headerlink" href="#overview" title="Anchor l
3748
3748
<p>You still need to <strong>take these actions</strong> to ensure a recent build of the <em><abbrtitle="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr></em> app is available in <em><abbrtitle="a method to distribute apps without direct connection">TestFlight</abbr></em> for you to install on your phone when you choose:</p>
3749
3749
<ul>
3750
3750
<li>Keep your <em>Apple Developer</em> account up to date with agreements signed</li>
3751
-
<li><ahref="../bb-update/#renew-certificate" target="_blank">Renew <abbrtitle="Apple certificate is used to sign your iOS or Mac apps - tied to but different from your permanent Developer ID">Certificate</abbr></a> once a year</li>
3751
+
<li>Check your <em><abbrtitle="an online service for storing repositories, accessible from a browser">GitHub</abbr></em> action if you ever get an email saying an automatic action failed</li>
3752
+
<li>Look at your <em><abbrtitle="a method to distribute apps without direct connection">TestFlight</abbr></em> app on the second of every month to make sure a new build is available for you to install when you are ready</li>
3752
3753
</ul>
3753
3754
<h3id="successful-weekly-action">Successful Weekly Action<aclass="headerlink" href="#successful-weekly-action" title="Anchor link to this Header on this Page">¶</a></h3>
3754
-
<p>Normally, you will see a successful <code>build action</code> once a week. This happens at 08:00 <abbrtitle="Coordinated Universal Time is a time standard for civil time and time zones worldwide">UTC</abbr>every Wednesday.</p>
3755
+
<p>Normally, you will see a successful <code>build action</code> once a week. This happens every Wednesday.</p>
3755
3756
<p>If there are no updates to the <code>main</code><abbrtitle="version of code within a single repository or workspace repository">branch</abbr>, your actions show a very short, successful <code>build action</code> as shown in the graphic below. It only takes about a minute because the logic says - no update then skip the build. </p>
3756
3757
<p><imgalt="normal weekly check for updates when there are no updates" src="../img/normal-check-for-updates.png" /></p>
3757
3758
<p>If there is an update, the <code>build action</code> updates your <abbrtitle="a copy of code in a github repository other than the original">fork</abbr> and creates a new build. </p>
3758
3759
<p>In that case, you should check your favorite information site to find out what the update was and then, when you are ready, install the update using the <em><abbrtitle="a method to distribute apps without direct connection">TestFlight</abbr></em> app on your phone.</p>
3759
3760
<h3id="successful-monthly-action">Successful Monthly Action<aclass="headerlink" href="#successful-monthly-action" title="Anchor link to this Header on this Page">¶</a></h3>
3760
-
<p>On the first day of every month at 06:00 <abbrtitle="Coordinated Universal Time is a time standard for civil time and time zones worldwide">UTC</abbr>, you will see a successful <code>build action</code>. The purpose of this build is to provide a recent version of the app in <em><abbrtitle="a method to distribute apps without direct connection">TestFlight</abbr></em> so you are never in a situation where you have no app on your phone.</p>
3761
+
<p>On the first day of every month, you will see a successful <code>build action</code>. The purpose of this build is to provide a recent version of the app in <em><abbrtitle="a method to distribute apps without direct connection">TestFlight</abbr></em> so you are never in a situation where you have no app on your phone.</p>
3761
3762
<p>You start getting <ahref="../../operation/features/notifications/#loop-app-expiration-notification" target="_blank">Notifications</a> when there are fewer than 20 days until expiration. When you see the warning, install the newest build from your <em><abbrtitle="a method to distribute apps without direct connection">TestFlight</abbr></em> app. You do not want to get the dreaded "<abbrtitle="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr> Beta is not available" message on your phone. (The warnings get very agressive when close to expiration.)</p>
3762
3763
<h3id="what-are-the-alive-branches">What are the <code>alive branches</code>?<aclass="headerlink" href="#what-are-the-alive-branches" title="Anchor link to this Header on this Page">¶</a></h3>
3763
3764
<p>The automatic update and build feature is embedded in the build_loop.yml code and uses the <abbrtitle="an online service for storing repositories, accessible from a browser">GitHub</abbr> scheduling feature to trigger actions to run automatically.</p>
@@ -3786,8 +3787,7 @@ <h4 id="automatic-creation-of-alive-branch">Automatic Creation of <code>alive br
3786
3787
</ul>
3787
3788
</div>
3788
3789
<h2id="automatic-certificates">Automatic Certificates<aclass="headerlink" href="#automatic-certificates" title="Anchor link to this Header on this Page">¶</a></h2>
3789
-
<p>Coming soon with <code>Loop 3.6.0</code>. </p>
3790
-
<p>Already here with <code>LoopCaregiver</code>, <code>LoopFollow</code> and some other Open-Source apps.</p>
3790
+
<p>Automatic renewal of certificates is included in <code>Loop 3.6.0</code>.</p>
3791
3791
<h3id="requirements">Requirements<aclass="headerlink" href="#requirements" title="Anchor link to this Header on this Page">¶</a></h3>
3792
3792
<p>You must have the <code>ENABLE_NUKE_CERTS</code> variable set to <code>true</code> for your <em><abbrtitle="an online service for storing repositories, accessible from a browser">GitHub</abbr></em> organization, or when using a personal account to build, add it to each <abbrtitle="contains project files and each file's revision history">repository</abbr>.</p>
<li>You need a new <code>Distribution</code><abbrtitle="Apple certificate is used to sign your iOS or Mac apps - tied to but different from your permanent Developer ID">Certificate</abbr> at <em>Apple</em></li>
3803
3803
<li>You need to create new signing credentials for <code>Match-Secrets</code></li>
3804
3804
</ul>
3805
-
<p>For the <code>Loop</code> app, up through version 3.4.4, you must to do this <ahref="../bb-update/#renew-certificate" target="_blank">Renew <abbrtitle="Apple certificate is used to sign your iOS or Mac apps - tied to but different from your permanent Developer ID">Certificate</abbr></a> process manually. Once version 3.6.0 is released, it will be automatic.</p>
3805
+
<p>For the <code>Loop</code> app, up through version 3.4.4, you had to do this <ahref="../bb-update/#renew-certificate" target="_blank">Renew <abbrtitle="Apple certificate is used to sign your iOS or Mac apps - tied to but different from your permanent Developer ID">Certificate</abbr></a> process manually. Now that version 3.6.0 is released, it is automatic.</p>
3806
3806
</details>
3807
3807
<h3id="automatic-certificate-renewal">Automatic <abbrtitle="Apple certificate is used to sign your iOS or Mac apps - tied to but different from your permanent Developer ID">Certificate</abbr> Renewal<aclass="headerlink" href="#automatic-certificate-renewal" title="Anchor link to this Header on this Page">¶</a></h3>
3808
-
<p>Some Open-Source apps, in particular <code>Trio</code>, <code>LoopCaregiver</code> and <code>LoopFollow</code>already have this capability. It will be available in with the next release of the <em><abbrtitle="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr></em> app (3.6.0).</p>
3808
+
<p>Some Open-Source apps, in particular <code>Trio</code>, <code>LoopCaregiver</code>, <code>LoopFollow</code>and <code>Loop</code> have automatic certificate renewal.</p>
3809
3809
<ul>
3810
3810
<li>
3811
3811
<p>If your signing credentials for the app being built are invalid and <code>ENABLE_NUKE_CERTS</code> is <code>true</code>, then signing credentials will be cleared from your <code>Match-Secrets</code><abbrtitle="contains project files and each file's revision history">repository</abbr>, a new <code>Distribution</code> certificate will be created at <em>Apple</em> and signing credentials for the current app will be generated and stored in <code>Match-Secrets</code>.</p>
<tdstyle="text-align: left;"><spantranslate="no"><abbrtitle="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr></span></td>
Copy file name to clipboardExpand all lines: browser/bb-errors/index.html
+9-16Lines changed: 9 additions & 16 deletions
Original file line number
Diff line number
Diff line change
@@ -4180,7 +4180,7 @@ <h2 id="help-with-errors">Help with Errors<a class="headerlink" href="#help-with
4180
4180
<divclass="admonition important">
4181
4181
<pclass="admonition-title">Get Help, Not Frustrated</p>
4182
4182
<p>For first-time builders, there are a lot of one-time steps that all have to be correct and many screens look similar.</p>
4183
-
<p>If you are updating your build or renewing certificates, the process can be confusing and some error messages can be misleading.</p>
4183
+
<p>If you are updating your build, the process can be confusing and some error messages can be misleading.</p>
4184
4184
<p>If you are having trouble, don't hesitate to ask for help.</p>
4185
4185
<p>Please do NOT:</p>
4186
4186
<ul>
@@ -4234,7 +4234,6 @@ <h3 id="check-upstream-and-keep-alive-error"><code>Check Upstream and Keep Alive
4234
4234
<p><strong>Consequence</strong>: any required sync of your <abbrtitle="a copy of code in a github repository other than the original">fork</abbr> is skipped and build is skipped</p>
4235
4235
<p><strong>Solution</strong>:</p>
4236
4236
<ul>
4237
-
<li>For <code>Loop</code>: wait for 3.6.0 release (coming soon), all other apps are updated</li>
4238
4237
<li>Manually sync your <abbrtitle="a copy of code in a github repository other than the original">fork</abbr> of the <abbrtitle="contains project files and each file's revision history">repository</abbr>: <ahref="../bb-update/#update-fork" target="_blank">Update <code>Fork</code></a></li>
4239
4238
<li>Manually start your build: <ahref="../bb-update/#build-the-app" target="_blank">Build</a></li>
4240
4239
</ul>
@@ -4248,7 +4247,7 @@ <h3 id="most-common-mistakes">Most Common Mistakes<a class="headerlink" href="#m
4248
4247
<pclass="admonition-title"><abbrtitle="Apple certificate is used to sign your iOS or Mac apps - tied to but different from your permanent Developer ID">Certificate</abbr> is missing</p>
4249
4248
<p>If you get this build error message: <code>No code signing identity found and can not create a new one because you enabled</code>, you do not have certificates needed to run the build.</p>
<li>With <code>Loop 3.6.0</code> and newer, this should not happen. Make sure you <ahref="../prepare-fork/#add-variable" target="_blank">Add Variable</a> to automatically renew certificates.</li>
4252
4251
</ul>
4253
4252
</div>
4254
4253
<p>These are some of the most common errors to date.</p>
@@ -4298,13 +4297,12 @@ <h3 id="annotation-without-clear-message-certificates">Annotation without Clear
4298
4297
<p>This is an example of a message that is not terribly descriptive - which is why it is shown here. In this case, you can click on just the one job that failed. There will be less to sort through to find your error. The most likely reason for this error is <ahref="#error-could-not-create">Error: Could not Create</a>.</p>
4299
4298
<h3id="missing-certificates">Missing Certificates<aclass="headerlink" href="#missing-certificates" title="Anchor link to this Header on this Page">¶</a></h3>
4300
4299
<blockquote>
4301
-
<p>Coming soon: when <abbrtitle="Latest release with major updates">Loop 3</abbr>.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 <ahref="../prepare-fork/#add-variable" target="_blank">Add Variable</a> step.</p>
4302
-
<p>After <abbrtitle="Latest release with major updates">Loop 3</abbr>.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 <abbrtitle="Latest release with major updates">Loop 3</abbr>.6.0 fails, try again.</p>
4300
+
<p>With <code>Loop 3.6.0</code> or newer, certificates are automatically renewed if your developer account is up to date, all agreements are signed and you completed the new <ahref="../prepare-fork/#add-variable" target="_blank">Add Variable</a> step.</p>
4303
4301
</blockquote>
4304
4302
<p>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: <code>No code signing identity found and can not create a new one because you enabled</code>.</p>
<p>The first automatic build when <abbrtitle="Latest release with major updates">Loop 3</abbr>.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 <abbrtitle="Latest release with major updates">Loop 3</abbr>.6.0 fails, try again.</p>
4305
+
</blockquote>
4308
4306
<palign="center"><imgalt="graphic showing missing distribution certificate" src="../img/missing-distribution-certificate.png" width="800" /></p>
4309
4307
<h3id="annotation-without-clear-message-build">Annotation without Clear Message (<em>Build</em>)<aclass="headerlink" href="#annotation-without-clear-message-build" title="Anchor link to this Header on this Page">¶</a></h3>
4310
4308
<p>The <abbrtitle="Graphics Interchange Format (GIF) can be used for small animations and low-resolution video clips">GIF</abbr> below shows a failure of <em><spantranslate="no"><em><abbrtitle="an online service for storing repositories, accessible from a browser">GitHub</abbr></em> Action: 4. Build <abbrtitle="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr></span></em> . The nice messages have not been added to this yet - you will have to follow the <ahref="#find-the-error">Find the Error</a> instructions, but now, you are automatically taken to the correct section so there is less of the log to deal with.</p>
@@ -4580,11 +4578,7 @@ <h3 id="error-could-not-find-an-app-on-app-store-connect"><code>Error: Could not
4580
4578
<li>
4581
4579
<p>Make sure you completed the <ahref="../prepare-app/#create-loop-app-in-app-store-connect">Create <abbrtitle="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr> App in App Store Connect</a> Step</p>
4582
4580
<ul>
4583
-
<li>Once you've resolved that step, run these <em><abbrtitle="a custom application for the GitHub Actions platform that performs a complex but frequently repeated task; specifically used to build Loop from a browser">Actions</abbr></em> again:<ul>
4584
-
<li><code>Create Certificates</code></li>
4585
-
<li><code>Build Loop</code></li>
4586
-
</ul>
4587
-
</li>
4581
+
<li>Once you've resolved that step, run <code>Build Loop</code> action again</li>
4588
4582
</ul>
4589
4583
</li>
4590
4584
<li>
@@ -4620,9 +4614,8 @@ <h3 id="error-provisioning-profile"><code>Error: Provisioning Profile</code><a c
<p>Return to <ahref="../prepare-app/#identifiers-for-the-loop-app">First-Time: <abbrtitle="names of modules found on your Apple Developer Identifiers page that are required for GitHub build method">Identifiers</abbr> for the <code>Loop</code> app</a> and make sure you followed all the steps.</p>
4623
-
<p>You must create certificates again before you can build <em><abbrtitle="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr></em>:</p>
4617
+
<p>You can build <em><abbrtitle="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr></em>:</p>
4624
4618
<ul>
4625
-
<li>Action: <code>Create Certificates</code></li>
4626
4619
<li>Action: <code>Build Loop</code></li>
4627
4620
</ul>
4628
4621
<h3id="error-a-new-one-cannot-be-created-because-you-enabled"><code>Error: A new one cannot be created because you enabled</code><aclass="headerlink" href="#error-a-new-one-cannot-be-created-because-you-enabled" title="Anchor link to this Header on this Page">¶</a></h3>
@@ -4817,7 +4810,7 @@ <h3 id="delete-identifiers">Delete <abbr title="names of modules found on your A
4817
4810
</ul>
4818
4811
<palign="center"><imgalt="steps to delete a given identifier" src="../img/delete-identifiers.svg" width="700" /></p>
4819
4812
<p>If coming here because you enter the wrong <code>TEAMID</code> in <code>Secrets</code> - return to <ahref="#rerun-steps-with-correct-teamid">Rerun Steps with Correct <abbrtitle="One of 6 Secrets: Apple Developer account member number">TEAMID</abbr></a> when you've deleted as many identifiers as you can.</p>
4820
-
<p>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.</p>
4813
+
<p>After you delete identifiers, you must add them back before you can build a given app. Configure them and build again.</p>
0 commit comments