一、准备工作(必做!)
1. 检查开发者账号
登录https://developer.apple.com/https://developer.apple.com/确认账号状态有效(年费已付)。
进入 Certificates, Identifiers & Profiles(找不到就全文搜索),检查是否有有效的证书和描述文件。
2. 配置 Xcode 项目
Bundle Identifier:必须唯一(如 com.company.appname),与 App Store Connect 一致。
版本号:Version(用户可见,如 1.0.0)和 Build(内部迭代,如 100)。
签名设置:
打开项目 → 选择 Target → Signing & Capabilities。
勾选 Automatically manage signing(推荐),或手动选择证书和描述文件。
✅ 说明:
请打开您的 Xcode,按照以下路径截图: 项目导航栏 → 选择 Target → General → Signing & Capabilities 确保 Team 已选择您的开发者账号,Bundle Identifier 无冲突。
二、打包步骤(Xcode 归档 + 导出 IPA)
1. 选择 Release 模式
在 Xcode 顶部菜单栏:
选择 Generic iOS Device(不能选模拟器)。
确认 Build Configuration 为 Release(Debug 模式不能上架)。
✅ 说明:
在 Xcode 顶部工具栏找到设备选择框(默认显示模拟器),切换为 Generic iOS Device。
2. 生成 Archive(归档文件)
点击菜单栏 Product → Archive。
等待编译完成,Xcode 会自动打开 Organizer 窗口(显示所有归档记录)。
✅ 说明:
编译完成后,Xcode 会弹出 Organizer 窗口,显示 Archives 列表,包含本次打包的版本号、时间等信息。
3. 选择分发方式(关键步骤!)
在 Organizer 中点击 Distribute App,选择分发方式:
分发方式适用场景输出文件App Store提交到 App Store 审核直接上传Ad Hoc测试设备(需 UDID).ipa 文件Development开发调试.ipa 文件Enterprise企业内部分发.ipa 文件
✅ 操作示例:
如果选择 Ad Hoc:
点击 Distribute App → Ad Hoc → Next。
选择 Automatically manage signing(或手动选证书)。
导出 .ipa 文件,通过邮件或第三方工具(如蒲公英/Fir.im)分发给测试人员。
🚀 三、提交到 App Store Connect
1. 登录 App Store Connect
进入 我的 App → 选择应用(或新建)。
2. 填写应用信息
名称、描述、关键词(需符合苹果审核规则)。
截图(必须包含 6.5 英寸 iPhone 截图)。
App 图标(1024x1024 像素,无透明背景)。
3. 选择构建版本
在 构建版本 选项里,选择从 Xcode 上传的版本。
点击 提交审核,等待苹果审核(通常 1-3 天)。
说明:
在 App Store Connect 中,进入 App 详情页 → 构建版本,点击 + 按钮 选择已上传的版本。
🔧 四、常见问题解决
❌ 错误 1:No matching provisioning profiles found
原因:描述文件与 Bundle ID 不匹配。 ✅ 解决:
检查 Xcode → Signing & Capabilities 中的 Bundle ID。
到 Apple Developer 重新生成描述文件。
❌ 错误 2:Invalid App Store Icon
原因:图标不符合要求(如尺寸非 1024x1024,或含透明层)。 ✅ 解决:
使用 Preview 或 Photoshop 调整图标为 1024x1024 像素,PNG/JPG 格式。
🎯 五、总结流程图
1. 配置项目 → 2. 选择 Release → 3. Product → Archive
↓
4. Distribute App(选分发方式)
↓
5. 上传 App Store Connect → 6. 填写信息 → 7. 提交审核
📎 附加工具推荐
Fastlane:自动化打包和上传(节省时间)。
TestFlight:苹果官方 Beta 测试工具。
Firebase App Distribution:快速分发给测试团队。