Skip to content

Commit a67ea4d

Browse files
committed
Deploying to gh-pages from @ 9492e47 🚀
1 parent 77baea0 commit a67ea4d

File tree

13 files changed

+324
-6759
lines changed

13 files changed

+324
-6759
lines changed

browser/automatic/index.html

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -3748,16 +3748,17 @@ <h2 id="overview">Overview<a class="headerlink" href="#overview" title="Anchor l
37483748
<p>You still need to <strong>take these actions</strong> to ensure a recent build of the <em><abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr></em> app is available in <em><abbr title="a method to distribute apps without direct connection">TestFlight</abbr></em> for you to install on your phone when you choose:</p>
37493749
<ul>
37503750
<li>Keep your <em>Apple Developer</em> account up to date with agreements signed</li>
3751-
<li><a href="../bb-update/#renew-certificate" target="_blank">Renew <abbr title="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><abbr title="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><abbr title="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>
37523753
</ul>
37533754
<h3 id="successful-weekly-action">Successful Weekly Action<a class="headerlink" href="#successful-weekly-action" title="Anchor link to this Header on this Page">&para;</a></h3>
3754-
<p>Normally, you will see a successful <code>build action</code> once a week. This happens at 08:00 <abbr title="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>
37553756
<p>If there are no updates to the <code>main</code> <abbr title="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>
37563757
<p><img alt="normal weekly check for updates when there are no updates" src="../img/normal-check-for-updates.png" /></p>
37573758
<p>If there is an update, the <code>build action</code> updates your <abbr title="a copy of code in a github repository other than the original">fork</abbr> and creates a new build. </p>
37583759
<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><abbr title="a method to distribute apps without direct connection">TestFlight</abbr></em> app on your phone.</p>
37593760
<h3 id="successful-monthly-action">Successful Monthly Action<a class="headerlink" href="#successful-monthly-action" title="Anchor link to this Header on this Page">&para;</a></h3>
3760-
<p>On the first day of every month at 06:00 <abbr title="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><abbr title="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><abbr title="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>
37613762
<p>You start getting <a href="../../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><abbr title="a method to distribute apps without direct connection">TestFlight</abbr></em> app. You do not want to get the dreaded "<abbr title="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>
37623763
<h3 id="what-are-the-alive-branches">What are the <code>alive branches</code>?<a class="headerlink" href="#what-are-the-alive-branches" title="Anchor link to this Header on this Page">&para;</a></h3>
37633764
<p>The automatic update and build feature is embedded in the build_loop.yml code and uses the <abbr title="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
37863787
</ul>
37873788
</div>
37883789
<h2 id="automatic-certificates">Automatic Certificates<a class="headerlink" href="#automatic-certificates" title="Anchor link to this Header on this Page">&para;</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>
37913791
<h3 id="requirements">Requirements<a class="headerlink" href="#requirements" title="Anchor link to this Header on this Page">&para;</a></h3>
37923792
<p>You must have the <code>ENABLE_NUKE_CERTS</code> variable set to <code>true</code> for your <em><abbr title="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 <abbr title="contains project files and each file's revision history">repository</abbr>.</p>
37933793
<ul>
@@ -3802,10 +3802,10 @@ <h3 id="requirements">Requirements<a class="headerlink" href="#requirements" tit
38023802
<li>You need a new <code>Distribution</code> <abbr title="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>
38033803
<li>You need to create new signing credentials for <code>Match-Secrets</code></li>
38043804
</ul>
3805-
<p>For the <code>Loop</code> app, up through version 3.4.4, you must to do this <a href="../bb-update/#renew-certificate" target="_blank">Renew <abbr title="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 <a href="../bb-update/#renew-certificate" target="_blank">Renew <abbr title="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>
38063806
</details>
38073807
<h3 id="automatic-certificate-renewal">Automatic <abbr title="Apple certificate is used to sign your iOS or Mac apps - tied to but different from your permanent Developer ID">Certificate</abbr> Renewal<a class="headerlink" href="#automatic-certificate-renewal" title="Anchor link to this Header on this Page">&para;</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><abbr title="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>
38093809
<ul>
38103810
<li>
38113811
<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> <abbr title="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>
@@ -3833,7 +3833,7 @@ <h3 id="open-source-app-schedule">Open-Source App Schedule<a class="headerlink"
38333833
<tbody>
38343834
<tr>
38353835
<td style="text-align: left;"><span translate="no"><abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr></span></td>
3836-
<td style="text-align: center;"><code>dev</code> only</td>
3836+
<td style="text-align: center;">&#x2705;</td>
38373837
<td style="text-align: center;">09:00</td>
38383838
<td style="text-align: center;">07:00</td>
38393839
</tr>
@@ -3869,7 +3869,7 @@ <h3 id="open-source-app-schedule">Open-Source App Schedule<a class="headerlink"
38693869
</tr>
38703870
<tr>
38713871
<td style="text-align: left;"><span translate="no">xDrip4iOS</span></td>
3872-
<td style="text-align: center;">n</td>
3872+
<td style="text-align: center;">&#x274C;</td>
38733873
<td style="text-align: center;">16:00</td>
38743874
<td style="text-align: center;">14:00</td>
38753875
</tr>

browser/bb-errors/index.html

