IOS on Liangweidong's blog

iOS App Store 上架：截图、构建、审核与发布完整流程

Fri, 15 Nov 2019 00:00:00 +0800

完整流程概览

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


本地代码
 ↓ Xcode Archive
.xcarchive 文件
 ↓ Export
.ipa 文件
 ↓ Transporter 上传
App Store Connect 后台
 ↓ 填元数据（截图、描述、关键词）
 ↓ 选构建版本
 ↓ 提交审核
 ↓ 审核通过
App Store 上架

一、Xcode Archive 打 Release 包

顶部 Scheme 选择 Any iOS Device (arm64)
Product → Archive
等待打包完成（首次 5~~10 分钟，后续 1~~2 分钟）
弹出 Organizer 窗口

二、Export IPA

Organizer 中选中刚打的 Archive
点击 Distribute App
选择分发方式：
- App Store Connect → 上架 / TestFlight
- Ad Hoc → 内测
- Development → 真机调试
- Enterprise → 企业内部分发
选择上传工具：Xcode（直接传）或 Transporter（手动传）
选择 Upload 勾选 Include bitcode for iOS content（可选）、Strip Swift symbols（建议勾选，减少包大小）
选证书（Apple Distribution）和 Profile（App Store）
Export → 选择保存路径 → 得到 .ipa 文件

三、Transporter 上传

macOS 用 Transporter App（App Store 下载）：

打开 Transporter
登录 Apple ID（开发者账号）
把 .ipa 拖入窗口
点击 Deliver
等待上传完成（5~30 分钟，取决于包大小和网速）

上传后 5~30 分钟，App Store Connect 后台会出现构建版本（状态：Processing → Ready to Submit）。

四、App Store Connect 配置

创建 App

我的 App → “+” → 新建 App
填写：
- 平台：iOS
- 名称（如 “我的App”）
- 主要语言
- 套装 ID：选择之前创建的 App ID
- SKU：唯一标识（如 “myapp-001”）
- 用户访问权限：完全访问

元数据

截图

必须提供 6.5 英寸和 6.7 英寸两套截图（也支持 iPad）：

设备	尺寸（像素）
6.5 英寸	1242 × 2688 或 2688 × 1242（横屏）
6.7 英寸	1284 × 2778 或 2778 × 1284（横屏）
5.5 英寸（可选）	1242 × 2208

对应设备举例：

6.5 英寸：iPhone 11 Pro Max, XS Max
6.7 英寸：iPhone 12/13/14/15 Pro Max

可以上传 3 个 App 预览视频（15~30 秒 MP4/H.264）和最多 10 张截屏。

截图生成工具：

Figma / Sketch + 设备模板
官方 Apple Design Resources 提供的 Sketch/Figma 模板
在线工具：Screenshot.rocks、Mockuphone.com

应用描述

副标题（30 字符）：一句话讲清产品
宣传文本（170 字符）：可以随时改，不用审核
描述（4000 字符）：详细功能、亮点
关键词（100 字符）：逗号分隔，影响搜索

类别

主要类别（如工具 / 效率 / 教育）
次要类别（可选）

版权

五、构建版本

App Store Connect → App → 活动 → 构建版本
选择刚上传的构建（必须先在 Xcode 选 iOS Distribution 证书导出）
填写 Export Compliance Information：
- 是否使用加密（Is your app designed to use cryptography?）→ 一般选 No（除非用了非 HTTPS 加密）
- 是否符合美国出口管制豁免（App available on the French App Store?）→ 选 Yes

六、版本发布

版本（1.0.0 / 1.0.1）：三位数字，主版本.功能版本.修订版本
版权 / 联系方式
审核信息：
- 演示账号（如果 App 有登录）
- 审核备注（说明特殊功能如何测试）
- 联系方式（电话 + 邮箱）
App 审核附件（可选）：录屏、额外材料

七、提交审核

检查所有必填项（红色感叹号）
点击右上角 添加以供审核
选刚配的版本
再次点击 添加以供审核 确认提交

八、审核等待

