Update Trio with Xcode

Overview¶

Prepare to Update¶

Under ordinary circumstances, you only have to update Trio once it expires (1 year for a paid account). However, we encourage regular updates when new versions are released because they often contain bug fixes or improvements, which may increase operational stability.

iOS Updates¶

Before updating Trio, it is important to check for any iOS updates. It's good practice to keep your other devices updated wherever possible. If updates are available, check their compatibility with Trio before updating.

macOS and Xcode Version¶

The table below lists the minimum requirements to build the current release of Trio.
First, you need to know your iOS version, macOS version, and Xcode version.
Next, find your iOS version in the table below, and review the correlating minimum macOS and Xcode versions.
If required, update your macOS and Xcode.

Apple Developer - Check for updated agreements¶

Apple frequently updates its License Agreement for the Developer Program. You need to log in to your developer account to manually check if there is a new agreement to accept. If you see a big red or orange banner atop your Developer Account announcing a new license agreement, like shown below, please read and accept it before building Trio.

Update Trio with Xcode¶

Open Terminal¶

1. On your Mac computer, go to the 'Finder' app.

2. Next, select' Applications' in the navigation pane on the left of the screen.

3. In the 'Applications' folder, scroll to locate and open the 'Utilities' folder.

4. Scroll to and open the 'Terminal' application.

Run the 'Build Select Script' in 'Terminal'¶

The Build Select Script is designed to walk you through downloading Trio. Please take some to carefully read each step.

1. Copy the below script by hovering the mouse near the bottom right side of the text and clicking the copy icon.

     /bin/bash -c "$(curl -fsSL \
       https://raw.githubusercontent.com/loopandlearn/lnl-scripts/main/TrioBuildSelectScript.sh)"
   

2. Paste the 'Build Select Script' into Terminal. Press return to run the script.

3. Running the script will display a series of menu options in the 'Terminal' window as shown below. To build Trio, you will type 1, and the press return.

   

4. Next, the script will inform you that you are downloading open-source software. If you understand the warning, you will Type 1 and press return.

   

5. Next, the script will prompt you to select which Trio branch you want to download. Unless you are actively contributing to app development, you will type 1 and press return.

   

6. Next, the script will begin downloading the Trio source code. Depending on your download speed, this can take 3 minutes to 30 minutes. While this happens, you may read words in the Terminal window that you do not understand. That is normal. If the download takes a while, you can leave the room and return later to check progress.

7. Once successfully downloaded, your terminal window will appear as below.

   

8. If you receive a failure message, scroll up through the window to find the error message(s). For assistance, visit Xcode Errors with Build Select.

9. You can hit return to continue if you did not receive errors.

10. If you have previously built with the build script, you will be asked to confirm that your Team ID is correct. If it is, you can type 1 and press return.

    

11. The next question asks if you want to ensure a year with your new build. Unless you have a specific reason, type 1 and press return.

    

12. In the next Terminal window, you will be prompted to do the following:

    • Unlock your phone.
    • If you have an Apple Watch, ensure it is unlocked and on your wrist.
    • Plug your phone into the computer.
    • Press return to continue.

    

Build Trio¶

1. Next, the script will open the Xcode application. When Xcode first opens, it takes some time for the project and its associated packages to load. You might see a progress wheel with the words 'downloading', 'copying', or 'indexing'.

2. Next, we will set our build destination (a.k.a. your device). At the top of the screen, there is a progress/information bar. To the left of the bar, you will see 'Trio' and the logo. Next to this is your build location. Click this and select the device you would like to build to.

   

3. We will now build to the location we selected. You can now select the run button.

   

4. Once you press the run button, you can monitor progress in the information bar.

5. Once the build is complete, a transient message will appear on the window saying, "Build Succeeded." Trio will launch on your phone or build device. You can unplug the device from the computer. When you unplug the device, a message will pop up in Xcode noting the lost connection. Acknowledge this message. Once unplugged, the Trio app will close on the phone, and users must re-open the application.

Build Errors¶

Successful Update¶

Additionals¶

New Trio users do not need to read the rest of this page.

Frequent Builders¶

If you build frequently, you do not have to delete the profiles every time. When the build script asks if you want to "Ensure a Year?", you can skip that step.

On the other hand, you may need to delete the provisioning profiles or saved Xcode information about a version of currently on your computer. The maintenance utilities found in the BuildSelectScrip can be run to delete your provisioning profiles or clear derived data. Or you can use the individual commands in the next sections to do the same thing.

Delete Provisioning Profiles¶

You can delete your provisioning profiles by copying this command and pasting it into any terminal. This does not affect any build you currently have on your phone - this just forces your current computer to generate a new one next time you build with Xcode.

• For those using Xcode 16 or newer:

rm ~/Library/Developer/Xcode/UserData/Provisioning\ Profiles/*.mobileprovision

• For those using Xcode 15 or older:

rm ~/Library/MobileDevice/Provisioning\ Profiles/*.mobileprovision

Delete Derived Data¶

If you build using the same clone on your computer and then update that clone, sometimes you want to remove derived information that Xcode remembers and force it to start fresh.

First quit out of Xcode. The following command will delete all derived information for all your clones, so next time you build any app from an existing clone on your computer, the build will take longer. All dependencies will download again. So wait until you see the "indexing" indication on Xcode before trying to build.

rm -rf ~/Library/Developer/Xcode/DerivedData

Revoke Certificate Issue¶

What does it look like if you run into the Revoke Certificate message? When you prepare to Sign the Targets with Xcode, you'll see the message highlighted in the figure below.

More information is shown in the orange box below.

Direct Download of Xcode¶

Many people find updating Xcode from the App Store to be incredibly slow - especially when a new version has just been released. This method still takes time and enough space on your disk but is faster than going through the App Store. Depending on your internet speed, this download can be done in about an hour. Then once it is downloaded, expect another fifteen minutes to several hours (depending on the speed of your computer) for the "xip" file to "expand".

The instructions do not hold your hand.

• Your macOS must be at the minimum version (or newer) to support the version of Xcode you're about the download
• You need to know how to log into your Apple Developer account and navigate those menus
• You need to know how to use Finder to navigate to Downloads
• You need to know how to drag the Xcode icon into your Applications folder (after download and expand completes)
• After you have done a direct download, the App Store will not show you updates
  • Either repeat the Direct Download or
  • Delete Xcode from Applications folder
    • Open the App Store and search for Xcode
    • Install fresh
    • After you use the App Store for a download, then Updates will show in the future

Here are the different steps you need to follow when doing the Direct Download instead of the App Store method:

1. Open the Apple Developer Download page
   • You may need to login
   • Examine the menus (on my computer there are buttons across the top)
   • Click on Applications
   • Look at the available applications, which should include one or more Xcode version
   • Scroll down until you find the item you want (for example, Xcode 15.4 or Xcode 16)
   • Click on View Details and click on the Download button for the "xip" file
2. Wait for Download to complete
3. Expand the file by clicking on it in Finder
4. Move the Xcode icon to Applications after the expansion completes
5. Check the Command Line Tools setting under Xcode->Settings
   • The selection cannot be blank or Build-Script will fail to open Xcode automatically
   • It should be the same version as your Xcode
6. Reboot the computer