Studio v0.1.1 · 产品手册
导出 iOS 工程与 Xcode 归档
导出 iOS 工程与 Xcode 归档:GalCraft Studio 操作与参考。
在“发布”选择 iOS,再选择已安装的 iOS 0.1.0 构建器。Windows 和 Linux x64 可以导出完整工程;macOS x64/arm64 还可生成 Xcode 归档。先按发行总览应用配置、保存作品并检查目标素材。
1. 填写身份与输出
| 字段 | 填写方式 |
|---|---|
| Bundle ID(bundleId) | 如 com.example.springlights;与 Apple 中配置的应用身份一致,至少两段,每段以字母开头,使用字母、数字或连字符 |
| 构建序号(buildNumber) | 如 1、1.1 或 1.1.1,最多三段数字;新构建按分发渠道要求递增 |
| 屏幕方向 | 固定横屏或横屏随设备旋转,默认固定横屏 |
| 输出类型 | 完整 Xcode 工程,或“Xcode 归档 · 需要 macOS” |
当前工程最低 iOS 15.0;归档工具要求 Xcode 16 或更新版本。选择专用发行目录,检查已保存版本后确认构建。
2. 在 Windows 导出,再到 Mac 打开
- 输出类型选择 完整 Xcode 工程。构建完成后打开输出目录。
- 保留整个
ios-project/,其中包括GalCraftPlayer.xcodeproj、共享 Scheme、Swift 宿主、Info.plist,以及GalCraftPlayer/Game/内的 Player、快照、模板、素材与字体许可。 - 将完整
ios-project/复制到 Mac,用 Xcode 打开GalCraftPlayer.xcodeproj。 - 在 Xcode 的 Signing & Capabilities 选择作者团队,核对 Bundle Identifier、签名证书和 provisioning profile,再选择目标设备运行。
- 为分发创建归档,并在 Xcode Organizer 中使用 Distribute App 选择 TestFlight、App Store Connect 或适合的设备分发方式。具体条件见 Apple 分发指南。
工程也附带 build.sh,供在 macOS 按脚本说明调用 Xcode 工具链。
3. 在 macOS 从 Studio 归档
- 安装 Xcode 与所需 iOS 工具,完成 Xcode 初次启动配置,并让命令行使用该 Xcode。
- 在 Studio 选择“Xcode 归档 · 需要 macOS”,填写 Apple 开发团队 ID:10 位大写字母或数字的 Team ID,取自作者开发者账号。
- 确保本机 Xcode 已配置对应团队的签名身份与 provisioning profile。Studio 表单使用自动签名;通过公开构建器端口调用时,可选
signingProfileId指定手动签名 profile,省略时采用自动签名。 - 选择输出目录,检查已保存版本,再确认构建。构建器调用
xcodebuild,使用 GalCraftPlayer Scheme、Release 配置和 generic/platform=iOS 生成 archive。 - 完成后从回执定位
artifacts/GalCraftPlayer.xcarchive。输出同时保留ios-project/。 - 在 Xcode Organizer 打开归档,使用 Distribute App 继续签名配置、验证、导出或上传。设备与分发渠道的操作沿 Apple 官方流程完成。
如果当前系统提示需要 macOS,切回“完整 Xcode 工程”并按上节交接。归档失败时保留作品输入,修正 Xcode、团队或签名诊断后重新检查构建。