一般 24~48 小时
节假日 / 寒暑假：可能 3~7 天
加急审核：https://developer.apple.com/contact/app-store/?topic=appeal（每年最多 2 次）

九、审核结果

通过

后台状态：Ready for Sale
选 Manually release this version 手动发布，还是 Automatically release 自动发布
选 Phased Release 分阶段发布（7 天内逐步放给 1%/2%/5%/10%/20%/50%/100% 用户）

被拒

后台会发邮件说明原因（4.0/2.1/3.1.1 等条款号）
常见原因：
- 4.0 抄袭 / 模仿
- 2.1 崩溃、bug
- 3.1.1 内购绕过
- 4.2 最低功能性
- 5.1.1 隐私协议缺失
解决后重新提交

十、上架后被下架

常见原因：开发者主动下架、违反政策、长期不更新。

重新上架方法

App Store Connect → App 价格与销售范围
设置 供应情况 → 可供销售
保存成功后 App Store 即可看到

截图要求（按苹果规范）

项目	要求
格式	PNG / JPEG（无 alpha）
尺寸	见上表（6.5 + 6.7 必填）
数量	1~10 张（每个尺寸）
预览视频	0~~3 个，H.264 MP4/MOV，15~~30 秒

加速审核的注意事项

避开节假日（圣诞、春节、暑假前）
首发版本先打完美——上架后每次更新都需重新审核
TestFlight 内测：上架前先让 5~10 个内部测试员跑一周
第三方 SDK 合规：广告 SDK、统计 SDK 必须有隐私协议

十一、2024+ 视角：Xcode 15+ / iOS 17+ 上架新特性

本文 2019 年写时 Xcode 还是 11，截图规范还停留在 iPhone XS Max 6.5 英寸。5 年后（2024），Xcode 已经迭代到 15.x（iOS 17 SDK），iPhone 出到 15 Pro Max（6.7 英寸 2796×1290），上架流程也发生了重大变化。下面是当前最佳实践。

1. 截图规范的更新（2024）

设备	2019 主流	2024 主流
6.5 英寸	iPhone XS Max（1242×2688）	iPhone 11 Pro Max（1242×2688）✅ 仍可
6.7 英寸	刚开始	iPhone 14/15 Pro Max（1290×2796）
6.9 英寸	—	iPhone 16 Pro Max（2024 新增）
6.1 英寸	可选	可选
iPad	12.9 英寸（2048×2732）	13 英寸 M4 iPad Pro（2048×2732）

重要变化：

iPhone 6.5 英寸 + 6.7 英寸 → 现在只需 6.7 英寸（6.5 自动向下兼容）
iPhone 6.9 英寸（iPhone 16 Pro Max，2024-09）强烈建议补一份——这是 App Store 展示位主推尺寸
iPad 13 英寸（M4）也建议补——iPad 端流量不容忽视

2024 截图生成：

官方 Apple Design Resources 提供最新 PSD/Sketch/Figma 模板
工具：Screenshot.rocks（在线）、Mockuphone、Figma + 设备框模板

2. Xcode 15+ 的关键变化

2.1 默认不再支持 32 位

Xcode 15+ 彻底移除 armv7——App Store 也不接受 32 位包
最低 iOS 12（之前是 iOS 9）

2.2 构建系统升级

默认使用 BUILD_LIBRARY_FOR_DISTRIBUTION（Swift Package 友好）
ENABLE_USER_SCRIPT_SANDBOXING 默认开启（脚本沙箱化）—— 部分 CI 脚本需加 allowed write paths
生成 Swift 文档（DocC）成为内置功能

2.3 模拟器变化

iOS 17 模拟器默认 Apple Silicon（arm64 模拟器）
旧的 Rosetta 模拟器已被移除（Xcode 14.3+）
iPhone 15 Pro / iPhone 15 / iPhone 15 Plus / iPhone SE (3rd) 模拟器内置

3. iOS 17 新 API（如果你的 App 用了）

上架时 Info.plist 隐私描述（NSPrivacyAccessedAPITypes）是强制项：

1
2
3
4
5
6
7
8
9


