跨平台开发 / 系统课时
自动生成 iOS 构建产物
自动生成 iOS 构建产物
本篇介绍如何在 CI/CD 中自动完成 Flutter iOS 构建,包括 macOS runner 选择、签名材料管理和归档流程。完成后可以建立稳定的 iOS 发布流水线,减少本地 Xcode 环境差异带来的问题。
学习目标
- 理解 Flutter iOS CI 构建依赖的 macOS 环境和签名条件
- 掌握使用 CI 自动执行 iOS 构建归档流程
- 学会管理证书、配置文件和构建产物
理解 iOS 自动构建的特殊要求
与 Android 不同,iOS 构建依赖 Xcode、macOS 环境以及 Apple 签名体系。因此 CI 执行环境必须选择 macOS runner,并准备对应的证书和 provisioning profile。
自动构建流程通常包括安装 Flutter、获取依赖、安装 CocoaPods 依赖、导入签名材料、执行归档以及保存产物。

使用 macOS runner 执行 iOS 构建
下面示例展示一个基础 GitHub Actions iOS 构建任务。签名相关步骤需要根据项目账号和发布方式补充。
yaml
name: iOS Release Build
on:
push:
tags:
- 'v*'
jobs:
build-ios:
runs-on: macos-latest
steps:
- name: Checkout source
uses: actions/checkout@v4
- name: Setup Flutter
uses: subosito/flutter-action@v2
with:
flutter-version: '3.24.0'
- name: Install packages
run: |
flutter pub get
cd ios && pod install
- name: Build iOS archive
run: flutter build ipa --release预期结果
text
Workflow started on macOS runner
Flutter dependencies resolved
CocoaPods dependencies installed
IPA archive generatedflutter build ipa 会调用 Xcode 完成归档流程。对于没有配置签名的环境,可以先生成未签名构建用于验证编译链路,再接入发布签名。
管理签名材料和安全配置
iOS 发布依赖 Apple Developer 相关材料,包括开发者证书、分发证书和描述文件。这些内容应存储在 CI 的安全变量或专用密钥管理系统中。
一个可维护的流程通常包含以下原则:
- 证书和 profile 不进入代码仓库
- 不同环境使用不同签名配置
- 构建日志避免输出敏感信息
- 定期检查证书有效期
处理归档结果和发布衔接
构建成功后,CI 可以保存 IPA 文件作为构建产物,也可以继续连接 TestFlight 或企业分发流程。关键是保证产物和源码版本存在明确关联。
验证自动构建时,需要确认:
- macOS runner 能正常访问 Xcode 工具链
- CocoaPods 依赖安装成功
- archive 阶段没有签名错误
- 生成 IPA 与目标版本一致
建立稳定的 iOS CI 流程后,发布过程会从依赖开发者电脑转变为可重复执行的工程流程。
按自己的节奏,确认真正理解。