agf-releasing-apple

# Releasing the Apple distributable (sign → notarize → package → smoke) 把**合并到 main 后的干净代码**构建成签名分发包，冒烟自检通过后交接 apple-qa-engineer。本 skill 是 apple-release-engineer 的分步 runbook；契约 SSOT 是 [`deployment.md` §7](../../standards/deployment.md)，流水线决策是 [ADR-009](../../../docs/adr/009-apple-release-pipeline.md)。 ## 适用门 满足以下**全部**才进入构建： - 角色 = `apple-release-engineer`（deploy-only，不修业务源码；`apple/fastlane/` 配置是可写域）。 - 目标是 **Apple 原生链路**（`apple/` 工程）。Web docker UAT → 归 deploy-engineer；小程序体验版 → 归 miniapp 轨。**均不适用**。 - apple code review（含 SIT Audit）已通过**且已合并到 main**，product-lead 已确认"构建分发包"（对话内确认或 `/agf-apple-release` 手动触发），且 PRD 已声明渠道。 任一不满足 → 不构建，SendMessage product-lead 说明缺什么。 ## 前置检查（构建前必须逐项确认） - [ ] **main 干净且最新**：`git status` 无未提交改动，记录构建 commit SHA（`git rev-parse --short HEAD`）。 - [ ] **工具链可用**：`xcodebuild -version` / `bundle exec fastlane --version` 正常返回。 - [ ] **签名材料就位且不入库**：App Store Connect API key（`.p8`）路径 / key id / issuer id 经环境变量可达；match 仓可访问（`fastlane match` 能同步证书 + profile）。任何 `.p8` / `.p12` / `.mobileprovision` 都**不得**出现在 git 工作区（scan-secrets / pre-commit 兜底）。 - [ ] **渠道已声明**：PRD / task 写明渠道，映射到 lane（见下表）。 - [ ] **版本号就绪**：marketing version 符合 `versioning.md`；build number 在该渠道单调递增。 任一不勾 → 不构建，先 SendMessage product-lead 解决先决条件。 ## 渠道 → lane 执行（映射 SSOT 见 deployment.md §7.2） ```bash cd apple && bundle exec fastlane <lane> ``` | lane | 渠道 | 关键动作 | |---|---|---| | `beta` | TestFlight 内测 | `match(type: appstore)` → `build_app` → `pilot`（上传 + 等待处理完成） | | `release_appstore` |...