Deploying to gh-pages from @ 5fc265a 🚀

Author: marionbarker

build/build-options/index.html

@@ -481,6 +481,28 @@
     </span>
 </a>
 </li>
+<li class="md-nav__item">
+<a class="md-nav__link" href="#archaic-instructions">
+<span class="md-ellipsis">
+      
+        Archaic Instructions
+      
+    </span>
+</a>
+<nav aria-label="Archaic Instructions" class="md-nav">
+<ul class="md-nav__list">
+<li class="md-nav__item">
+<a class="md-nav__link" href="#update-from-loopfollow-v3x">
+<span class="md-ellipsis">
+      
+        Update from LoopFollow v3.x
+      
+    </span>
+</a>
+</li>
+</ul>
+</nav>
+</li>
 </ul>
 </nav>
 </li>
@@ -692,6 +714,28 @@
     </span>
 </a>
 </li>
+<li class="md-nav__item">
+<a class="md-nav__link" href="#archaic-instructions">
+<span class="md-ellipsis">
+      
+        Archaic Instructions
+      
+    </span>
+</a>
+<nav aria-label="Archaic Instructions" class="md-nav">
+<ul class="md-nav__list">
+<li class="md-nav__item">
+<a class="md-nav__link" href="#update-from-loopfollow-v3x">
+<span class="md-ellipsis">
+      
+        Update from LoopFollow v3.x
+      
+    </span>
+</a>
+</li>
+</ul>
+</nav>
+</li>
 </ul>
 </nav>
 </div>
@@ -728,7 +772,6 @@ <h2 id="summary-of-steps-to-build-loopfollow">Summary of Steps to Build <em><abb
 <li><code>Fork</code> the <abbr title="contains project files and each file's revision history">repository</abbr> to your organization</li>
 <li>Open your <code>fork</code> and enable Actions</li>
 <li><code>Add Identifiers</code></li>
-<li>Update <abbr title="names of modules found on your Apple Developer Identifiers page that are required for GitHub build method">Identifiers</abbr></li>
 <li>Add the App in App Store Connect and configure <abbr title="a method to distribute apps without direct connection">TestFlight</abbr> users</li>
 <li><code>Build LoopFollow</code></li>
 </ol>
@@ -885,24 +928,6 @@ <h2 id="review-app-identifier">Review App Identifier<a class="headerlink" href="
 <blockquote>
 <p>If you build from a second or third <code>repository</code> for <code>LoopFollow</code>, the Name will end in <code>Second</code> or <code>Third</code> and Bundle ID will have <code>.Second</code> or <code>.Third</code> at the end.</p>
 </blockquote>
-<h4 id="add-push-notifications-capability-to-loopfollow-identifiers">Add Push Notifications Capability to <abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr> <abbr title="names of modules found on your Apple Developer Identifiers page that are required for GitHub build method">Identifiers</abbr><a class="headerlink" href="#add-push-notifications-capability-to-loopfollow-identifiers" title="Link to this section for reference">¶</a></h4>
-<p>For <abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr> 4.0 and later, you must manually enable the Push Notifications capabilty for the <em><abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr></em> Identifier. </p>
-<p>The example graphic below has numbered steps that match these directions:</p>
-<p>Click to open the <a href="https://developer.apple.com/account/resources/identifiers/list">Certificates, <abbr title="names of modules found on your Apple Developer Identifiers page that are required for GitHub build method">Identifiers</abbr> &amp; Profiles: <abbr title="names of modules found on your Apple Developer Identifiers page that are required for GitHub build method">Identifiers</abbr> List</a> page. </p>
-<ol>
-<li>Locate the <abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr> Identifer and click on it to open the <code>Edit your App ID Configuration</code> screen<ul>
-<li>The name in the <strong><code>NAME</code></strong> column may be different if you previously built with a Mac using <abbr title="program used to build an app">Xcode</abbr>, in that case it will start with XC</li>
-</ul>
-</li>
-<li>Looking at the <code>App Services</code> column, scroll down to the <code>Push Notifications</code> row</li>
-<li>If the check box is not checked, you must check it</li>
-<li>Scroll back to the top and hit Save if you modified that value or All <abbr title="names of modules found on your Apple Developer Identifiers page that are required for GitHub build method">Identifiers</abbr> if you made no changes</li>
-</ol>
-<p>If you made a change and hit Save, you then need to Tap <code>Continue</code> and Tap <code>Save</code> to complete the process.</p>
-<blockquote>
-<p><img alt="graphic showing selection of the push notifications" src="../img/add-push-notifications.svg" width="600"/></p>
-</blockquote>
-<p>Repeat this step if you use LoopFollow_Second or LoopFollow_Third.</p>
 <hr/>
 <h2 id="create-app-in-app-store-connect">Create App in App Store Connect<a class="headerlink" href="#create-app-in-app-store-connect" title="Link to this section for reference">¶</a></h2>
 <p>You must create an App in App Store Connect if you don't already have one.</p>
