跨平台开发 / 系统课时

自动生成 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 依赖、导入签名材料、执行归档以及保存产物。

iOS CI 签名与归档流程图

使用 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 generated

flutter build ipa 会调用 Xcode 完成归档流程。对于没有配置签名的环境,可以先生成未签名构建用于验证编译链路,再接入发布签名。

管理签名材料和安全配置

iOS 发布依赖 Apple Developer 相关材料,包括开发者证书、分发证书和描述文件。这些内容应存储在 CI 的安全变量或专用密钥管理系统中。

一个可维护的流程通常包含以下原则:

  • 证书和 profile 不进入代码仓库
  • 不同环境使用不同签名配置
  • 构建日志避免输出敏感信息
  • 定期检查证书有效期

处理归档结果和发布衔接

构建成功后,CI 可以保存 IPA 文件作为构建产物,也可以继续连接 TestFlight 或企业分发流程。关键是保证产物和源码版本存在明确关联。

验证自动构建时,需要确认:

  • macOS runner 能正常访问 Xcode 工具链
  • CocoaPods 依赖安装成功
  • archive 阶段没有签名错误
  • 生成 IPA 与目标版本一致

建立稳定的 iOS CI 流程后,发布过程会从依赖开发者电脑转变为可重复执行的工程流程。

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

目录与阅读设置

阅读设置

17

记录一个想法

自动生成 iOS 构建产物

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

登录哪都通