生成的 Xcode 項目

plaintext

Help me get started with Tuist. Follow the setup at:
https://tuist.dev/en/docs/guides/get-started/generated-xcode-project

當你希望 Tuist 根據 Swift 清單描述並生成你的 Xcode 項目時，請遵循此路徑。生成的項目將模組化 Xcode 項目的複雜性壓縮為對圖形的簡潔、宣告式描述。這也是模組快取和選擇性測試的嚴格要求。

以下每個部分都先說明目前缺少的內容，然後引導你了解填補該空白的功能。

先決條件#

已安裝 Xcode 的 macOS。
Tuist 命令列介面。

建立項目#

檢視其運作最快的方式是從全新項目開始。在空白目錄中，執行 tuist init 並選擇 建立生成的項目，選擇平台，確認名稱，然後進行身份驗證並選擇應擁有該項目的帳戶。

bash

mkdir MyApp && cd MyApp
tuist init

如果你是透過編碼代理程式或腳本驅動此流程，請先執行 tuist auth login（瀏覽器流程會等待你按下 Enter），然後使用非互動式形式：

bash

tuist init --build-system generated-xcode --name MyApp --platform ios --account <account>

當 init 完成後，執行 tuist generate。Tuist 會在你的清單旁邊寫入一個 .xcworkspace 並在 Xcode 中開啟它。建置並執行目標。你應該會看到範例應用程式在模擬器中啟動。

這就是「已連接 + 生成」狀態。以下所有内容均為可選且獨立。

如果你要遷移現有應用程式，請先依照 Xcode 項目遷移指南進行連接，然後返回並繼續處理適合你問題的部分。

項目生成#

.xcodeproj 將你的應用程式結構打包成 XML：檔案參考、建置階段、目標依賴關係、方案以及建置設定都位於同一棵樹中，沒有用於將圖形作為圖形進行推理的原語。隨著項目增長，這種結構更難以在腦海中掌握，而且 Xcode 沒有穩定的控制代碼供工具對其進行雜湊並在沒有任何變更時跳過工作。

生成的項目將圖形壓縮為宣告式 Swift。Project.swift 直接描述目標、依賴關係和資源，而 Tuist 在其背後維護圖形的穩定模型。該模型正是解鎖以下部分的關鍵：模組快取對其進行雜湊以重用二進位檔案，而選擇性測試對其進行雜湊以跳過輸入未變更的測試。

swift

import ProjectDescription

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

每次 tuist generate 都會從清單產生確定性的工作區。將 .xcodeproj 和 .xcworkspace 加入 .gitignore。

模組快取#

從頭開始編譯模組化 Xcode 項目是一種每台機器的成本。每位隊友和每個 CI 執行器都會產生相同物件檔案的自己的副本。Xcode 編譯快取縮短了內部循環，但並未消除每個目標的每台機器建置，也無法用預建二進位檔案替換整個框架。

模組快取可以做到這一點。它會建置圖形中每個可快取的依賴項一次（框架、程式庫、套件），將產生的二進位檔案根據目標輸入的雜湊值儲存，並在後續生成中用其二進位檔案替換目標。未變更的模組將停止編譯：

bash

tuist cache

第一次執行會編譯所有內容並將二進位檔案上傳到你的帳戶。在下一次 tuist generate 時，未變更的依賴項會被其快取的二進位檔案替換，Xcode 會連結到 .xcframework 而不是從原始碼編譯。

選擇性測試#

xcodebuild test 不知道變更會影響哪些測試，因此 CI 會在每次推送時執行整個套件。隨著套件增長，實際需要執行的內容與實際執行的內容之間的差距從幾分鐘延長到幾十分鐘。

選擇性測試僅運行自上次成功測試執行以來受變更影響的測試，使用項目圖形和模組快取所依賴的相同雜湊演算法：

bash

tuist test

第一次 tuist test 會執行所有內容並持久保存每個目標的雜湊值。後續執行會跳過輸入未變更的目標。將 tuist test 移至 CI 中以取代 xcodebuild test，回饋將在幾秒鐘內到達，而不是幾分鐘。

套件套件註冊表#

Swift Package Manager 透過深度克隆每個套件的 git 歷史記錄來解析依賴項，因為套件是通過 URL 而非註冊表尋址的。在具有數十個傳遞套件的項目上，解析在乾淨簽出時會耗時數分鐘，並在每個 CI 作業中重複。

Tuist Package Registry 提供與 Swift Package Index 追蹤相同的套件，但作為真正的註冊表，因此 SwiftPM 僅獲取你實際需要的提交。透過在 Tuist.swift 中設定 registryEnabled: true 一次性啟用它：

swift

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

重新生成。套件解析時間從幾分鐘降至幾秒鐘。

生成的 Xcode 項目

先決條件#

建立項目#

項目生成#

模組快取#

選擇性測試#

套件套件註冊表#

建置洞察#

測試洞察#

讓團隊參與其中#