Upgrading Tuist Version

4 months ago, I migrated all my apps to use Tuist.
Since then, I haven’t made any changes.

However I want to update to the latest Tuist and explorer what’s new.

Installing the Latest Tuist

I originally installed Tuist using mise, so I first tried simple comannds.

However neither

mise upgrade tuist

or

mise x -- tuist update

worked.

Instead I installed latest Tuist using:

mise install tuist@latest

Evenn after installation, My project was still using the old Tuist version.

To swift to the new version, I ran:

mise use tuist

Now my project is leveraging new Tuist 4.43.1.

I confirmed the installed versions with:

mise list tuist

Uninstalling the old version

Even though the comman showed that the old version was no longer in use, I could still switch to it using.

mise use tuist@4.22.0

Since I couldn’t find a way to list all installed versions,

I simply removed it with.

mise uninstall tuist@4.22.0

After that, I switched back to the latest version.

mise use tuist

I also noticed .mise.toml was updated accordingly.

[tools]
tuist = "latest"

Migration

Tuist.swift

After upgrading Tuist, I started seeig a waring whenever runnig Tuist commands.

The Tuist folder contained Config.swift, which is now deprecated.

So, I moved and renamed it to follolw the new structure.

Config

Eve after renaming the file, Xcode still showed the deprecation warning.

deprecated: Use the new .init(project: .tuist(…))

I checked the official documentation and applied it,

import ProjectDescription

let tuist = Tuist(
    project: .tuist(generationOptions: .options(enforceExplicitDependencies: true))
)

but the warning did not disappear.

Following the warning, I replace .tuist in Tuist.swift.

I only kept the Xcode compatibility setting and commented out the rest.

let tuist = Tuist(
    project: .tuist(compatibleXcodeVersions: .upToNextMajor("16.0")
//                    ...
    )
)

Since compatibleXcodeVersions was set to less than 15, I could’t generate the project with 16.2.

The selected Xcode version is 16.2, which is not compatible with this project’s Xcode version

Now, everything works fine, and there are no more warnings 🎉.

If you found this post helpful, please give it a round of applause 👏. Explore more Tuist-related content in my other posts.

For additional insights and updates, check out my LinkedIn profile. Thank you for your support!

References

Manifests · Projects · Develop · Guides · Tuist