Build Dev with Browser

Summary of Tasks to Build Trio dev¶

These steps assume:

• You previously built Trio using GitHub Actions (Browser Build)
• You confirmed your Apple Developer license agreements are up to date

These are the new steps for you to follow:

1. Configure Fork with dev branch
   • Optional: Configure the dev branch as default
2. If new Identifiers are required: Update Identifiers
3. If Time Sensitive Notifications hasn't been enabled yet: Enable Time Sensitive Notifications
4. Optional: Update Certificates; this is included in Build Trio
5. Build Trio dev

Configure Fork with dev branch¶

• If you do not have a dev branch you must first configure one following these directions.
• If you already have a dev branch, skip ahead to Update Branch and be sure to select the dev branch when you update your fork.

Add Branch¶

First, you need to get to your fork of the Trio repository and tap on the branch icon. (Do not worry about how many branches you have.):

The next screen displays the branches you currently have.

• If the branch you want is already there - click on it so you can make sure it is in sync with Trio
• If the branch you want is not there, tap on the New branch button on upper right
  • If there is not a New branch button in the upper right, you are not logged in

Each step in the list below matches with the number in the graphic. On the left half of the graphic is the default selections for your fork when main is the default branch. The right side shows the display after making the indicated selections:

1. Click on the drop-down menu labeled 1 in the graphic and choose nightscout/Trio
2. Click on the drop-down menu labeled 2 in the graphic and choose dev
3. Click on the Branch name box labeled 3 in the graphic and type dev
   • The branch name in your fork should always match the branch name you are adding; check that you type it correctly
4. Review the dialog items to make sure everything is correct, and then tap on Create branch

Configure the dev branch as default¶

This recommendation is only for expert testers who are using dev or a feature branch for their personal use. Typically only developers configure the dev branch as their default branch.

• By making the dev branch your default, you will get automatic build of any dev updates weekly
• You will no longer get automated builds of the main branch, but can run those manually

These are the steps to modify the default branch.

For this example, we show how to change from a default branch of main to a default branch of dev. Note — only the owner of the repository can take this action and they must be logged in. Otherwise the Settings tab does not appear.

For the numbered steps below, refer to the graphic found under each group of steps.

1. Click on the Settings Icon near the top right of your Trio repository

   • You may need to scroll down to see the Default Branch as shown in the graphic
   • Do not tap on the Branches tab to the left under Code and Automation, that is not the correct menu

   

2. To the right of the default branch name there is a pencil and a left-right arrow icon (⇄)

   • Tap on the left-right arrow icon (⇄) to bring up the Switch default branch to another branch dialog
3. Click on the dropdown next to the current default branch, in this example, main

1. Select the desired default branch, in this example, dev was selected

2. Click on the Update button

3. You will be presented with an are-you-sure question.

   • Click on the red I understand, update the default branch. button

Your default branch has been changed.

Update Branch¶

The dev branch of the nightscout/Trio repository will be updated frequently. This is how you know if your fork needs to be updated as well. As long as the automatic runs are happening weekly for your repository — you will not need these manual instructions, unless you want to manually build an update sooner.

Tap the Code button (upper left) and ensure this branch in your fork is up to date.

• Select the desired branch in the dropdown menu (this graphic shows main branch, to get 0.5 (or newer), you must choose dev branch)
• If the message indicates this branch is "behind", tap on the sync fork button and then the Update branch button

Update Identifiers¶

If identifiers are added to the dev or feature branch you are using, this will be required, otherwise you can skip this.

Refer to the graphic below for the numbered steps:

1. Click on the Actions tab of your Trio repository
2. On the left side, click on 2. Add Identifiers
3. On the right side, click Run Workflow to show a dropdown menu
   • You will see your default branch (typically this is main)
   • To update the Identifiers found in dev but not main, you must select dev

4. Tap the green button that says Run workflow.

   

The Add Identifiers Action  should succeed or fail in a few minutes. Do not continue to the next step until this one succeeds.

Enable Time Sensitive Notifications¶

Trio dev version 0.8.4.3 added the requirement for the Time Sensitive Notifications capability to be enabled for your Trio Identifier. If you already enabled it, you can skip this step.

• This is a one-time manual step in your Apple Developer account - the Add Identifiers action does not enable this capability for you
• If the capability is not enabled, the Build Trio action fails

Follow the directions at Enable Time Sensitive Notifications, then return to this page and continue with Build the App.

• You do not need to run any extra actions after checking the box - Build Trio includes the Create Certificates step, which updates your provisioning profile to include the new capability

Build the App¶

If you completed all the steps on this page successfully (got a green checkmark ✅), you are ready to run Action: Build Trio.

If you choose to build a different branch than your default branch, there is an extra step when you Build Trio. In addition to the normal steps 1, 2, and 3 in the graphic below, you must also do the (optional) step. Select the dev branch in the branch dropdown menu before continuing to step 4 and tapping on the green Run workflow button:

Refresh, Do Not Repeat¶

Update Build Errors¶

Read the build action annotations if you see an error.

Time Sensitive Notifications Error¶

If you did not Enable Time Sensitive Notifications for your Trio Identifier, the Build Trio action fails with an error similar to this:

error: Provisioning profile "match AppStore org.nightscout.***.trio" doesn't include the com.apple.developer.usernotifications.time-sensitive entitlement.

Solution: Enable Time Sensitive Notifications and then run Build Trio again - make sure you select the dev branch.

Identifiers Error¶

This example is from the past when Push Notifications were added to the dev branch.

Example Error¶

If you decide to look at the action log, instead of reading the annotations, you may see an error similar to the two graphics below.

Solution¶

1. Update Identifiers - make sure you select dev branch
2. Build the App - make sure you select dev branch