編輯

與傳統 Xcode 專案或 Swift Packages 不同（後者透過 Xcode UI 進行變更），由 Tuist 管理的專案是定義在包含於 manifest 檔案 中的 Swift 程式碼。如果你熟悉 Swift Packages 和 Package.swift 檔案，做法非常相似。

你可以使用任何文字編輯器來編輯這些檔案，但我們建議使用 Tuist 提供的工作流程：tuist edit。此工作流程會建立一個包含所有 manifest 檔案的 Xcode 專案，讓你能夠編輯並編譯它們。借助 Xcode，你可以獲得 程式碼自動完成、語法標示和錯誤檢查 等所有優勢。

編輯專案#

要編輯你的專案，你可以在 Tuist 專案目錄或其子目錄中執行以下指令：

bash

tuist edit

該指令會在全域目錄中建立一個 Xcode 專案並在 Xcode 中開啟它。專案包含一個 Manifests 目錄，你可以建置它以確保所有 manifest 都有效。

Glob 解析的 Manifest

tuist edit 會使用從專案根目錄（即包含 Tuist.swift 檔案的目錄）開始的 glob **/{Manifest}.swift 來解析要包含的 manifest。請確保專案根目錄中存在有效的 Tuist.swift。

忽略 manifest 檔案#

如果你的專案在非實際 Tuist manifest 的子目錄中包含與 manifest 檔案同名的 Swift 檔案（例如 Project.swift），你可以在專案根目錄建立 .tuistignore 檔案，將它們從編輯專案中排除。

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

gitignore

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

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

這在你擁有測試 fixture 或範例程式碼，而它們恰好使用與 Tuist manifest 檔案相同的命名慣例時特別有用。

編輯與產生工作流程#

你可能已經注意到，無法從產生的 Xcode 專案進行編輯。這是刻意設計，以防止產生的專案對 Tuist 產生依賴，確保你將來可以輕鬆遷離 Tuist。

在迭代開發專案時，我們建議在一個終端機工作階段中執行 tuist edit 以取得用於編輯專案的 Xcode 專案，並在另一個終端機工作階段中執行 tuist generate。