Back to Tuist

編輯{#editing}

server/priv/docs/zh_Hant/guides/features/projects/editing.md

4.191.82.3 KB
Original Source

編輯{#editing}

與傳統的 Xcode 專案或 Swift Packages 不同,前者的變更是透過 Xcode 的 UI 來完成,而 Tuist 管理的專案則是以 Swift 程式碼來定義,包含在manifest 檔案 中。如果您熟悉 Swift Packages 和Package.swift 檔案,則方法非常相似。

您可以使用任何文字編輯器編輯這些檔案,但我們建議您使用 Tuist 提供的工作流程,tuist edit 。該工作流程會建立一個包含所有清單檔案的 Xcode 專案,並允許您編輯和編譯它們。由於使用 Xcode,您可以獲得代碼完成、語法高亮和錯誤檢查 的所有好處。

編輯專案{#edit-the-project}

要編輯專案,您可以在 Tuist 專案目錄或子目錄中執行下列指令:

bash
tuist edit

該指令會在全局目錄中建立一個 Xcode 專案,並在 Xcode 中開啟。該專案包含一個Manifests 目錄,您可以建立該目錄,以確保您所有的manifests都是有效的。

[!NOTE] Glob-resolved Manifests

tuist edit 使用專案根目錄(包含Tuist.swift 檔案的目錄)中的 glob**/{Manifest}.swift 解析要包含的清單。請確定專案根目錄中有一個有效的Tuist.swift

忽略清單檔案{#ignoring-manifest-files}

如果專案的子目錄中包含與清單檔案同名的 Swift 檔案 (例如Project.swift),而這些檔案並非實際的 Tuist 清單,您可以在專案根目錄建立.tuistignore 檔案,將這些檔案排除在編輯專案之外。

.tuistignore 檔案使用 glob 模式指定應該忽略哪些檔案:

gitignore
# Ignore all Project.swift files in the Sources directory
Sources/**/Project.swift

# Ignore specific subdirectories
Tests/Fixtures/**/Workspace.swift

當您的測試夾具或範例程式碼碰巧使用與 Tuist 清單檔案相同的命名慣例時,此功能尤其有用。

編輯和產生工作流程{#edit-and-generate-workflow}

您可能已經注意到,編輯工作無法在產生的 Xcode 專案中完成。這是為了防止生成的專案依賴於 Tuist 而設計的,以確保您將來可以輕鬆地從 Tuist 轉移到其他專案。

迭代專案時,建議從終端會話執行tuist edit ,取得 Xcode 專案來編輯專案,並使用另一個終端會話執行tuist generate