跨平台开发 / 系统课时
完成 iOS Archive 构建
完成 iOS Archive 构建
本篇解决 Flutter 应用生成 iOS 发布归档包的问题,理解证书、Provisioning Profile 与 Archive 之间的关系,并完成从工程配置到可发布构建产物的验证流程。
学习目标
- 理解 iOS Archive 构建中的签名链路
- 掌握 Flutter 项目生成 iOS Archive 的基本方式
- 能够定位常见证书和 Provisioning Profile 构建问题
理解 iOS Archive 发布链路
iOS 发布包不是简单的编译结果,而是一组经过签名验证的构建产物。Flutter 项目最终会通过 Xcode 完成 Archive,生成 .xcarchive 文件,再根据发布目标导出 IPA。
核心关系如下:

Bundle Identifier 决定应用身份,Certificate 提供签名能力,Provisioning Profile 将应用标识、团队和设备或发布环境绑定起来。
准备 Archive 构建环境
执行 Archive 前,需要确保 Flutter 工程已经可以正常构建 iOS Release:
flutter build ios --release预期结果
Xcode Release 构建流程完成
生成 iOS Release 构建产物如果 Release 构建失败,应先解决 Flutter 或 Xcode 编译问题,再进入 Archive 阶段。
使用 Xcode 创建 Archive
打开工作区:
open ios/Runner.xcworkspace预期输出
Xcode 打开 Runner.xcworkspace在 Xcode 中选择 Runner Target,确认签名配置后执行:
- 选择 Generic iOS Device 作为运行目标。
- 打开 Product 菜单。
- 选择 Archive。
- 等待 Organizer 窗口显示生成的归档。
Archive 成功后,会得到 .xcarchive 文件,可以继续用于导出 IPA 或上传 App Store Connect。
检查签名资源匹配
Archive 失败最常见的问题不是 Flutter 代码,而是签名资源不一致。
| 检查项 | 常见问题 |
|---|---|
| Bundle Identifier | 与 Profile 中应用标识不一致 |
| Team | 选择了错误开发者账号 |
| Certificate | 证书过期或不存在 |
| Provisioning Profile | 类型不匹配发布环境 |
可以使用命令查看当前签名配置:
xcodebuild -showBuildSettings -workspace ios/Runner.xcworkspace -scheme Runner | grep PRODUCT_BUNDLE_IDENTIFIER预期输出
PRODUCT_BUNDLE_IDENTIFIER = 当前应用标识验证 Archive 产物
Archive 完成后,可以在 Xcode Organizer 中查看归档记录,也可以检查生成目录:
ls <PATH>/Runner.xcarchive预期结果
Info.plist
Products
dSYMs其中 <PATH> 表示本机 Archive 存储路径,实际路径会因环境不同而变化。
处理常见失败场景
如果提示 Provisioning Profile 不存在,优先检查 Bundle Identifier 是否已经创建对应 App ID。
如果提示签名身份无效,检查 Apple Developer 账号权限和证书状态。
如果 Archive 成功但上传失败,需要继续检查 App Store Connect 中的应用配置、版本信息和权限,而不是重新生成证书。
完成 iOS Archive 的关键不是记住某个按钮位置,而是理解签名链路:应用身份由 Bundle Identifier 确定,签名能力由 Certificate 提供,发布权限由 Provisioning Profile 约束,三者匹配后才能生成可发布构建产物。