Usage Commands Cloud Contributors

Migrate Xcode projects

To help developers with the process of adopting Tuist, Tuist provides a set of commands under tuist migration.

Extract build settings into xcode build configuration files

It’s recommended to make .xcconfig files the source of truth for build settings. For that, Tuist provides a tuist migration settings-to-xcconfig command that extracts the build settings from targets and projects.

# Extract target build settings
tuist migration settings-to-xcconfig -p Project.xcodeproj -t MyApp -x MyApp.xcconfig
# Extract project build settings
tuist migration settings-to-xcconfig -p Project.xcodeproj -x MyAppProject.xcconfig
Copy the content

Arguments

ArgumentShortDescriptionValuesDefaultRequired

--xcodeproj-path

-p

Description:

Path to the Xcode project whose build settings will be extracted.

-p

Path to the Xcode project whose build settings will be extracted.

Yes

--xcconfig-path

-x

Description:

Path to the .xcconfig file into which the build settings will be extracted.

-x

Path to the .xcconfig file into which the build settings will be extracted.

Yes

--target

-t

Description:

The name of the target whose build settings will be extracted. When not passed, it extracts the build settings of the project.

-t

The name of the target whose build settings will be extracted. When not passed, it extracts the build settings of the project.

No

Ensure project and target build settings are empty

After making .xcconfig files the source of truth for build settings, it’s important to ensure that build settings are no longer set to the project. To help with that, Tuist includes a command that fails if the build settings of a project or a target are not empty:

tuist migration check-empty-settings -p Project.xcodeproj -t MyApp
Copy the content

Arguments

ArgumentShortDescriptionValuesDefaultRequired

--xcodeproj-path

-p

Description:

Path to the Xcode project whose build settings will be checked.

-p

Path to the Xcode project whose build settings will be checked.

Yes

--target

-t

Description:

The name of the target whose build settings will be checked. When not passed, it checks the build settings of the project.

-t

The name of the target whose build settings will be checked. When not passed, it checks the build settings of the project.

No

By using this website, you agree to our cookie policy.