<key>NSPrivacyAccessedAPITypes</key>
<array>
 <dict>
 <key>NSPrivacyAccessedAPIType</key>
 <string>NSPrivacyAccessedAPICategoryUserDefaults</string>
 <key>NSPrivacyAccessedAPITypeReasons</key>
 <array><string>CA92.1</string></array>
 </dict>
</array>

5 大必填项（用了哪些就要写）：

UserDefaults（CA92.1）
FileTimestamp（C617.1）
SystemBootTime（35F9.1）
DiskSpace（85F4.1）
ActiveKeyboards（54BD.1）

2024-05 起 Apple 强制要求——缺了就被拒。

4. TestFlight 公开链接（关键灰度手段）

2020 推出，2024 已经成熟到人手一个：

1

App Store Connect → App → TestFlight → 公开链接 → 创建链接

示例：https://testflight.apple.com/join/XXXXXXXX

好处：

灰度期间不需要走 Apple 审核（外部测试自动通过）
50~500 人灰度极方便
用户点链接 → 装 TestFlight → 装 App，全程3 分钟

5. App Store Connect API（替代手工）

2024 上架流程的"重头戏"——几乎所有手动操作都 API 化了：

1
2
3
4
5
6


# 用 API Key 上传构建（不再用 Transporter GUI）
xcrun altool --upload-app \
 --type ios \
 --file MyApp.ipa \
 --apiKey ABC123XYZ \
 --apiIssuer 12345678-90ab-cdef-1234-567890abcdef

配合 CI/CD：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# GitHub Actions 示例
- name: Upload to App Store Connect
 run: |
 xcrun altool --upload-app \
 --type ios \
 --file build/MyApp.ipa \
 --apiKey ${{ secrets.ASC_KEY_ID }} \
 --apiIssuer ${{ secrets.ASC_ISSUER_ID }}
 env:
 ASC_API_KEY_FILE_BASE64: ${{ secrets.ASC_API_KEY_BASE64 }}

6. Phased Release（分阶段发布）

2018 推出，2024 仍是默认推荐：

1
2


App Store Connect → 版本 → Phased Release
 ☑ Release this version over 7 days

节奏：

Day	比例
1	1%
2	2%
3	5%
4	10%
5	20%
6	50%
7	100%

好处：上线首日如果 crash / 服务器挂，只影响 1% 用户，有时间回滚。

7. App 内购买（IAP） —— StoreKit 2

2021 推出 StoreKit 2（Swift async/await 原生 API），2024 是新项目默认：

1
2
3
4
5
6
7
8


// StoreKit 1（旧）
SKPaymentQueue.default().add(payment)

SKProductsRequest().start()

// StoreKit 2（新）
let products = try await Product.products(for: ["com.example.coin_100"])
let result = try await products[0].purchase()

新项目 2024 必用 StoreKit 2——Apple 已在 WWDC 2023 明确"StoreKit 1 进入维护期"。

8. 加速审核的现状（2024）

渠道	时效	限制
正常审核	24~48h	—
加急审核	几小时	每年 2 次（和 2019 一样）
App Review 申诉	不定	误判可用
紧急安全修复	更快	严重安全问题

加急理由必须合理（“赶首发"不算理由，“修复支付漏洞"算）。

9. 常见 4.0/2.1/3.1.1 条款的应对（2024 强化版）

条款	含义	2024 应对
4.0 抄袭	模仿其他 App	设计稿必须有原创 logo / 配色 / icon
2.1 崩溃	App 启动即崩	上架前必须 TestFlight 跑 7 天
3.1.1 内购绕过	用第三方支付绕开 Apple 30%	数字内容/虚拟商品必须用 IAP，实物可以走第三方
4.2 最低功能性	App 功能太简单	加内容、UGC、AI 助手、3 个以上核心功能
5.1.1 隐私协议	缺隐私协议 / 收集不声明	必填 + 详细披露所有 SDK
2.3.10 准确元数据	截图与 App 实际不符	截图必须真实反映 App 界面（不再接受美化）

10. App Store Small Business Program

2021 推出，2024 仍是：

年营收 < 100 万美元 → 苹果抽成从 30% → 15%
资格自动判定，无需申请

