Deploying to gh-pages from @ 38f6a83 🚀

Author: marionbarker

browser/bb-errors/index.html

@@ -1191,6 +1191,15 @@
     <nav class="md-nav" aria-label="Update Fork">
       <ul class="md-nav__list">
 
+          <li class="md-nav__item">
+  <a href="#update-from-32x-to-34" class="md-nav__link">
+    <span class="md-ellipsis">
+      Update from 3.2.x to 3.4
+    </span>
+  </a>
+  
+</li>
+        
           <li class="md-nav__item">
   <a href="#special-instructions-for-360" class="md-nav__link">
     <span class="md-ellipsis">
@@ -3724,6 +3733,15 @@
     <nav class="md-nav" aria-label="Update Fork">
       <ul class="md-nav__list">
 
+          <li class="md-nav__item">
+  <a href="#update-from-32x-to-34" class="md-nav__link">
+    <span class="md-ellipsis">
+      Update from 3.2.x to 3.4
+    </span>
+  </a>
+  
+</li>
+        
           <li class="md-nav__item">
   <a href="#special-instructions-for-360" class="md-nav__link">
     <span class="md-ellipsis">
@@ -4046,6 +4064,113 @@ <h2 id="update-fork">Update <code>Fork</code><a class="headerlink" href="#update
 <p>This is Step 2 of 5 - it may not always be necessary, but please check every time.</p>
 </blockquote>
 <p>Open your <em><abbr title="an online service for storing repositories, accessible from a browser">GitHub</abbr></em> account and select your <code>LoopWorkspace <abbr title="contains project files and each file's revision history">repository</abbr></code> from your repositories list.</p>
