Create a generated project

The easiest way to get started with Tuist in any directory or in the directory of an existing project:

bash

misextuist@latest--tuistinit

bash

tuistinit

The command will walk you through the steps to create a generated project or integrate an existing Xcode project or workspace. It helps you connect your setup to the remote server, giving you access to features like selective testing, previews, and the registry.

Migrate An Existing Project

If you want to migrate an existing project to generated projects to improve the developer experience and take advantage of our cache, check out our migration guide.

Add dependencies#

It's common for projects to depend on third-party libraries to provide additional functionality. To do so, run the following command to have the best experience editing your project:

bash

tuistedit

An Xcode project will open containing your project files. Edit the Package.swift and add the

swift

// swift-tools-version: 5.9
importPackageDescription
#if TUIST
importProjectDescription
letpackageSettings=PackageSettings(
// Customize the product types for specific package product
// Default is .staticFramework
// productTypes: ["Alamofire": .framework,]
productTypes:[:]
)
#endif
letpackage=Package(
name:"MyApp",
dependencies:[
// Add your own dependencies here:
// .package(url: "https://github.com/Alamofire/Alamofire", from: "5.0.0"),
// You can read more about dependencies here: https://docs.tuist.io/documentation/tuist/dependencies
.package(url:"https://github.com/onevcat/Kingfisher",.upToNextMajor(from:"7.12.0"))// [!code ++]
]
)

Then edit the application target in your project to declare Kingfisher as a dependency:

swift

importProjectDescription
letproject=Project(
name:"MyApp",
targets:[
.target(
name:"MyApp",
destinations:.iOS,
product:.app,
bundleId:"dev.tuist.MyApp",
infoPlist:.extendingDefault(
with:[
"UILaunchStoryboardName":"LaunchScreen.storyboard",
]
),
buildableFolders:[
"MyApp/Sources",
"MyApp/Resources",
],
dependencies:[
.external(name:"Kingfisher")// [!code ++]
]
),
.target(
name:"MyAppTests",
destinations:.iOS,
product:.unitTests,
bundleId:"dev.tuist.MyAppTests",
infoPlist:.default,
sources:["MyApp/Tests/**"],
resources:[],
dependencies:[.target(name:"MyApp")]
),
]
)

Then run tuist install to resolve and pull the dependencies using the Swift Package Manager.

Spm As A Dependency Resolver

Tuist recommended approach to dependencies uses the Swift Package Manager (SPM) only to resolve dependencies. Tuist then converts them into Xcode projects and targets for maximum configurability and control.

Visualize the project#

You can visualize the project structure by running:

bash

tuistgraph

The command will output and open a graph.png file in the project's directory:

Project graph

Use the dependency#

Run tuist generate to open the project in Xcode, and make the following changes to the ContentView.swift file:

swift

importSwiftUI
importKingfisher// [!code ++]
publicstructContentView:View{
publicinit(){}
publicvarbody:someView{
Text("Hello, World!")// [!code --]
.padding()// [!code --]
KFImage(URL(string:"https://cloud.tuist.io/images/[email protected]")!)// [!code ++]
}
}
structContentView_Previews:PreviewProvider{
staticvarpreviews:someView{
ContentView()
}
}

Run the app from Xcode, and you should see the image loaded from the URL.