SuperAPI AI 工具集

using-tuist-generated-projects

编程与开发

查看项目

更新于 10-16 07:12

技能介绍

用途

本技能用于指导在 Tuist 生成的 Xcode 工作区中进行日常工作,包括工作区生成、构建与测试命令,以及可构建文件夹(buildable folders)的使用。

快速开始

在不打开 Xcode 的情况下生成工作区:

tuist generate --no-open

使用 xcodebuild 构建某个 scheme:

xcodebuild build -workspace App.xcworkspace -scheme App

使用 xcodebuild 运行测试:

xcodebuild test -workspace App.xcworkspace -scheme AppTests -only-testing AppTests/MyTestCase

项目定义

优先使用可构建文件夹

使用 buildableFolders 而不是 sources 和 resources 通配符。可构建文件夹与文件系统保持同步,因此添加或删除文件无需重新生成。

let target = Target(
  name: "App",
  buildableFolders: [
    "App/Sources",
    "App/Resources",
  ]
)

为聚焦范围给目标打标签

使用 target 标签对项目区域进行分组,例如:

tag:team:*

tag:feature:*

tag:layer:*

这些标签便于后续限定生成和测试的范围。

带标签的目标元数据示例:

let target = Target(
  name: "PaymentsUI",
  metadata: .metadata(tags: [
    "tag:team:commerce",
    "tag:feature:payments",
    "tag:layer:ui",
  ])
)

在处理某个聚焦区域时,只生成所需内容:

tuist generate tag:feature:payments
tuist generate PaymentsUI PaymentsTests

对齐构建配置

保持项目与外部依赖之间的构建配置一致。使用 PackageSettings(settings: .settings(configurations: [])) 来镜像项目配置;不匹配时会发出警告。

工作流

有意识地生成

在自动化和脚本中使用 tuist generate --no-open,以避免启动 Xcode。

当任何清单(manifest)发生变化(或依赖图发生变化)时重新生成。

如果生成因缺少产物而失败,运行 tuist install 解析依赖后重试。

使用 xcodebuild 构建

针对生成的工作区和 scheme 使用 xcodebuild build。

xcodebuild build \
  -workspace App.xcworkspace \
  -scheme App \
  -destination "generic/platform=iOS Simulator"

使用 xcodebuild 测试

在本地运行测试时使用 xcodebuild test。优先使用它而不是 tuist test,因为 tuist test 每次调用都会重新生成项目,从而拖慢迭代速度。

优化测试运行时间:

  • 使用 --only-testing 只运行你正在处理的特定测试套件或测试用例,而不是整个目标。
  • 选择编译目标最少、但仍包含所需测试目标的 scheme。这能最小化测试运行前的构建时间。
# 运行特定测试套件
xcodebuild test \
  -workspace App.xcworkspace \
  -scheme AppTests \
  -only-testing AppTests/MyTestSuite

# 运行单个测试用例
xcodebuild test \
  -workspace App.xcworkspace \
  -scheme AppTests \
  -only-testing AppTests/MyTestSuite/testMyFunction

指南

  • 保持 buildableFolders 路径与目标的真实文件系统布局一致。
  • 避免在同一目标中让 buildableFolders 与 sources 或 resources 通配符重叠。
  • 在运行 tuist generate --no-open 后,需要时手动打开 Xcode。

故障排查

静态副作用警告:有意识地调整产品类型。对本地目标使用 Target.product,对外部产品使用 PackageSettings(productTypes:)。将所有内容都设为动态的 .framework 可以编译和运行,但可能损害启动时间。尽可能优先使用静态产品(静态框架或库),且在不引入副作用的情况下使用。

Objective-C 依赖崩溃:根据需要在消费目标上通过 OTHER_LDFLAGS 添加 -ObjC 或 -force_load。参考:https://docs.tuist.dev/en/guides/features/projects/dependencies#objectivec-dependencies。