1 年后第一次续费：仍享 15%——这条 2023 改的，比之前友好。

11. 2024 上架完整流程（更新版）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


1. 本地代码
 ↓ Xcode Archive (Cmd+Shift+B → Any iOS Device)
2. .xcarchive
 ↓ Organizer → Distribute App → App Store Connect → Upload
3. .ipa
 ↓ 自动签名 + Xcode 上传 OR altool + API Key
4. App Store Connect
 ↓ 填元数据（截图 6.7 英寸 / 6.9 英寸 / iPad 13 英寸）
 ↓ 选构建版本
 ↓ 提交审核
5. 审核通过
 ↓ Phased Release 分 7 天
6. 上架

12. 一句话总结

2019 年是 Xcode 11 + iOS 13 + iPhone XS Max + 手工上传 Transporter 的时代； 2024 年是 Xcode 15+ + iOS 17 + iPhone 15/16 Pro Max + App Store Connect API + Phased Release + TestFlight 公开链接 的时代。

流程更短、更自动、更安全——上架从"几天手工活"变成"几小时自动化”。

下一步

想做 CI/CD 自动打包（GitHub Action + fastlane），看 fastlane 官方文档
想做版本号自动管理（语义化版本），看 Semver
想加内购（IAP），看 StoreKit 2 官方文档
想做灰度发布，看 TestFlight 公开链接

参考资料

App Store Connect 文档：https://developer.apple.com/help/app-store-connect/
App Store 审核指南：https://developer.apple.com/app-store/review/guidelines/
截图规范：https://developer.apple.com/help/app-store-connect/manage-app-information/upload-app-previews-and-screenshots
App Store Connect API：https://developer.apple.com/documentation/appstoreconnectapi
StoreKit 2：https://developer.apple.com/documentation/storekit/
Transporter：https://apps.apple.com/app/transporter/id1450874784
Xcode 15 Release Notes：https://developer.apple.com/documentation/xcode-release-notes/xcode-15-release-notes

iOS 应用开发与证书管理：开发者账号、Identifiers 与 Profiles

Tue, 15 Aug 2017 00:00:00 +0800

准备工作

iOS 开发需要两样硬件：

iPhone 手机（调试设备，UDID 唯一）
Mac 电脑（macOS 10.9+，钥匙串访问工具）

实际上没有 Mac 也可以用云 Mac（MacStadium、AWS EC2 Mac），但本地 Mac 是最舒服的方案。

一、申请 Apple ID

如果已有 Apple ID 可跳过。访问 https://appleid.apple.com 注册。建议用真实邮箱（后续找回密码用得到）。

二、申请开发者账号

访问 https://developer.apple.com/account

账号类型

类型	费用	适用
个人（Individual）	99 USD/年	独立开发者
组织（Organization）	99 USD/年	公司（需 D-U-N-S 编号）

注册流程：登录 → 选择类型 → 填写资料 → 付款 → 等待审核（1~3 天）。

三、申请 Identifiers（App ID）

App ID 是应用的唯一标识，对应一个 Bundle ID（如 com.yourcompany.appname）。Bundle ID 不可重复，建议用反向域名：

个人：com.firstname.lastname.appname
公司：com.companyname.appname

创建步骤

登录后台 → Certificates, Identifiers & Profiles → Identifiers
点击 “+” 添加
选择 App IDs，点击 Continue
选择 App
填写 Description（如 “我的App”）和 Bundle ID（如 com.example.app）
Capabilities：勾选需要的能力（推送通知、Sign in with Apple、App Groups、HealthKit 等）
点击 Continue → Register

常用 Capabilities

Push Notifications：推送（必须生成 APNs 证书或 key）
Sign in with Apple：Apple 登录
App Groups：应用间共享数据
Background Modes：后台运行
HealthKit / HomeKit / Wallet：健康/智能家居/钱包

四、申请 Certificates（证书）

iOS 证书分三类：

证书	用途
Apple Development	开发期（真机调试）
Apple Distribution	发布期（App Store / Ad Hoc）
APNs SSL (Sandbox & Production)	推送通知（Sandbox 开发、Production 生产）

