生成的 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 项目

前提条件#

创建项目#

项目生成#

模块缓存#

选择性测试#

包注册表#

构建洞察#

测试洞察#

带领团队一起使用#