iOS 上架需要哪些材料？一份面向工程团队的完整清单与实操说明

许多团队在准备首次提交 iOS 应用时，最常见的问题不是技术实现，而是：“到底需要准备哪些材料？”
App Store 提交流程本质上是一个覆盖 法律合规、图标资产、隐私说明、证书体系、构建产物 的复合工程。每项材料之间都有对应关系，一旦某个材料缺失或不匹配，就会导致审核失败或上传不通过。

基于多个真实项目经验，本文将材料需求按工程逻辑重新整理，并说明每项材料在提交链路中的作用。

一、基础身份材料：账号、Bundle ID 与签名体系

苹果发布体系的第一层是“身份”，也就是应用在系统中的唯一标识。

1. Apple 开发者账号（个人或公司）

用于：

• 访问证书与描述文件管理
• 创建 Bundle ID
• 提交 App Store 应用
• TestFlight 分发

这是所有材料的起点。

2. Bundle ID（应用唯一标识）

每个上架的应用都必须有一个独立的 Bundle ID。

工程中常见问题包括：

• 创建了重复 ID
• 多个应用共用同一 Bundle ID
• Bundle ID 命名不规范导致证书匹配失败

为了避免这些问题，我通常会：

• 使用 Appuploader 的 Bundle ID 查看功能
  • 快速列出账号内已有的 Bundle ID
  • 避免命名冲突
  • 确保团队内部材料一致

Bundle ID 是整个签名体系的主键，材料准备要从它开始。

二、签名材料：证书、描述文件与权限能力

App Store 上传与安装都依赖正确的签名链路，因此证书与描述文件是上架材料中最重要的一部分。

3. iOS 发布证书（Distribution Certificate）

用于：

• 给 IPA 签名
• 允许应用提交到 TestFlight 或正式商店

在团队多系统协作时（Windows / Linux / macOS 混合），传统的 macOS 钥匙串方式不够灵活。
因此我在很多项目中采用：

• 使用 Appuploader 创建 iOS 证书
  • 可在任意系统生成
  • 成员可以共享 p12 文件
  • 适用于 CI/CD 体系

4. App Store 描述文件（App Store Profile）

描述文件（mobileprovision）包含以下重要内容：

• 绑定的 Bundle ID
• 绑定的证书
• 权限（Capabilities）
• 应用签名所需的 Team ID

为了确保描述文件正确，我常用：

• Appuploader 查看 mobileprovision 内容
  • 清晰看到绑定证书类型、Bundle ID、Team ID
  • 避免下载错文件导致构建失败
    

这是审核系统判断签名合法性的关键文件。

三、资源材料：图标、Assets.car、截图与文案

图标与资源往往被低估，然而 App Store 95% 的外观审核都与资源相关。

5. App Icon 图标（1024×1024 PNG）

必须为正方形，不能透明，边距合理。
但 iOS 需要几十种尺寸，手工生成容易出错。

我会使用：

• Appuploader 图标生成工具
  • 上传 1024 图即可自动生成所有 iOS 图标
  • 支持生成 Assets.car（iOS 12 / macOS 所需）
  • 图标规范统一，减少审核因图标模糊被拒的风险

6. 应用截图（多尺寸、多语言）

必须准备：

• iPhone 6.5’’
• iPhone 5.5’’
• iPad 可选

截图应与应用内容真实一致。
如果图标、文案或界面不匹配，会触发被拒风险。

7. App Store 文案材料

包括：

• 标题
• 副标题
• 描述
• 关键词
• 隐私政策链接
• 支持 URL
• 版权归属

文案是审核系统判断“应用是否具有独立功能”的依据之一。

四、隐私材料：权限说明与合规内容

从 2021 年起，苹果强化隐私要求，隐私材料成为审核重点。

8. Info.plist 隐私权限说明

必须包含：

• NSCameraUsageDescription
• NSLocationWhenInUseUsageDescription
• NSPhotoLibraryUsageDescription
• 其他涉及的权限说明

如果文本描述与功能不符，可能直接被拒。

9. 隐私政策（Privacy Policy URL）

必须可访问，并与应用功能一致。
对于包含登录、第三方 SDK 或采集数据的应用尤为重要。

10. 数据收集表单（App Privacy）

在 App Store Connect 填写。
如填写不一致，审核会延迟甚至拒绝。

五、构建材料：IPA 文件与内部结构检查

IPA 是最终提交的构建产物，也是最容易出问题的材料。

11. IPA 文件（必须使用发布签名）

必须确保：

• 使用发布证书签名
• 对应 App Store 描述文件
• 内部结构正确

为了避免“上传后 Processing 失败”的情况，我会先检查 IPA 内容，例如：

• 使用 Appuploader 查看 Info.plist / mobileprovision / Assets.car 是否完整

可在非 macOS 环境执行，有助于多平台团队提前发现问题。

六、提交材料：上传 IPA 的实际步骤与方式

上传 IPA 永远是发布流程的关键节点。
传统方式依赖：

• Xcode Organizer
• Transporter
• macOS 环境

如果团队成员没有 Mac，或者 CI 运行在 Windows / Linux，就会被卡住。

因此在许多项目中，我使用：

12. Appuploader CLI 执行 IPA 上传（跨平台）

示例命令：

appuploader_cli -u dev@icloud.com -p xxx-xxx -c 1 -f build.ipa

优点：

• Windows / Linux / macOS 均可执行
• 可自动化
• 上传动作不依赖 Transporter
• 更容易在 CI 中集成

也就是说，提交材料不再受限于某一台 Mac。
图形化界面：

七、审核提交阶段：审核可能要求补充的材料

审核过程中，苹果可能会要求额外材料，包括：

• 演示视频（展示关键功能）
• 测试账号（如登录功能必须提供）
• 功能解释（说明某些权限的使用场景）

虽然不属于初次提交的材料，但应提前准备好应对方案。

iOS 上架所需材料不是孤立项，而是完整体系

从 Bundle ID，到证书，再到 IPA 与文案，苹果上架所需的材料不是分散的，而是围绕整个工程体系构建的。

材料准备越规范：

• 构建越稳定
• 审核越顺利
• 团队协作越清晰
• 上架失败概率越低

最终目标不是把材料准备齐，而是让整个过程：清晰、可复用、可协作、可验证。