申请步骤（Mac 钥匙串）

打开 Mac → 应用程序 → 实用工具 → 钥匙串访问
菜单：钥匙串访问 → 证书助理 → 从证书颁发机构请求证书
填写：
- 用户电子邮件：开发者邮箱
- 常用名称：随便填
- CA 邮箱：留空
- 请求是：选择存储到磁盘
保存得到 CertificateSigningRequest.certSigningRequest 文件
回到 Apple Developer 后台 → Certificates → “+”
选择证书类型（Apple Development / Apple Distribution）
上传 .certSigningRequest 文件
下载生成的 .cer 证书
双击 .cer → 用钥匙串打开
在钥匙串中找到该证书 → 右键 → 导出 → 保存为 .p12（含私钥）

p12 密码：导出时设一个密码。别忘了这个密码——CI/CD、Fastlane、跨电脑开发都要用。

推送证书（APNs）

同上，但选 Apple Push Notification service SSL (Sandbox & Production)
同一个 App ID 可以同时有 Development 和 Production 推送证书
iOS 13+ 起，也可以用 APNs Auth Key（.p8） 替代 SSL 证书——一份 key 通用 Sandbox 和 Production

五、添加调试设备

调试设备必须先在 Apple Developer 后台注册 UDID。

获取 UDID

iPhone 用数据线连接 Mac
打开 iTunes（macOS Catalina 之前）/ Finder（Catalina 之后）
点击 iPhone 图标
在序列号区域点击切换显示 UDID
右键 → 复制

添加到 Apple Developer

后台 → Devices → All → “+”
填写：
- Platform：iOS / tvOS / watchOS
- Device Name：随便（如 “iPhone 15 - Dev”）
- Device ID (UDID)：粘贴刚才复制的 UDID
Register

个人开发者账号最多注册 100 台 设备（每年重置一次）。

六、申请 Provisioning Profiles

Profile 把 App ID + Certificates + Devices 串起来，是 Xcode 编译时真正要的"凭证包"。

类型

Profile	用途
iOS App Development	真机调试
Ad Hoc	内测（不上 App Store，最多 100 台设备）
App Store	上架 App Store

创建步骤

后台 → Profiles → All → “+”
选择类型 → Continue
选择 App ID → Continue
选择证书（Apple Development / Apple Distribution）→ Continue
选择调试设备（仅 iOS App Development / Ad Hoc）→ Continue
命名 Profile（如 “MyApp Dev”）→ Generate
下载 .mobileprovision 文件
双击安装到 Xcode

添加新设备后必须重新生成 Profile——老的 Profile 不会自动包含新设备。

七、Xcode 中配置

打开 Xcode → 项目 → Signing & Capabilities
勾选 Automatically manage signing（Xcode 自动管理）
Team 选择你的 Apple Developer Team
Bundle Identifier 填刚才创建的 App ID

或者手动管理：

取消勾选 Automatically manage signing
Provisioning Profile 选择刚才下载的
Signing Certificate 选择对应的证书

八、构建并跑真机

1
2


# Xcode 选中真机（不是模拟器）
# Product -> Run (Cmd + R)

首次运行会弹窗要求信任证书：设置 → 通用 → VPN 与设备管理 → 信任开发者。

常见问题

“No code signing identities found”

证书没装到钥匙串。重新双击 .cer 文件。

“Failed to create provisioning profile”

Profile 中没有包含当前设备。重新生成 Profile（包含新设备 UDID）。

“Bundle Identifier conflict”

Bundle ID 全局唯一，换一个。

推送收不到

检查 Capabilities 是否勾选 Push Notifications
检查 APNs 证书是否过期（开发证书 1 年，生产证书 1 年）
改用 APNs Auth Key (.p8) 不会过期

2024+ 视角：自动签名、App Store Connect API、TestFlight

本文 2017 年写时，Xcode 的"自动签名"还是可选功能（Xcode 8 引入但很多团队不敢用）。7 年后（2024），自动签名已经是事实标准——配合 App Store Connect API + TestFlight + Fastlane，整套流程可以做到零人工、零 .p12 邮件。下面是当前的最佳实践。

