UniApp iOS 应用打包全流程:证书申请与云打包详解
本文详细指导如何使用 UniApp 完成 iOS 应用的打包发布,涵盖从苹果开发者账号准备、证书申请到最终使用 HBuilder 进行云打包的完整步骤。在开始之前,请确保您已拥有一个有效的苹果开发者账号和一台 Mac 电脑。
一、生成证书
准备工作
操作需要 Mac 电脑和苹果开发者账号。
1. 登录苹果开发者平台
首先访问苹果开发者平台登录页(appleid.apple.com/sign-in)进行登录,首次登录时可能需要验证码。
2. 生成开发证书
添加证书
- 登录后,进入证书管理页面,点击“证书”选项。
- 在证书列表界面,点击“Certificates”。
- 在“Software”栏下选择“iOS App Development”(即开发环境证书),然后点击“Continue”。
- 接下来页面会提示需要上传 CSR 文件。
生成 CSR 文件
此步骤需在 Mac 电脑上完成:
- 打开“钥匙串访问”应用。
- 依次选择:钥匙串访问 > 证书助理 > 从证书颁发机构请求证书。
- 在打开的页面中,输入用户邮件地址和常用名称,选择“存储到磁盘”,点击“继续”。
- 将文件保存为“CertificateSigningRequest.certSigningRequest”到本地指定路径。该文件将用于申请开发证书。
上传 CSR 文件
- 返回苹果开发者平台的上传页面,选择刚才生成的 CSR 文件进行上传。
- 上传后点击“Continue”,系统将生成开发证书。
- 证书生成后,选择“Download”将证书文件(通常名为 ios_development.cer)下载到本地。
导出 .p12 文件
- 在 Mac 的“钥匙串访问”中,选择“登录”分类下的“证书”。
- 右键点击已安装的证书,选择“导出”。
- 选择文件存储位置,并设置一个密码来保护导出的项目。此密码即为后续打包时需要的证书私钥密码。
- 确认后,即可获得 .p12 证书文件。至此,开发证书制作完成。
3. 添加调试设备
- 在苹果开发者平台的设备管理页面,点击“添加设备”。
- 平台选择“iOS, tvOS, watchOS”,填写设备名称(Device Name)和设备标识(Device ID,即 UDID)。
- UDID 可以通过专用工具(如访问指定二维码链接或使用爱思助手)快速获取。
- 点击“Continue”完成添加,新设备将显示在设备列表中。
4. 创建标识符(App ID)
- 在标识符管理页面,点击“添加”按钮。
- 勾选“App IDs”,点击“Continue”。
- 选择“App”,点击“Continue”。
- 在注册页面填写描述和 Bundle ID(格式如 com.example.app),这个 Bundle ID 在后续 HBuilder 打包时需要用到。
- 点击“Continue”完成创建,之后可以在标识符列表中看到新注册的 App ID。
5. 生成描述文件
重要提示:每次在设备列表中添加新设备的 UDID 后,都需要重新生成或更新描述文件,新的调试设备才能安装应用。
添加描述文件
- 在描述文件(Profiles)管理页面,点击加号新增。
- 选择类型:开发环境选择“Development”;正式包选择“Distribution”下的“App Store”(用于上架商店)或“Ad Hoc”(用于临时分发)。
- 在“App ID”选择框中选择之前创建的标识符,点击“Continue”。
- 选择需要绑定的发布证书(iOS Distribution),点击“Continue”。
- 勾选需要包含的调试设备,点击“Continue”。
- 输入描述文件名称,点击“Generate”生成。
下载描述文件
生成后可直接下载,文件格式为 .mobileprovision。也可以在描述文件列表页面下载此文件。
二、使用 HBuilder 打包 App
完成上述所有步骤后,您已获得打包所需的核心文件:发布证书(.p12 文件)和发布描述文件(.mobileprovision 文件)。接下来即可进行 UniApp 的云打包。
1. 启动云打包
打开 HBuilder,点击顶部菜单的“发行”,选择“云打包”。
2. 配置打包参数
在云打包界面中,准确填写以下信息:
- Bundle Id (AppID):填写之前创建的标识符(App ID)。
- 证书私钥密码:填写导出 .p12 证书时设置的密码。
- 证书 profile 文件:选择下载的 .mobileprovision 描述文件。
- 私钥证书:选择导出的 .p12 证书文件。
确认所有信息无误后,点击“打包”按钮,HBuilder 将开始云端编译和打包流程。等待打包完成即可获取 iOS 应用安装包。