遷移 XcodeGen 專案

XcodeGen 係一個專案生成工具，使用 YAML 作為設定格式嚟定義 Xcode 專案。好多機構 採用佢，希望避開處理 Xcode 專案時經常出現嘅 Git 衝突。 不過，頻繁嘅 Git 衝突只係機構面對嘅眾多問題之一。Xcode 令開發者要面對好多複雜細節同隱含設定，難以大規模維護同優化專案。由於 XcodeGen 設計上只係生成 Xcode 專案嘅工具，並唔係專案管理器，所以喺呢方面有所不足。如果你需要一個除咗生成 Xcode 專案之外仲可以幫到你嘅工具，不妨考慮 Tuist。

Swift 勝於 YAML

好多機構都偏好將 Tuist 作為專案生成工具，因為佢使用 Swift 作為設定格式。Swift 係開發者熟悉嘅程式語言，亦提供使用 Xcode 自動完成、類型檢查同驗證功能嘅便利。

以下係一啲注意事項同指引，幫你將專案由 XcodeGen 遷移到 Tuist。

專案生成#

Tuist 同 XcodeGen 都提供 generate 指令，將你嘅專案宣告轉換成 Xcode 專案同工作區。

bash

xcodegen generate

bash

tuist generate

分別在於編輯體驗。使用 Tuist，你可以執行 tuist edit 指令，即時生成一個 Xcode 專案，你可以打開並開始工作。當你需要對專案作出快速更改時，這特別有用。

`project.yaml`#

XcodeGen 嘅 project.yaml 描述檔案會變成 Project.swift。此外，你可以使用 Workspace.swift 嚟自訂專案點樣分組到工作區入面。你亦可以有一個專案 Project.swift，其中包含參考其他專案目標嘅目標。喺呢啲情況下，Tuist 會生成一個包含所有專案嘅 Xcode Workspace。

bash

/
  project.yaml

bash

/
  Tuist.swift
  Project.swift
  Workspace.swift

Xcode 嘅語言

XcodeGen 同 Tuist 都擁抱 Xcode 嘅語言同概念。不過，Tuist 基於 Swift 嘅設定為你提供使用 Xcode 自動完成、類型檢查同驗證功能嘅便利。

規格範本#

YAML 作為專案設定語言嘅缺點之一，係佢預設唔支援跨 YAML 檔案嘅重用性。喺描述專案時，這是一個常見需求，而 XcodeGen 必須透過佢哋自己專有嘅解決方案（名為 「範本」）嚟解決。Tuist 嘅重用性直接內建於語言本身（Swift），並透過名為 project description helpers 嘅 Swift 模組實現，讓你可以喺所有 manifest 檔案之間重用代碼。

::: code-group

swift

import ProjectDescription

extension Target {
  /**
    This function is a factory of targets that together represent a feature.
  */
  static func featureTargets(name: String) -> [Target] {
    // ...
  }
}

swift

import ProjectDescription
import ProjectDescriptionHelpers // [!code highlight]

let project = Project(name: "MyProject",
                      targets: Target.featureTargets(name: "MyFeature")) // [!code highlight]

遷移 XcodeGen 專案

專案生成#

project.yaml#

規格範本#

`project.yaml`#