Studio v0.1.1
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 打开

  1. 输出类型选择 完整 Xcode 工程。构建完成后打开输出目录。
  2. 保留整个 ios-project/,其中包括 GalCraftPlayer.xcodeproj、共享 Scheme、Swift 宿主、Info.plist,以及 GalCraftPlayer/Game/ 内的 Player、快照、模板、素材与字体许可。
  3. 将完整 ios-project/ 复制到 Mac,用 Xcode 打开 GalCraftPlayer.xcodeproj。
  4. 在 Xcode 的 Signing & Capabilities 选择作者团队,核对 Bundle Identifier、签名证书和 provisioning profile,再选择目标设备运行。
  5. 为分发创建归档,并在 Xcode Organizer 中使用 Distribute App 选择 TestFlight、App Store Connect 或适合的设备分发方式。具体条件见 Apple 分发指南。

工程也附带 build.sh,供在 macOS 按脚本说明调用 Xcode 工具链。

3. 在 macOS 从 Studio 归档

  1. 安装 Xcode 与所需 iOS 工具,完成 Xcode 初次启动配置,并让命令行使用该 Xcode。
  2. 在 Studio 选择“Xcode 归档 · 需要 macOS”,填写 Apple 开发团队 ID:10 位大写字母或数字的 Team ID,取自作者开发者账号。
  3. 确保本机 Xcode 已配置对应团队的签名身份与 provisioning profile。Studio 表单使用自动签名;通过公开构建器端口调用时,可选 signingProfileId 指定手动签名 profile,省略时采用自动签名。
  4. 选择输出目录,检查已保存版本,再确认构建。构建器调用 xcodebuild,使用 GalCraftPlayer Scheme、Release 配置和 generic/platform=iOS 生成 archive。
  5. 完成后从回执定位 artifacts/GalCraftPlayer.xcarchive。输出同时保留 ios-project/。
  6. 在 Xcode Organizer 打开归档,使用 Distribute App 继续签名配置、验证、导出或上传。设备与分发渠道的操作沿 Apple 官方流程完成。

如果当前系统提示需要 macOS,切回“完整 Xcode 工程”并按上节交接。归档失败时保留作品输入,修正 Xcode、团队或签名诊断后重新检查构建。

其他目标:Web · Windows · Android。