跨平台开发 / 系统课时

完成 iOS Archive 构建

完成 iOS Archive 构建

本篇解决 Flutter 应用生成 iOS 发布归档包的问题,理解证书、Provisioning Profile 与 Archive 之间的关系,并完成从工程配置到可发布构建产物的验证流程。

学习目标

  • 理解 iOS Archive 构建中的签名链路
  • 掌握 Flutter 项目生成 iOS Archive 的基本方式
  • 能够定位常见证书和 Provisioning Profile 构建问题

理解 iOS Archive 发布链路

iOS 发布包不是简单的编译结果,而是一组经过签名验证的构建产物。Flutter 项目最终会通过 Xcode 完成 Archive,生成 .xcarchive 文件,再根据发布目标导出 IPA。

核心关系如下:

iOS Archive 签名构建链路示意图

Bundle Identifier 决定应用身份,Certificate 提供签名能力,Provisioning Profile 将应用标识、团队和设备或发布环境绑定起来。

准备 Archive 构建环境

执行 Archive 前,需要确保 Flutter 工程已经可以正常构建 iOS Release:

bash
flutter build ios --release

预期结果

text
Xcode Release 构建流程完成
生成 iOS Release 构建产物

如果 Release 构建失败,应先解决 Flutter 或 Xcode 编译问题,再进入 Archive 阶段。

使用 Xcode 创建 Archive

打开工作区:

bash
open ios/Runner.xcworkspace

预期输出

text
Xcode 打开 Runner.xcworkspace

在 Xcode 中选择 Runner Target,确认签名配置后执行:

  1. 选择 Generic iOS Device 作为运行目标。
  2. 打开 Product 菜单。
  3. 选择 Archive。
  4. 等待 Organizer 窗口显示生成的归档。

Archive 成功后,会得到 .xcarchive 文件,可以继续用于导出 IPA 或上传 App Store Connect。

检查签名资源匹配

Archive 失败最常见的问题不是 Flutter 代码,而是签名资源不一致。

检查项 常见问题
Bundle Identifier 与 Profile 中应用标识不一致
Team 选择了错误开发者账号
Certificate 证书过期或不存在
Provisioning Profile 类型不匹配发布环境

可以使用命令查看当前签名配置:

bash
xcodebuild -showBuildSettings -workspace ios/Runner.xcworkspace -scheme Runner | grep PRODUCT_BUNDLE_IDENTIFIER

预期输出

text
PRODUCT_BUNDLE_IDENTIFIER = 当前应用标识

验证 Archive 产物

Archive 完成后,可以在 Xcode Organizer 中查看归档记录,也可以检查生成目录:

bash
ls <PATH>/Runner.xcarchive

预期结果

text
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 约束,三者匹配后才能生成可发布构建产物。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

完成 iOS Archive 构建

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通