Lines changed: 9 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -4180,7 +4180,7 @@ <h2 id="help-with-errors">Help with Errors<a class="headerlink" href="#help-with
41804180
<div class="admonition important">
41814181
<p class="admonition-title">Get Help, Not Frustrated</p>
41824182
<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>
41844184
<p>If you are having trouble, don't hesitate to ask for help.</p>
41854185
<p>Please do NOT:</p>
41864186
<ul>
@@ -4234,7 +4234,6 @@ <h3 id="check-upstream-and-keep-alive-error"><code>Check Upstream and Keep Alive
42344234
<p><strong>Consequence</strong>: any required sync of your <abbr title="a copy of code in a github repository other than the original">fork</abbr> is skipped and build is skipped</p>
42354235
<p><strong>Solution</strong>:</p>
42364236
<ul>
4237-
<li>For <code>Loop</code>: wait for 3.6.0 release (coming soon), all other apps are updated</li>
42384237
<li>Manually sync your <abbr title="a copy of code in a github repository other than the original">fork</abbr> of the <abbr title="contains project files and each file's revision history">repository</abbr>: <a href="../bb-update/#update-fork" target="_blank">Update <code>Fork</code></a></li>
42394238
<li>Manually start your build: <a href="../bb-update/#build-the-app" target="_blank">Build</a></li>
42404239
</ul>
@@ -4248,7 +4247,7 @@ <h3 id="most-common-mistakes">Most Common Mistakes<a class="headerlink" href="#m
42484247
<p class="admonition-title"><abbr title="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>
42494248
<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>
42504249
<ul>
4251-
<li>See <a href="../bb-update/#renew-certificate" target="_blank">Renew Certificates</a></li>
4250+
<li>With <code>Loop 3.6.0</code> and newer, this should not happen. Make sure you <a href="../prepare-fork/#add-variable" target="_blank">Add Variable</a> to automatically renew certificates.</li>
42524251
</ul>
42534252
</div>
42544253
<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
42984297
<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 <a href="#error-could-not-create">Error: Could not Create</a>.</p>
42994298
<h3 id="missing-certificates">Missing Certificates<a class="headerlink" href="#missing-certificates" title="Anchor link to this Header on this Page">&para;</a></h3>
43004299
<blockquote>
4301-
<p>Coming soon: when <abbr title="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 <a href="../prepare-fork/#add-variable" target="_blank">Add Variable</a> step.</p>
4302-
<p>After <abbr title="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 <abbr title="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 <a href="../prepare-fork/#add-variable" target="_blank">Add Variable</a> step.</p>
43034301
</blockquote>
43044302
<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>
4305-
<ul>
4306-
<li>See <a href="../bb-update/#renew-certificate" target="_blank">Renew Certificates</a></li>
4307-
</ul>
4303+
<blockquote>
4304+
<p>The first automatic build when <abbr title="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 <abbr title="Latest release with major updates">Loop 3</abbr>.6.0 fails, try again.</p>
4305+
</blockquote>
43084306
<p align="center"><img alt="graphic showing missing distribution certificate" src="../img/missing-distribution-certificate.png" width="800" /></p>
43094307
<h3 id="annotation-without-clear-message-build">Annotation without Clear Message (<em>Build</em>)<a class="headerlink" href="#annotation-without-clear-message-build" title="Anchor link to this Header on this Page">&para;</a></h3>
43104308
<p>The <abbr title="Graphics Interchange Format (GIF) can be used for small animations and low-resolution video clips">GIF</abbr> below shows a failure of&nbsp;<em><span translate="no"><em><abbr title="an online service for storing repositories, accessible from a browser">GitHub</abbr></em> Action: 4. Build <abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr></span></em>&nbsp;. The nice messages have not been added to this yet - you will have to follow the <a href="#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
45804578
<li>
45814579
<p>Make sure you completed the <a href="../prepare-app/#create-loop-app-in-app-store-connect">Create <abbr title="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>
45824580
<ul>
4583-
<li>Once you've resolved that step, run these <em><abbr title="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>
45884582
</ul>
45894583
</li>
45904584
<li>
@@ -4620,9 +4614,8 @@ <h3 id="error-provisioning-profile"><code>Error: Provisioning Profile</code><a c
46204614
<li><code>error: Provisioning profile "match AppStore com.***.loopkit.Loop.Loop-Intent-Extension</code></li>
46214615
</ul>
46224616
<p>Return to <a href="../prepare-app/#identifiers-for-the-loop-app">First-Time: <abbr title="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><abbr title="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><abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr></em>:</p>
46244618
<ul>
4625-
<li>Action: <code>Create Certificates</code></li>
46264619
<li>Action: <code>Build Loop</code></li>
46274620
</ul>
46284621
<h3 id="error-a-new-one-cannot-be-created-because-you-enabled"><code>Error: A new one cannot be created because you enabled</code><a class="headerlink" href="#error-a-new-one-cannot-be-created-because-you-enabled" title="Anchor link to this Header on this Page">&para;</a></h3>
@@ -4817,7 +4810,7 @@ <h3 id="delete-identifiers">Delete <abbr title="names of modules found on your A
48174810
</ul>
48184811
<p align="center"><img alt="steps to delete a given identifier" src="../img/delete-identifiers.svg" width="700" /></p>
48194812
<p>If coming here because you enter the wrong <code>TEAMID</code> in <code>Secrets</code> - return to <a href="#rerun-steps-with-correct-teamid">Rerun Steps with Correct <abbr title="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>
48214814

48224815

48234816

0 commit comments

Comments
 (0)