建立新專案

使用 Tuist 啟動新專案最直接的方式是執行 tuist init 指令。此指令會啟動互動式 CLI，引導你完成專案設定。出現提示時，請務必選擇建立「generated project」的選項。

接著你可以編輯專案，執行 tuist edit 後，Xcode 會開啟一個讓你編輯專案的專案。其中一個產生的檔案是 Project.swift，它包含你的專案定義。如果你熟悉 Swift Package Manager，可以把它想成是 Package.swift，但採用 Xcode 專案的語彙。

swift

import ProjectDescription

let project = Project(
    name: "MyApp",
    targets: [
        .target(
            name: "MyApp",
            destinations: .iOS,
            product: .app,
            bundleId: "dev.tuist.MyApp",
            infoPlist: .extendingDefault(
                with: [
                    "UILaunchScreen": [
                        "UIColorName": "",
                        "UIImageName": "",
                    ],
                ]
            ),
            sources: ["MyApp/Sources/**"],
            resources: ["MyApp/Resources/**"],
            dependencies: []
        ),
        .target(
            name: "MyAppTests",
            destinations: .iOS,
            product: .unitTests,
            bundleId: "dev.tuist.MyAppTests",
            infoPlist: .default,
            sources: ["MyApp/Tests/**"],
            resources: [],
            dependencies: [.target(name: "MyApp")]
        ),
    ]
)

Note

我們刻意將可用範本清單保持簡短，以降低維護負擔。如果你想建立的專案不是應用程式（例如 framework），可以使用 tuist init 作為起點，然後修改產生的專案以符合你的需求。

手動建立專案#

或者，你也可以手動建立專案。我們建議僅在你已熟悉 Tuist 及其概念時才這麼做。你需要做的第一件事是為專案結構建立額外的目錄：

bash

mkdir MyFramework
cd MyFramework

接著建立 Tuist.swift 檔案，它會設定 Tuist，並供 Tuist 用來判斷專案的根目錄；同時建立 Project.swift，用於宣告你的專案：

swift

import ProjectDescription

let project = Project(
    name: "MyFramework",
    targets: [
        .target(
            name: "MyFramework",
            destinations: .macOS,
            product: .framework,
            bundleId: "dev.tuist.MyFramework",
            sources: ["MyFramework/Sources/**"],
            dependencies: []
        )
    ]
)

swift

import ProjectDescription

let tuist = Tuist()

Warning

Tuist 使用 Tuist/ 目錄來判斷專案的根目錄，並從該處透過 glob 搜尋其他 manifest 檔案。我們建議使用你慣用的編輯器建立這些檔案，之後即可使用 tuist edit 在 Xcode 中編輯專案。