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¶

The easiest way to update Trio is to download a fresh copy.

Once you completed the Prepare to Update steps listed above, head over to Build with Mac and follow the directions.

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 BuildSelectScript 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 to 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