1. 自动签名（Automatic Signing）—— 现在不用会累死

Xcode 14+（2022-09）：自动签名能力再次大幅增强。

1.1 项目配置

1
2
3
4


# Xcode → Project → Target → Signing & Capabilities
☑ Automatically manage signing
 Team: <Your Team ID>
 Bundle Identifier: com.example.app

之后——Xcode 会自动：

创建/更新 App ID
创建/更新 Provisioning Profile（Development / Ad Hoc / Distribution）
关联证书
写入 *.xcodeproj/project.pbxproj

好处：

新员工入职 → 登录 Apple ID 即可（不用再走"申请证书 → 申请 Profile → 导出 p12"流程）
Bundle ID 改名 → Xcode 自动重建
新增设备 UDID → Xcode 自动重生成 Dev Profile
没有 p12 邮件——告别 .p12 + 密码在企业微信群里传来传去

1.2 仍然需要手动的场景

企业内部分发（In-House / Enterprise）——仍需手动建 Enterprise Profile
跨电脑同步证书——见下节"钥匙串共享"
多 Target / 多 Bundle ID——Target 数量多时仍需手动管理

2. App Store Connect API（替代手工点网页）

2018 年 Apple 推出 App Store Connect API，到 2024 年已经覆盖几乎所有手动操作（上传构建、创建版本、提交审核、管理 TestFlight、管理用户等）。

2.1 创建 API Key

1

App Store Connect → Users and Access → Keys → App Store Connect API → Generate

得到 3 项：

Issuer ID（团队级，UUID）
Key ID（单 key 唯一）
.p8 文件（私钥，只能下载一次）

2.2 用 API Key 上传构建（不再用 Transporter GUI）

1
2
3
4
5
6


# 安装 xcrun（Xcode 自带）
xcrun altool --upload-app \
 --type ios \
 --file MyApp.ipa \
 --apiKey ABC123XYZ \
 --apiIssuer 12345678-90ab-cdef-1234-567890abcdef

vs 旧版 Transporter：

✅ 可脚本化（CI/CD 友好）
✅ 不需要交互登录
✅ 不需要 2FA 验证码
✅ 一台机器一个 .p8，不受 Mac 换机影响

2.3 用 API Key 自动创建版本 / 提交审核

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40


# 用 PyJWT 签 JWT，调用 App Store Connect REST API
import jwt
import time
import requests

KEY_ID = "ABC123XYZ"
ISSUER_ID = "12345678-90ab-cdef-1234-567890abcdef"
PRIVATE_KEY = open("AuthKey_ABC123XYZ.p8").read()

# 1. 签 JWT
token = jwt.encode(
 {
 "iss": ISSUER_ID,
 "iat": int(time.time()),
 "exp": int(time.time()) + 1200,
 "aud": "appstoreconnect-v1",
 },
 PRIVATE_KEY,
 algorithm="ES256",
 headers={"kid": KEY_ID},
)

# 2. 创建新版本
r = requests.post(
 "https://api.appstoreconnect.apple.com/v1/appStoreVersions",
 headers={"Authorization": f"Bearer {token}"},
 json={
 "data": {
 "type": "appStoreVersions",
 "attributes": {
 "versionString": "1.2.0",
 "platform": "IOS",
 },
 "relationships": {
 "app": {"data": {"type": "apps", "id": "1234567"}}
 },
 }
 },
)
print(r.json())

3. TestFlight 2024 现状

Xcode 14+ 起 TestFlight 体验大幅提升：

特性	2017 状态	2024 状态
内测名额	25 个内部 + 1000 外部	100 个内部 + 10000 外部
外部测试	需 Apple 审核	不再需要（自动通过）
构建有效期	60 天	90 天
群组管理	后台手动	API 自动化
安装方式	邮件 / 链接	TestFlight App / 公开链接 / QR Code

TestFlight 公开链接（2020 推出）：

1

https://testflight.apple.com/join/XXXXXXXX

任何人点链接 → 安装 TestFlight App → 收到邀请 → 安装内测版。适合 50 人以内的小范围灰度。

