这是一个非常详细和完整的基于 UniApp 将应用打包并上线到 iOS 端(App Store)和安卓端(国内主流市场)的全流程指南。
整个流程可以概括为以下几个核心阶段,我们将对每个阶段进行详细拆解:
1. 准备阶段:开发完成,准备上线材料。
2. 打包阶段:使用 UniApp 生成安装包(Android 的 .apk/.aab 和 iOS 的 .ipa)。
3. 发布阶段:将打包好的安装包提交到各大应用市场。
4. 上线与后续阶段:审核通过后上架,并处理后续更新。
第一阶段:准备工作(至关重要!)
在打包之前,请务必准备好以下所有材料,否则流程会反复中断。
一、通用材料(iOS & Android 都需要)
1. 应用信息:
应用名称:全称和副标题。
应用描述:一段简短介绍和一段详细功能介绍。
关键词:用于应用商店搜索。
分类:如“工具”、“游戏”、“教育”等。
2. 视觉资产:
图标:1024x1024px 的透明背景 PNG 图标。各平台会自动生成不同尺寸。
截图:
iOS:需要 6.5 英寸(iPhone)和 12.9 英寸(iPad)的截图,通常为 1-5 张。
Android:需要多种尺寸的截图(通常和 iOS 类似)。
宣传图/Feature Graphic(Android 叫法):1024x500px 的横幅图。
3. 后台服务信息:
隐私政策链接:一个可公开访问的网址,详细说明您的应用如何收集和使用用户数据。这是审核的强制要求。
支持网址:通常是您的公司官网或帮助中心。
客服联系方式:邮箱、电话。
4. 测试账号:如果您的应用需要登录,必须提供一个供审核人员测试的账号(和密码),确保该账号有完整的功能权限。
二、iOS 特有准备(Apple Developer Program)
1. 苹果开发者账号:
类型:个人($99/年)、公司($99/年)、企业($299/年,仅供内部使用,不能上架 App Store)。上架 App Store 必须购买个人或公司账号。
申请:前往 [developer.apple.com](https://developer.apple.com/) 注册并付费。公司账号需要额外的邓白氏编码(D-U-N-S Number),申请约需 1-2 周。
2. 创建 App ID 和证书(可在 App Uploader 等工具辅助下完成):
App ID:应用的唯一标识符(例如 `com.yourcompany.yourapp`),必须与 UniApp 项目中 `manifest.json` 的 AppID 一致。
证书:
开发证书 (Development Certificate):用于真机调试。
发布证书 (Distribution Certificate):用于打包上传到 App Store。我们需要这个。
描述文件 (Provisioning Profile):
开发描述文件:关联设备、证书和 App ID,用于调试。
发布描述文件 (App Store Distribution Profile):关联发布证书和 App ID,用于上架。我们需要这个。
三、Android 特有准备
1. 应用签名证书 (Keystore):
这是一个包含私钥和公钥的二进制文件,用于对应用进行签名。它唯一标识了应用的作者,且一旦丢失将无法更新应用!
生成方式 :
HBuilderX 自动生成:简单但不安全,仅用于测试。
命令行手动生成(推荐):使用 JDK 的 `keytool` 命令。务必妥善保管备份 `.keystore` 文件和密码(别名、密钥库密码、别名密码)。
```bash
keytool -genkey -alias myalias -keyalg RSA -keysize 2048 -validity 36500 -keystore my.keystore
```
2. 各大安卓市场的开发者账号:
国内安卓市场碎片化严重,通常需要注册多个主流市场账号,如:
华为应用市场
小米应用商店
腾讯应用宝
OPPO 软件商店
vivo 应用商店
阿里应用商店(豌豆荚)
每个平台都需要单独注册、验证企业或开发者身份(通常需要营业执照等资质),过程可能需要几天时间。
第二阶段:打包阶段
一、iOS 打包 (.ipa 文件)
1. 生成发布证书和描述文件:
登录 [苹果开发者中心](https://developer.apple.com/account/)。
创建 App ID、生成 iOS Distribution (App Store) 证书(需上传 CSR 文件,该文件由 HBuilderX 或钥匙串访问生成)。
创建发布描述文件 (Provisioning Profile),选择 App Store类型,关联刚才创建的 App ID 和发布证书。
2. 在 HBuilderX 中配置和打包:
打开项目的 `manifest.json` 文件。
基础配置:确保应用名称、AppID(必须与苹果后台的 App ID 完全一致)、版本号等正确。
iOS 配置:在“App常用其它设置”中设置**应用使用权限的用途描述(如“需要相册权限用于上传头像”),这是隐私合规要求。
选择证书:点击菜单栏“发行” -> “原生App-云打包”。
勾选“iOS (App Store)”。
选择“使用苹果应用证书”。
上传第 1 步中生成的 `.p12` 证书文件并输入密码。
上传第 1 步中生成的 `.mobileprovision` 描述文件。
3. 云打包 :点击“打包”。HBuilderX 服务器会完成编译,完成后下载生成的 `.ipa` 文件。
二、Android 打包 (.apk 或 .aab 文件)
1. 在 HBuilderX 中配置:
打开 `manifest.json` 文件。
基础配置:设置应用名称、版本号、版本名称等。
Android 配置:设置包名(例如 `com.yourcompany.yourapp`)、设置权限说明。
2. 选择证书:
点击“发行” -> “原生App-云打包”。
勾选“Android”。
选择“使用自有证书”。
填写之前生成的 keystore 信息: keystore 文件路径、别名、以及两个密码。
3. 选择包类型:
APK:传统安装包,可用于直接安装或上传到部分市场。
AAB (Google Play App Bundle):Google 推荐格式。上传到 Google Play 后,商店会针对不同设备生成最优化的 APK。现在国内主流市场(如华为、小米、应用宝)也都推荐甚至强制要求上传 AAB 格式。
4. 云打包:点击“打包”,下载生成的 `.apk` 或 `.aab` 文件。
第三阶段:发布阶段(提交审核)
一、发布到 iOS App Store
1. 访问 App Store Connect:登录 [App Store Connect](https://appstoreconnect.apple.com/)。
2. 创建新 App:点击“我的 App” -> “+” -> “新建 App”,选择平台、填写名称、选择语言、输入 Bundle ID(即 App ID)、选择 SKU(自定义,用于后台识别)。
3. 填写应用信息:
价格与销售范围:设置价格和可上架的国家/地区。
App 信息:填写分类、隐私政策链接等。
版本信息:上传准备好的截图、图标、描述、关键词、宣传文本、技术支持网址等。
填写审核信息:提供测试账号和密码,以及必要的备注。
4. 构建版本:点击“构建版本”旁边的“+”号,然后需要使用 Transporter 或 Xcode 的 Application Loader 将打包好的 `.ipa` 文件上传到这里。上传成功后,这里会显示一个 “+” 号,你可以选择该构建版本。
5. 提交审核:所有信息填写无误后,点击“提交以供审核”。通常需要 1-7 个工作日。期间可能会收到“审核被拒”的通知,根据反馈邮件修改后重新提交即可。
二、发布到国内安卓市场
流程大同小异,但每个市场都需要单独操作一次。
1. 登录:登录到华为、小米等各大市场的开发者后台。
2. 创建新应用:点击“创建应用”或“提交新应用”。
3. 上传安装包:将打包好的 .aab(推荐)或 .apk 文件上传。
4. 填写信息:与应用商店类似,填写应用描述、截图、分类、关键词、隐私政策链接等。**每个市场的文案和截图要求可能略有不同**。
5. 资质审核:部分类别应用(如金融、新闻)需要提交额外的行业资质证明。
6. 提交审核:提交后,各市场团队会进行审核,通常需要 1-3 个工作日。同样可能被拒,需按反馈修改。
第四阶段:上线与后续
1. 审核通过:
IOS:在 App Store Connect 中,审核状态变为“可供销售”后,你需要手动点击“发布”按钮,应用会在 24 小时内出现在 App Store 中。
Android:各市场审核通过后,通常会自动上架,或者需要你在后台手动确认上架。
2. 应用更新:
当需要发布新版本时,流程几乎完全一样。
更新应用版本号**(在 `manifest.json` 中)。
使用相同的签名证书**(iOS 证书过期需重新生成,Android keystore 必须永远不变)重新打包。
将新包提交到各应用市场,走同样的审核流程。
总结与建议
步骤 | iOS (App Store) | Android (国内市场)
1. 账号 | 苹果开发者账号 ($99/年) | 各大市场开发者账号(免费)
2. 核心文件 | 发布证书、描述文件 | 签名 Keystore 文件 |
3. 包格式 | .ipa | .aab (主流) 或 .apk |
4. 提交平台 | App Store Connect | 各市场开发者后台 |
5. 审核 | 严格,通常 1-7 天 | 相对较快,通常 1-3 天 |
6. 关键提示 | 准备好测试账号和隐私政策 | 提前注册所有市场账号,妥善保管 keystore |
给开发者的最后建议:
提前准备:不要等开发完才去注册账号和准备材料,尤其是苹果开发者账号和企业资质认证,非常耗时。
仔细阅读指南:苹果和各大安卓市场都有详细的审核指南,提交前务必阅读,能避免很多不必要的拒审。
耐心:应用审核是一个需要耐心的过程,尤其是第一次上架,可能会遇到各种问题,保持沟通和修改。