iOS 打包 - Xcode 配置证书

Xcode 配置证书

在将 React Native 应用发布到 App Store 之前，我们需要在 Xcode 中配置证书和描述文件。这些是 iOS 应用签名和发布的必要条件。

步骤1：准备 Apple Developer Account

1. 注册 Apple Developer Account：

   • 访问 Apple Developer 网站
   • 注册开发者账号（个人或企业）
   • 支付年度开发者费用

2. 登录 Apple Developer Portal：

   • 访问 Apple Developer Portal
   • 使用您的 Apple ID 登录

步骤2：创建证书

1. 创建开发证书（用于开发和测试）：

   • 进入 "Certificates, Identifiers & Profiles"
   • 点击 "Certificates" → "+"
   • 选择 "iOS App Development"
   • 按照提示生成 CSR（Certificate Signing Request）
   • 上传 CSR 文件
   • 下载并安装证书

2. 创建发布证书（用于发布到 App Store）：

   • 进入 "Certificates, Identifiers & Profiles"
   • 点击 "Certificates" → "+"
   • 选择 "App Store and Ad Hoc"
   • 按照提示生成 CSR
   • 上传 CSR 文件
   • 下载并安装证书

步骤3：创建 App ID

1. 创建 App ID：
   • 进入 "Certificates, Identifiers & Profiles"
   • 点击 "Identifiers" → "App IDs" → "+"
   • 填写 "Name"（应用名称）
   • 选择 "Explicit App ID"
   • 填写 "Bundle ID"（必须与 Xcode 中的 Bundle Identifier 一致）
   • 选择需要的 Capabilities（如 Push Notifications、iCloud 等）
   • 点击 "Continue" → "Register"

步骤4：创建描述文件

1. 创建开发描述文件：

   • 进入 "Certificates, Identifiers & Profiles"
   • 点击 "Provisioning Profiles" → "+"
   • 选择 "iOS App Development"
   • 选择您的 App ID
   • 选择开发证书
   • 选择测试设备
   • 填写描述文件名称
   • 下载并安装描述文件

2. 创建发布描述文件：

   • 进入 "Certificates, Identifiers & Profiles"
   • 点击 "Provisioning Profiles" → "+"
   • 选择 "App Store"
   • 选择您的 App ID
   • 选择发布证书
   • 填写描述文件名称
   • 下载并安装描述文件

步骤5：配置 Xcode 项目

1. 打开 Xcode 项目：

   • 导航到 your-project-directory/ios
   • 双击 your-project-name.xcworkspace 文件

2. 配置项目设置：

   • 选择项目根节点
   • 选择 "General" 标签
   • 确保 "Bundle Identifier" 与 App ID 一致
   • 设置 "Version" 和 "Build" 号
   • 配置 "Signing & Capabilities"：
     • 选择 "Automatically manage signing"
     • 选择您的 Team
     • Xcode 会自动选择合适的证书和描述文件

3. 配置目标设置：

   • 选择 "Targets" → "your-project-name"
   • 选择 "General" 标签
   • 确保 "Bundle Identifier" 与 App ID 一致
   • 配置 "Signing & Capabilities"：
     • 选择 "Automatically manage signing"
     • 选择您的 Team

步骤6：验证配置

1. 构建项目：

   • 选择 "Product" → "Build"
   • 检查是否有签名错误

2. 运行项目：

   • 选择 "Product" → "Run"
   • 检查应用是否能在模拟器或真机上运行

步骤7：手动配置（可选）

如果自动管理签名出现问题，可以手动配置：

1. 禁用自动管理签名：

   • 在 "Signing & Capabilities" 中取消选择 "Automatically manage signing"

2. 手动选择证书和描述文件：

   • 选择 "Development Team"
   • 选择 "Provisioning Profile"
   • 选择 "Signing Certificate"

注意事项

1. 证书有效期：

   • 开发证书有效期为 1 年
   • 发布证书有效期为 3 年
   • 确保在证书过期前更新

2. 描述文件有效期：

   • 描述文件有效期与证书一致
   • 当证书更新时，需要重新生成描述文件

3. 设备管理：

   • 开发描述文件只能用于指定的测试设备
   • 最多可以添加 100 台测试设备

4. 团队管理：

   • 如果是团队开发，确保所有团队成员都有正确的权限
   • 可以在 Apple Developer Portal 中管理团队成员

5. 密钥链访问：

   • 证书存储在 macOS 的密钥链中
   • 确保密钥链访问权限正确

常见问题

1. 证书安装失败：

   • 检查证书文件是否完整
   • 确保使用正确的 Apple ID 登录
   • 重启 Xcode 后重试

2. 描述文件不匹配：

   • 确保描述文件与 App ID 匹配
   • 确保描述文件包含正确的证书
   • 重新生成描述文件

3. 签名错误：

   • 检查 Bundle Identifier 是否与 App ID 一致
   • 检查证书是否过期
   • 检查描述文件是否有效

4. 设备未注册：

   • 在 Apple Developer Portal 中添加设备 UDID
   • 重新生成开发描述文件

5. Team 选择错误：

   • 确保选择了正确的开发团队
   • 检查团队成员权限

总结

配置 Xcode 证书和描述文件是 iOS 应用发布的必要步骤。通过正确创建和配置证书、App ID 和描述文件，可以确保应用能够成功签名和发布到 App Store。

建议使用 Xcode 的自动管理签名功能，它会自动处理证书和描述文件的管理，减少手动配置的错误。