@@ -1008,6 +1033,79 @@ <h3 id="build-errors">Build Errors<a class="headerlink" href="#build-errors" tit
 </div>
 <h2 id="install-on-phone">Install on Phone<a class="headerlink" href="#install-on-phone" title="Link to this section for reference">¶</a></h2>
 <p>The <a href="https://loopkit.github.io/loopdocs/browser/phone-install">LoopDocs instructions: Install on Phone</a> walk you through the steps to install the app to a phone. When going through those steps, replace your App Name for <em><span translate="no"><abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr></span></em>. Everything else is the same.</p>
+<div class="admonition success">
+<p class="admonition-title">Adding Push Notifications Simplified with v4.4</p>
+<p>Provided in <em><abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr></em> v4.4 and newer, you can run Add <abbr title="names of modules found on your Apple Developer Identifiers page that are required for GitHub build method">Identifiers</abbr> to add the required <code>Push Notifications</code> capability.</p>
+<p>For <em><abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr></em> v4.0 through 4.3, you had to manually add that capability to the Identifier. Thanks to our friends at fastlane, who updated their tool, this manual action is no longer necessary.</p>
+</div>
+<h2 id="archaic-instructions">Archaic Instructions<a class="headerlink" href="#archaic-instructions" title="Link to this section for reference">¶</a></h2>
+<p>Given that a Browser Build must be rebuilt every 90 days, the instructions here are unlikely to be required.</p>
+<h3 id="update-from-loopfollow-v3x">Update from <em><abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr></em> v3.x<a class="headerlink" href="#update-from-loopfollow-v3x" title="Link to this section for reference">¶</a></h3>
+<p>When updating from an older version of <em><abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr></em>, v3.x or older, you need to add the <code>Push Notification</code> to the Identifier Capabilities:</p>
+<ul>
+<li><a href="#sync-your-fork">Sync Your Fork</a></li>
+<li><a href="#run-add-identifiers">Run Add <abbr title="names of modules found on your Apple Developer Identifiers page that are required for GitHub build method">Identifiers</abbr></a> to add the new capability</li>
+<li><a href="#build-your-app">Build Your App</a></li>
+</ul>
+<blockquote>
+<p>Repeat these steps if you use LoopFollow_Second or LoopFollow_Third.</p>
+</blockquote>
+<h4 id="sync-your-fork">Sync Your Fork<a class="headerlink" href="#sync-your-fork" title="Link to this section for reference">¶</a></h4>
+<ul>
+<li>Go to your <em><abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr></em> <abbr title="a copy of code in a github repository other than the original">fork</abbr> and click on the Sync button</li>
+</ul>
+<blockquote>
+<p><img alt="sync the fork" src="../img/github-build-check-fork-status.svg" width="700"/></p>
+</blockquote>
+<h4 id="run-add-identifiers">Run Add <abbr title="names of modules found on your Apple Developer Identifiers page that are required for GitHub build method">Identifiers</abbr><a class="headerlink" href="#run-add-identifiers" title="Link to this section for reference">¶</a></h4>
+<ul>
+<li>In your <em><abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr></em> <abbr title="a copy of code in a github repository other than the original">fork</abbr>, select the Action tab and run the Add <abbr title="names of modules found on your Apple Developer Identifiers page that are required for GitHub build method">Identifiers</abbr> Action</li>
+<li>Wait for a successful completion before trying to Build.</li>
+</ul>
+<details class="abstract">
+<summary>Detailed Instructions to Run Add <abbr title="names of modules found on your Apple Developer Identifiers page that are required for GitHub build method">Identifiers</abbr> (Click to open/close)</summary>
+<p>Refer to the graphic below for the numbered steps:</p>
+<ol>
+<li>Click on the "Actions" tab of your <abbr title="contains project files and each file's revision history">repository</abbr></li>
+<li>On the left side, click on "Add <abbr title="names of modules found on your Apple Developer Identifiers page that are required for GitHub build method">Identifiers</abbr>"</li>
+<li>On the right side, click "Run Workflow" to show a dropdown menu<ul>
+<li>You will see your default <abbr title="version of code within a single repository or workspace repository">branch</abbr> (<code>main</code>)</li>
+<li>You can select a different <abbr title="version of code within a single repository or workspace repository">branch</abbr>, but typically, you run the default</li>
+</ul>
+</li>
+<li>
+<p>Tap the green button that says "Run <abbr title="a set of instructions to GitHub to perform an action; the instruction files are found in the .github/workflows folder of the repository">workflow</abbr>"</p>
+<p align="center"><img alt="add identifiers using github actions" src="../img/action-02-add-identifiers.svg" width="700"/></p>
+</li>
+</ol>
+<p>The <code>Add Identifier</code>  <span class="notranslate">Action</span>  should succeed or fail in a few minutes.</p>
+<ul>
+<li>If you see the green check (<span class="twemoji passed"><svg viewbox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M8 16A8 8 0 1 1 8 0a8 8 0 0 1 0 16m3.78-9.72a.75.75 0 0 0-.018-1.042.75.75 0 0 0-1.042-.018L6.75 9.19 5.28 7.72a.75.75 0 0 0-1.042.018.75.75 0 0 0-.018 1.042l2 2a.75.75 0 0 0 1.06 0Z"></path></svg></span>)  continue to the next section</li>
+<li>If you see the red <code>X</code> (<span class="twemoji failed"><svg viewbox="0 0 16 16" xmlns="http://www.w3.org/2000/svg"><path d="M2.343 13.657A8 8 0 1 1 13.658 2.343 8 8 0 0 1 2.343 13.657M6.03 4.97a.75.75 0 0 0-1.042.018.75.75 0 0 0-.018 1.042L6.94 8 4.97 9.97a.749.749 0 0 0 .326 1.275.75.75 0 0 0 .734-.215L8 9.06l1.97 1.97a.749.749 0 0 0 1.275-.326.75.75 0 0 0-.215-.734L9.06 8l1.97-1.97a.749.749 0 0 0-.326-1.275.75.75 0 0 0-.734.215L8 6.94Z"></path></svg></span>):<ul>
+<li>Use the Browser Build Errors page to resolve the error, then repeat the Action</li>
+<li><a href="https://loopkit.github.io/loopdocs/browser/bb-errors/#quick-reference-for-browser-build-errors">Quick Reference for Browser Build Errors</a></li>
+</ul>
+</li>
+</ul>
+</details>
+<h4 id="build-your-app">Build Your App<a class="headerlink" href="#build-your-app" title="Link to this section for reference">¶</a></h4>
+<ul>
+<li>In your <em><abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr></em> <abbr title="a copy of code in a github repository other than the original">fork</abbr>, select the Action tab and run the Build <abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr> Action</li>
+<li>Wait for a successful completion and wait for the <abbr title="a method to distribute apps without direct connection">TestFlight</abbr> upload (timing varies from a few minutes to a few hours) until trying to install the new build on your phone</li>
+</ul>
+<details class="abstract">
+<summary>Detailed Instructions to Build <abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr> (Click to open/close)</summary>
+<ol>
+<li>Click on the Actions tab of your <em><abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr></em> <abbr title="contains project files and each file's revision history">repository</abbr></li>
+<li>On the left side, click on <code>4. Build LoopFollow</code></li>
+<li>On the right side, click Run Workflow to show a dropdown menu</li>
+<li>Tap the green button that says Run <abbr title="a set of instructions to GitHub to perform an action; the instruction files are found in the .github/workflows folder of the repository">workflow</abbr>.</li>
+</ol>
+<blockquote>
+<p><img alt="add identifiers" src="../img/action-04-build.svg" width="700"/></p>
+</blockquote>
+</details>
+<p><strong>Once this completes, be sure to update from <abbr title="a method to distribute apps without direct connection">TestFlight</abbr> to get the updated version of <em><abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr></em> on your phone.</strong></p>
 </article>
 </div>
 <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>

build/img/add-push-notifications.svg

@@ -668,9 +668,9 @@ <h2 id="remote-control-overview">Remote Control Overview<a class="headerlink" hr
 <p>The <em><abbr title="With a capital L, Loop is one of several do-it-yourself artifical pancreas systems">Loop</abbr></em> app and the open beta version of the <em><abbr title="an iOS app that implements the OpenAPS (oref) algorithm on an iPhone">Trio</abbr></em> app (0.5.x or newer) support direct APNS from <em><abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr></em>.</p>
 <div class="admonition warning">
 <p class="admonition-title">Browser Build Update</p>
-<p>If you use Browser Build, follow the one-time updates needed to transition from <em><abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr></em> v3.2 to <em><abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr></em> v4.0:</p>
+<p>If you use Browser Build and your current build is older than v4.0.0, follow the one-time updates needed to transition from <em><abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr></em> v3.x:</p>
 <ul>
-<li><a href="../../build/build-options/#browser-build-update-for-loopfollow-v40" target="_blank">Browser Build Update for <abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr> v4.0</a></li>
+<li><a href="../../build/lf-browser-build/#update-from-loopfollow-v3x" target="_blank">Update from <em><abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr></em> v3,x</a></li>
 </ul>
 </div>
 <div class="admonition important">
@@ -681,10 +681,6 @@ <h2 id="remote-control-overview">Remote Control Overview<a class="headerlink" hr
 <li><abbr title="an iOS app that implements the OpenAPS (oref) algorithm on an iPhone">Trio</abbr> 0.5.1.28 (or older) requires <abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr> 3.2.11 (or older)</li>
 </ul>
 <p>See <a href="../remote-control-trio/" target="_blank"><abbr title="an iOS app that implements the OpenAPS (oref) algorithm on an iPhone">Trio</abbr> Remote Control</a> for more information.</p>
-<p>For Browser Builders:</p>
-<ul>
-<li><a href="../../build/build-options/#browser-build-update-for-loopfollow-v40" target="_blank">Browser Build Update for <abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr> v4.0</a></li>
-</ul>
 </div>
 <hr/>
 <h2 id="loopfollow-remote-options"><em><abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr></em> Remote Options<a class="headerlink" href="#loopfollow-remote-options" title="Link to this section for reference">¶</a></h2>

build/lf-browser-build/index.html

@@ -972,7 +972,7 @@ <h3 id="real-time-notifications-for-trio">Real-time Notifications for <em><abbr
 <p><strong>Question: What happens if versions are not correct?</strong>: Remote control commands stop working.</p>
 <p><strong>Question: If I was using <abbr title="an iOS app that implements the OpenAPS (oref) algorithm on an iPhone">Trio</abbr> / <abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr> remote control do I need to change my configuration parameters?</strong>: No, the parameters you already set up continue to work. <strong>BUT</strong> you need to update the <em><abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr></em> <abbr title="names of modules found on your Apple Developer Identifiers page that are required for GitHub build method">Identifiers</abbr> if you use Browser Build.</p>
 <ul>
-<li><a href="../../build/build-options/#browser-build-update-for-loopfollow-v40" target="_blank">Browser Build Update for <abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr> v4.0</a></li>
+<li><a href="../../build/lf-browser-build/#update-from-loopfollow-v3x" target="_blank">Update from <em><abbr title="LoopFollow combines custom alerts and display from many open-source apps such as Loop, Trio and Nigthscout">LoopFollow</abbr></em> v3,x</a></li>
 </ul>
 </div>
 <details class="question">