4. Fastlane match —— 证书管理的"正确姿势"

本文 2017 时 Fastlane 还很新，2024 已经成熟到"不用不专业"。

4.1 match 是什么

把证书和 Profile 集中存到一个 Git 仓库（可以是私有 GitLab/Gitee），全团队共享。新员工入职 = 拉一次 git 仓库 = 拿到所有证书。

4.2 初始化

1
2
3
4
5
6
7
8
9


# 1. 装 fastlane
sudo gem install fastlane

# 2. 在项目根目录初始化
fastlane match init

# 3. 创建证书 + Profile（一次性）
fastlane match appstore # App Store 分发
fastlane match development # 真机调试

4.3 在 CI/CD 里用

1
2
3
4
5
6
7
8


# CI 拉证书
fastlane match appstore --readonly \
 --git_url git@gitlab.example.com:mobile/ios-certificates.git \
 --git_branch main \
 --app_identifier com.example.app

# 接着打包
fastlane build_release

好处：

不再用邮件发 p12——告别"证书密码忘了"、“p12 过期”、“新员工入职没人理”
CI 机器无障碍——GitHub Actions / GitLab CI 直接拉
审计友好——所有证书变更都有 git 提交记录

5. 钥匙串共享（跨 Mac 同步）

如果仍然用手动签名 + 跨 Mac 开发，用 iCloud 钥匙串：

1

系统设置 → 通用 → Apple ID → iCloud → 钥匙串 ☐→☑

之后——所有登录 Apple ID 的 Mac 自动共享证书 / 私钥。新 Mac 登录 = 5 分钟拿到所有签名材料。

6. 2024 iOS 证书管理完整流程（推荐）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16


首次（一次性）：
 1. 团队 Leader 跑 fastlane match
 → 创建 App ID / Cert / Profile → 推到 Git 仓库

日常开发：
 2. 新员工 git pull 证书仓库
 3. fastlane match development --readonly
 4. Xcode 打开 → 自动签名（团队 ID + Bundle ID 一致就行）

CI/CD：
 5. GitLab CI 跑 fastlane match appstore --readonly
 6. fastlane build → altool 上传到 App Store Connect

上架：
 7. App Store Connect API（JWT）创建版本、提交审核
 8. 用 TestFlight 公开链接做灰度

对比 2017：从"邮件发 p12、群里问密码、找运维加 UDID" → “git pull + fastlane 一条命令”。工程师精力从 1 天降到 5 分钟。

7. 2024+ 关键工具版本

工具	2017 主流	2024 主流
Xcode	8.x	15.x / 16 beta（2024）
iOS SDK	iOS 10/11	iOS 17 / 18 beta
Swift	3.x	5.9 / 5.10
TestFlight	内测 25 人	100 + 10000 + 公开链接
证书管理	手动 / 邮件 p12	fastlane match + 自动签名
上传工具	Transporter GUI	xcrun altool + App Store Connect API
签名方式	手动	Xcode 自动签名
Provisioning Profile	手动生成	自动生成（Xcode 14+）

8. 一句话总结

2017 年的 iOS 签名是"每个工程师都要会手动申请证书“的工程师成年礼； 2024 年是”自动签名 + fastlane match + App Store Connect API + TestFlight 公开链接“的"零证书知识"时代。

新人不要再学手动签名——直接 fastlane match 拉仓库、Xcode 自动签名，几分钟搞定。

下一步

想把 IPA 上架 App Store，看 2019-11-15《iOS App Store 上架》
想用 Fastlane 自动化证书 + 打包，看 fastlane match 官方文档
想接 App Store Connect API，看 Apple 官方文档

参考资料

Apple Developer：https://developer.apple.com/account
证书管理：https://developer.apple.com/help/account
Bundle ID 命名规范：https://developer.apple.com/documentation/bundleresources
APNs 文档：https://developer.apple.com/documentation/usernotifications
App Store Connect API：https://developer.apple.com/documentation/appstoreconnectapi
fastlane match：https://docs.fastlane.tools/actions/match/
Xcode 自动签名：https://developer.apple.com/documentation/xcode/automatic-signing