SuperAPI AI 工具集

migrating-to-tuist-generated-projects

通用与其它

查看项目

更新于 10-15 19:48

技能介绍

用途:把现有 Xcode 项目迁移为 Tuist 生成的工作区,并在迁移后验证构建与运行。

主要能力:先对原项目做基线构建与运行,盘点 target、构建设置和外部依赖;创建 Tuist.swift、Project.swift 与 Tuist/Package.swift;把设置抽取到 .xcconfig 并接入 Project.swift;生成并构建,修复问题后重新生成,最后在模拟器上验证运行。输出包括清单文件、可选的 .xcconfig、构建与运行验证记录,以及迁移决策与修复日志。

使用方式:先基线构建,例如 xcodebuild build -project App.xcodeproj -scheme App -configuration Debug -destination "generic/platform=iOS Simulator" -derivedDataPath DerivedDataBaseline;再生成并构建:tuist install、tuist generate --no-open,然后 xcodebuild build -workspace App.xcworkspace -scheme App -configuration Debug -destination "generic/platform=iOS Simulator" -derivedDataPath DerivedDataTuist;运行验证用 xcrun simctl boot、install、launch。

适用场景:需要把 Xcode 工程迁移到 Tuist 生成工作区,并保持部署目标、bundle id、设置与依赖一致的项目。

限制与注意:资料未提供具体版本要求、收费或平台限制。常见失败包括类型找不到、资源被误当资源处理、本地化冲突、未定义符号、启动时 unrecognized selector 或崩溃;需按资料中的修复方向处理,如补 SDK framework、检查 .process("Resources")、避免过度排除目录、修正 bundle id、确保代码生成产物参与构建,必要时加 -ObjC 或 -force_load。