编辑

与传统的 Xcode 项目或 Swift Package 不同（后者通过 Xcode 的 UI 进行更改），由 Tuist 管理的项目是在包含于 清单文件 中的 Swift 代码中定义的。如果你熟悉 Swift Package 和 Package.swift 文件，那么这种方法非常相似。

你可以使用任何文本编辑器来编辑这些文件，但我们建议使用 Tuist 提供的工作流：tuist edit。该工作流会创建一个包含所有清单文件的 Xcode 项目，并允许你编辑和编译它们。借助 Xcode，你将获得 代码补全、语法高亮和错误检查 等全部优势。

编辑项目#

要编辑你的项目，你可以在 Tuist 项目目录或其子目录中运行以下命令：

bash

tuist edit

该命令会在全局目录中创建一个 Xcode 项目并在 Xcode 中打开它。该项目包含一个 Manifests 目录，你可以构建它以确保所有清单都有效。

通过通配符解析的清单

tuist edit 会使用从项目根目录（即包含 Tuist.swift 文件的目录）开始的通配符 **/{Manifest}.swift 来解析要包含的清单。请确保项目根目录下存在有效的 Tuist.swift。

忽略清单文件#

如果你的项目在并非实际 Tuist 清单的子目录中包含与清单文件同名的 Swift 文件（例如 Project.swift），你可以在项目根目录下创建 .tuistignore 文件，将它们从编辑项目中排除。

.tuistignore 文件使用通配符模式来指定应忽略哪些文件：

gitignore

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

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

当你拥有恰好使用与 Tuist 清单文件相同命名约定的测试夹具或示例代码时，这尤其有用。

编辑与生成工作流#

你可能已经注意到，无法从生成的 Xcode 项目进行编辑。这是有意为之的设计，目的是防止生成的项目对 Tuist 产生依赖，从而确保你将来可以轻松地从 Tuist 迁移。

在迭代开发项目时，我们建议在一个终端会话中运行 tuist edit 以获取用于编辑项目的 Xcode 项目，并使用另一个终端会话运行 tuist generate。