Unity 打包 iOS，Xcode 构建并上传 App Store

原创于 2025-08-28 10:52:32 发布 · 455 阅读

13 ·

CC 4.0 BY-SA版权

文章标签：

#Unity #ios #xcode

Unity 同时被 2 个专栏收录

56 篇文章

订阅专栏

IOS/Xcode

3 篇文章

订阅专栏

一、准备工作（环境、账号、证书与项目基础）

系统与工具
- macOS：使用与最新 Xcode 兼容的版本。
- Xcode：从 Mac App Store 安装最新稳定版（建议与当前 App Store 必需的 Xcode 主版本保持一致）。
- Unity：使用一个长期支持或稳定版本；安装 iOS Build Support（含 IL2CPP 与 Mac Build Support）。
- CocoaPods：若项目或三方 SDK 使用 Pod，安装 pod 工具：sudo gem install cocoapods
- 命令行工具：Xcode 安装后运行 xcode-select --switch /Applications/Xcode.app
Apple 开发者账号
- 申请与开通：加入 Apple Developer Program（个人或公司）。
- 角色分配：确保有 App Manager、Developer、Access to Certificates 等权限，便于创建 App、证书与上传构建。
证书、App ID、Provisioning Profile
- App ID（Bundle ID）：在开发者后台创建，如 com.company.game，开启所需 Capabilities（如 Push、Game Center、IAP、Sign in with Apple 等）。
- 证书类型：
  - iOS Development（开发调试）
  - iOS Distribution / App Store（商店分发）
- 描述文件（Provisioning Profiles）：
  - Development（开发真机调试，需设备 UDID）
  - App Store（上架分发，不需要绑定设备）
  - Ad Hoc（线下分发，需设备 UDID；可选）
- 注意：做 TestFlight 不需要收集测试机 UDID；Ad Hoc 才需要。
素材与合规准备
- App 图标与启动屏：iOS 要求使用 Launch Screen Storyboard（禁止旧式静态 Launch Images）。Unity 可配置“Custom iOS Target Launch Screen”或自定义 Storyboard。
- 隐私与合规：
  - 隐私权限文案：在 Info.plist 填写各权限用途说明，如 NSCameraUsageDescription、NSMicrophoneUsageDescription、NSUserTrackingUsageDescription（若使用 IDFA/广告）。
  - 数据类型与用途：App Store Connect“隐私营养标签”填写。
  - 加密合规：如使用或链接到加密，需在提交时填写出口合规问答。
- 截图与预览：准备 6.7" iPhone、5.5" iPhone、iPad（如支持）的截图与可选预览视频。

二、Unity 工程配置（iOS + IL2CPP）

切换平台
- File -> Build Settings -> iOS -> Switch Platform
- Scenes In Build：勾选你的首场景在列表顶部
Player Settings 关键项
- Identification
  - Company Name/Product Name：作为包信息来源
  - Bundle Identifier：与开发者后台 App ID 一致
  - Version（CFBundleShortVersionString，如 1.0.0）
  - Build（CFBundleVersion，整数自增，如 1、2、3…）
  - Signing Team ID：填你的团队 ID（可启用 Unity 自动签名）
- Resolution and Presentation
  - Default Orientation：根据游戏设定（竖屏/横屏）
  - Status Bar：一般隐藏
  - Launch Screen：推荐使用自定义 Storyboard（符合 Apple 要求）
- Other Settings
  - Scripting Backend：IL2CPP（iOS 必须）
  - Api Compatibility Level：.NET Standard 2.1 或兼容你项目的最低要求
  - Target minimum iOS Version：根据你的受众与 SDK 要求（常见 12.0+ 或 13.0+）
  - Architecture：ARM64（App Store 仅支持 64 位）
  - Metal：仅启用 Metal（OpenGL ES 已不再推荐）
  - Allow ‘HTTP’ downloads：如需非 HTTPS，配置 ATS（更推荐服务端改为 HTTPS）
  - Script Call Optimization：Fast but no Exceptions（性能优先）；若依赖异常栈，使用 Slow and Safe
  - Managed Stripping Level：Medium/High 以减小包体，但注意反射类保留（可用 link.xml）
  - Objective-C/C++ Exceptions：如第三方 SDK 需要，可启用 C++ Exceptions
  - Bitcode：Xcode 14 起已移除，无需配置
- Optimization
  - Strip Engine Code：开启以减小体积（注意兼容）
  - IL2CPP Code Generation：Faster（发布）或 Faster Runtime（调试）
构建导出
- Build Settings：选择 “Build”（建议不要直接 Build and Run）
- 输出为 Xcode 工程目录
- 如用到 Pods，Unity 会生成 Podfile；首次用 Xcode 运行前执行 pod install 生成 .xcworkspace

三、使用 IL2CPP 构建与 Xcode 编译

CocoaPods（如有）
- 在 Xcode 工程目录执行：pod install
- 之后请使用 Unity-iPhone.xcworkspace 打开工程（而非 .xcodeproj）
Xcode 签名与能力
- Signing & Capabilities
  - 勾选 Automatically manage signing（推荐）并选择 Team
  - Bundle Identifier 要与 Profile 的 App ID 匹配
  - 添加所需 Capabilities（Push、IAP、Game Center 等）
- Build Settings
  - Provisioning Profile / Code Signing：自动签名时通常无需手配
  - Build Configuration：Release 用于提交
- 运行一次 Archive 前，先在模拟器或真机“Build”验证无编译错误

四、命令行打包（xcodebuild）

清理与归档（不使用 Pods 的工程）
- xcodebuild clean archive -project Unity-iPhone.xcodeproj -scheme Unity-iPhone -configuration Release -destination 'generic/platform=iOS' -archivePath build/Unity-iPhone.xcarchive
清理与归档（使用 Pods 的工程，注意 workspace）
- xcodebuild clean archive -workspace Unity-iPhone.xcworkspace -scheme Unity-iPhone -configuration Release -destination 'generic/platform=iOS' -archivePath build/Unity-iPhone.xcarchive
导出 IPA（需要 exportOptions.plist）
- 示例：App Store 导出 exportOptions.plist
  - {
    "method": "app-store",
    "uploadSymbols": true,
    "compileBitcode": false,
    "destination": "export",
    "signingStyle": "automatic",
    "stripSwiftSymbols": true
    }
- 执行导出
  - xcodebuild -exportArchive -archivePath build/Unity-iPhone.xcarchive -exportPath build/ipa -exportOptionsPlist exportOptions.plist
- 完成后在 build/ipa 下获得 .ipa 文件
进阶：显式指定签名（如需）
- 在 archive 命令后追加：
  - DEVELOPMENT_TEAM=你的TeamID CODE_SIGN_STYLE=Automatic
- 若使用手动签名，设置 PROVISIONING_PROFILE_SPECIFIER、CODE_SIGN_IDENTITY 等

五、上传到 App Store Connect

方式 A：Xcode Organizer（最稳妥）
- Xcode -> Product -> Archive -> Distribute App -> App Store Connect -> Upload
- 完成后在 App Store Connect 的 “TestFlight” 或 “App Store” 可看到构建
方式 B：Transporter（GUI）
- 从 Mac App Store 安装 Transporter，用 Apple ID 登录，拖拽 .ipa 上传
方式 C：CI/自动化（可选）
- 可用 fastlane deliver/pilot 实现一键上传（团队内可再落地）

六、TestFlight 测试