建立新專案

使用 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/ 目錄來確定你專案嘅根目錄，並從那裡透過 globbing 搜尋其他 manifest 檔案。我哋建議用你鍾意嘅編輯器建立呢啲檔案，之後就可以用 tuist edit 透過 Xcode 編輯專案。