iOS 打包签名资料准备指南（HBuilderX / uni-app）

iOS 打包签名资料准备指南（HBuilderX / uni-app）

一、核心资料准备

界面字段	实际文件/信息	说明
Bundle ID (AppID)	应用唯一标识符	苹果开发者后台注册的 App ID，格式如：com.yourcompany.yourapp
证书私钥密码	导出 .p12 文件时设置的密码	从 Mac 钥匙串导出证书时自定义的密码
证书 profile 文件	描述文件 (.mobileprovision)	包含证书、App ID、设备列表的配置文件
私钥证书	证书文件 (.p12)	从钥匙串导出的个人证书（含公钥和私钥）

---

二、详细获取步骤

第一步：生成私钥证书 (.p12)

1. 生成 CSR 文件

   • 打开 Mac 钥匙串访问 → 证书助理 → 从证书颁发机构请求证书
   • 填写邮箱（建议与 Apple ID 一致）及通用名称（如 Zhang San Dev Cert）
   • 选择「存储到磁盘」，保存 .certSigningRequest 文件

2. 创建苹果证书

   • 登录 苹果开发者后台 → Certificates → 添加证书
   • 选择类型：
     • 开发阶段：iOS App Development
     • 发布阶段：App Store and Ad Hoc
   • 上传 CSR 文件 → 生成并下载 .cer 文件 → 双击安装到钥匙串

3. 导出 .p12 文件

   • 钥匙串中右键点击证书 → 导出为「个人信息交换 (.p12)」
   • 设置私钥密码（后续打包需用此密码）

---

第二步：注册 Bundle ID

1. 开发者后台 → Identifiers → 添加 App ID
2. 填写：
   • Description：应用描述（如「我的应用」）
   • Bundle ID：选择 Explicit，格式 com.yourcompany.yourapp（需与 HBuilderX 包名一致）
3. 按需勾选功能（如推送通知）→ 完成注册

---

第三步：添加测试设备 UDID（仅开发需要）

1. 开发者后台 → Devices → 添加设备
2. 输入设备名称与 UDID：
   • 获取 UDID：连接设备至 Mac → 访达中点击设备序列号区域 → 右键拷贝 UDID

---

第四步：创建描述文件 (.mobileprovision)

1. 开发者后台 → Profiles → 添加描述文件
2. 选择类型：
   • 开发基座：iOS App Development
   • 发布测试：Ad Hoc
   • App Store：App Store
3. 关联 App ID → 选择证书 → 勾选测试设备（开发/Ad Hoc 需选）
4. 命名建议（如 项目名_Development）→ 生成并下载文件

---

三、HBuilderX 签名配置

1. 打开「iOS 标准基座」签名界面
2. 填写：
   • Bundle ID ：注册的 App ID（如 com.yourcompany.yourapp）
   • 证书私钥密码：导出 .p12 时设置的密码
   • 证书 profile 文件 ：选择下载的 .mobileprovision 文件
   • 私钥证书 ：选择导出的 .p12 文件
3. 点击「开始签名」等待完成

---

四、常见问题与提示

开发证书 vs 发布证书

类型	用途	设备要求
开发证书	真机调试/开发基座	需包含测试设备 UDID
发布证书	App Store/生产基座	无需添加设备

协作与维护

• 团队协作 ：提供 .p12 文件（含密码）和 .mobileprovision 文件即可共享签名资料
• 证书有效期 ：苹果证书有效期为 1 年，到期需重新生成
• 设备上限 ：开发描述文件最多包含 100 台设备
• 命名规范 ：建议包含项目名和用途（如 项目名_Dev）避免混淆

提示：描述文件名称仅用于识别，不影响功能实现。