KMP 自动化之路 (4)：iOS 自动化构建与签名 —— 攻克最硬的骨头

前言

对于 Android开来说，iOS 的打包签名机制简直像外星科技。Provisioning Profile、Certificate、P12 文件... 每一个词都让人头大。

但在 KMP 工程化中，这关必须得过。因为如果 CI 不能编出带签名的 .ipa 文件，你的 iOS 端就永远无法实现"持续交付"。今天我们来拆解如何在 GitHub Actions 中自动化搞定这一切。

---

一、 核心痛点：为什么 iOS 这么难？

1. 硬件限制：只能在 macOS 编译。
2. 证书校验：Apple 强制要求真机运行必须有签名。
3. Xcode 命令行 ：必须熟练使用 xcodebuild 而非仅仅是 gradlew。

---

二、 现代方案：fastlane 入场

不要尝试直接写复杂的 xcodebuild 命令，那太容易出错。fastlane 是 iOS 自动化的行业标准。

我们在 app/iosApp 目录下配置 fastlane：

# Fastfile
platform :ios do
  desc "Build and Sign for TestFlight"
  lane :release do
    setup_ci # 自动同步证书
    build_app(scheme: "iosApp") # 触发编译
    upload_to_testflight # 上传
  end
end

---

三、 GitHub Actions 中的证书同步：Match

如何把你的开发证书传给 GitHub 的虚拟机？ fastlane match：它会将证书加密后存放在一个私有的 Git 仓库中。CI 运行时只需一条命令：

      - name: Sync Certificates
        run: bundle exec fastlane match readonly
        env:
          MATCH_PASSWORD: ${{ secrets.MATCH_PASSWORD }}

---

四、 联动 Kotlin：从 Gradle 到 Xcode

记住 KMP 的构建链路： Gradle (:app:shared:assemble) -> 生成 Framework -> Xcode (Linking) -> 生成 App

在 CI 脚本中，顺序至关重要：

1. 首先运行 ./gradlew :app:shared:embedAndSignAppleFrameworkForXcode。
2. 确保 Framework 在正确的位置。
3. 再调用 fastlane。

---

五、 架构建议

1. 使用 GitHub Secrets：绝对不要把证书（.p12）或 Profile 提交到代码库。利用 GitHub 的加密 Secrets 存储 fastlane 的 APP_STORE_CONNECT_API_KEY。
2. 版本号同步 ：编写一个简单的脚本，让 Android 的 versionCode 和 iOS 的 buildNumber 在 CI 流程中保持同步，由 CI 生成统一的时间戳版本号。

---

结语

搞定了 iOS 的自动化签名，你就扫清了 KMP 全栈交付的最大障碍。你现在已经拥有了一个可以真正商用的"全平台构建工厂"。

下一篇，我们将探讨：CD 与自动分发：如何一键让全端应用上线？