+<h3 id="update-from-32x-to-34">Update from 3.2.x to 3.4<a class="headerlink" href="#update-from-32x-to-34" title="Anchor link to this Header on this Page">&para;</a></h3>
+<p>This should only be necessary if you are changing from an older, Mac-<abbr title="program used to build an app">Xcode</abbr> build of version 3.2.x to a Browser Build of 3.6.x. Most people are updating from 3.4.x to 3.6.x and should skip ahead to <a href="#special-instructions-for-360">Special Instructions for 3.6.0</a>.</p>
+<p>For the update from 3.2.x to 3.6, you must do more than "just" build. If you skip this step - the build will fail.</p>
+<ul>
+<li>The <code>Identifier</code> for the "<code>widget</code>" changed from "<code>SmallStatusWidget</code>" to the more descriptive "<code>LoopWidgetExtension</code>"</li>
+</ul>
+<blockquote>
+<p>If you built version 3.3.0 (the <code>dev branch</code> before release of version 3.4) or newer, you can skip ahead to <a href="#special-instructions-for-360">Special Instructions for 3.6.0</a>.</p>
+</blockquote>
+<p>You will (1) run <a href="#add-identifiers"><code>Add Identifiers</code></a>, (2) <a href="#add-app-group-to-new-identifier">add the <code>App Group</code></a> to the new identifier, (3) run <a href="#create-certificates"><code>Create Certificates</code></a> and then (4) run <a href="#build-the-app"><code>Build Loop</code></a>.</p>
+<h4 id="add-identifiers">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="#add-identifiers" title="Anchor link to this Header on this Page">&para;</a></h4>
+<p>In your <abbr title="a copy of code in a github repository other than the original">fork</abbr> of LoopWorkspace:</p>
+<ul>
+<li>Run the Action: <code>Add Identifier</code></li>
+<li>Wait for it to succeed</li>
+</ul>
+<details class="tip">
+<summary>Detailed instructions for <code>Add Identifier</code> (Click to open/close)</summary>
+<p>Refer to the graphic below for the numbered steps:</p>
+<ol>
+<li>Click on the <code>Actions</code> tab of your <code>LoopWorkspace</code> <abbr title="contains project files and each file's revision history">repository</abbr></li>
+<li>On the left side, click on 2. <code>Add <abbr title="names of modules found on your Apple Developer Identifiers page that are required for GitHub build method">Identifiers</abbr></code></li>
+<li>On the right side, click <code>Run Workflow</code> 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> (typically this is <code>main</code>)</li>
+</ul>
+</li>
+<li>
+<p>Tap the green button that says <code>Run workflow</code>.</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 Identifiers</code> &nbsp;<span class=notranslate>Action</span>&nbsp; should succeed or fail in a few minutes. Do not continue to the next step until this one succeeds.</p>
+<ul>
+<li>If you see the green check (<span class="twemoji passed"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><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"/></svg></span>)  continue to the next section</li>
+<li>If you see the red <code>X</code> (<span class="twemoji failed"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 16 16"><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"/></svg></span>):<ul>
+<li><a href="../bb-errors/#action-add-identifiers-errors" target="_blank">Action: Add <abbr title="names of modules found on your Apple Developer Identifiers page that are required for GitHub build method">Identifiers</abbr> Errors</a> tells you what to search for in the file</li>
+<li>Resolve the error and repeat <code>Add Identifiers</code></li>
+</ul>
+</li>
+</ul>
+</details>
+<h4 id="add-app-group-to-new-identifier">Add <code>App Group</code> to New <code>Identifier</code><a class="headerlink" href="#add-app-group-to-new-identifier" title="Anchor link to this Header on this Page">&para;</a></h4>
+<p>Open the <a href="https://developer.apple.com/account/resources/identifiers/list" target="_blank">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>
+<p>Click on the "<code>LoopWidgetExtension</code>" identifier to open the <code>Edit Your App ID Configuration</code> screen.</p>
+<table>
+<thead>
+<tr>
+<th><code>NAME</code></th>
+<th><code>IDENTIFIER</code></th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td><code>Loop Widget Extension</code></td>
+<td><code>com.TEAMID.loopkit.Loop.LoopWidgetExtension</code></td>
+</tr>
+</tbody>
+</table>
+<p>The graphic below has numbered steps that match these directions:</p>
+<ol>
+<li>Looking at the <code>App Services</code> column, scroll down to the <code>App Groups</code> row and ensure the check box (under the <code>Capabilities column</code>) for <code>App Groups</code> is checked</li>
+<li>If the word <code>Configure</code> shows up, tap on it<ul>
+<li>This opens the <code>App Group Assignment</code> screen</li>
+<li>If it said <code>Edit</code> instead of <code>Configure</code> - you can click to confirm you have the correct <abbr title="a unique identifier that Apple users for a given app, yours has your TEAMID embedded in it, group.com.TEAMID.loopkit.LoopGroup">App Group</abbr> but won't need to continue or save if it is correct</li>
+</ul>
+</li>
+<li>Check the box by <code>Loop App Group</code> that uses your <code>TEAMID</code> in <code>group.com.TEAMID.loopkit.LoopGroup</code><ul>
+<li>Note that if you previously built with <abbr title="program used to build an app">Xcode</abbr>, the name may be different, i.e., <code>XC group com TEAMID loopkit LoopGroup</code></li>
+</ul>
+</li>
+<li>Tap <code>Continue</code></li>
+<li>Tap <code>Save</code></li>
+</ol>
+<p align="center"><img alt="graphic showing selection of the correct App Group" src="../img/update-identifier-loop-3-4.png" width="700" /></p>
+<p>If you did not need to make changes, the <code>Save</code> button will not be active.</p>
+<ul>
+<li>Tap on the <code>&lt; All Identifiers</code> link at the top left</li>
+</ul>
+<p>The full list of <abbr title="names of modules found on your Apple Developer Identifiers page that are required for GitHub build method">Identifiers</abbr> should be displayed again.</p>
+<div class="admonition note">
+<p class="admonition-title">Other <abbr title="names of modules found on your Apple Developer Identifiers page that are required for GitHub build method">Identifiers</abbr></p>
+<p>All other identifiers should be already set up.</p>
+<ul>
+<li>If they are not, refer to <a href="../prepare-app/#add-app-group-to-identifiers" target="_blank">Configure to Use Browser: Add <abbr title="a unique identifier that Apple users for a given app, yours has your TEAMID embedded in it, group.com.TEAMID.loopkit.LoopGroup">App Group</abbr> to <abbr title="names of modules found on your Apple Developer Identifiers page that are required for GitHub build method">Identifiers</abbr></a></li>
+</ul>
+</div>
+<h4 id="create-certificates">Create Certificates<a class="headerlink" href="#create-certificates" title="Anchor link to this Header on this Page">&para;</a></h4>
+<p>You must run the action <code>Create Certificates</code> again because the <code>Identifiers</code> were updated. Wait for this to succeed before trying to build.</p>
+<details class="tip" open="open">
+<summary>Detailed instructions (Click to open/close)</summary>
+<p>Refer to the graphic below for the numbered steps:</p>
+<ol>
+<li>Click on the "<code><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></code>" tab of your <code>LoopWorkspace</code> <abbr title="contains project files and each file's revision history">repository</abbr></li>
+<li>On the left side, click on "<code>Create Certificates</code>"</li>
+<li>On the right side, click "<code>Run Workflow</code>" 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> (typically <code>main</code>)</li>
+</ul>
+</li>
+<li>
+<p>Tap the green button that says "<code>Run workflow</code>".</p>
+<p align="center"><img alt="create certificates using github actions" src="../img/action-03-create-certs.svg" width="700" /></p>
+</li>
+<li>
+<p>Wait a minute or two for the action to finish</p>
+</li>
+</ol>
+</details>
 <h3 id="special-instructions-for-360">Special Instructions for 3.6.0<a class="headerlink" href="#special-instructions-for-360" title="Anchor link to this Header on this Page">&para;</a></h3>
 <p>When updating to version 3.6.0, there are two "extra" things to do.</p>
 <ul>
@@ -4324,7 +4449,7 @@ <h3 id="manual-steps-to-renew-your-distribution-certificate">Manual Steps to Ren
 <p align="center"><img alt="delete the distributon certs folder in your Match-Secrets repository" src="../img/delete-distr-certs-match-secrets.gif" width="650" /></p>
 <div class="admonition question">
 <p class="admonition-title">Deleting the certs/distribution folder did not work for me</p>
-<p>Some people reported trouble with this step. The other option is to delete and create a new <code>Match-Secrets</code> <abbr title="contains project files and each file's revision history">repository</abbr>: see <a href="../bb-errors/#reset-match-secrets" target="_blank">Reset <code>Match-Secrets</code></a></p>
+<p>Some people reported trouble with this step. The other option is to delete and create a new <code>Match-Secrets</code> <abbr title="contains project files and each file's revision history">repository</abbr>: see <a href="../bb-errors/#delete-match-secrets" target="_blank">Delete <code>Match-Secrets</code></a></p>
 </div>
 </li>
 <li>