iOS 打包 - 打包 IPA

打包 IPA

在配置好证书和描述文件后，我们可以开始打包 iOS 应用为 IPA 文件。IPA（iOS App Store Package）是 iOS 应用的发布格式。

步骤1：准备发布构建

1. 更新应用版本：

   • 在 Xcode 中，选择项目根节点
   • 选择 "General" 标签
   • 更新 "Version"（版本号）和 "Build"（构建号）
   • 确保每次发布都增加版本号

2. 配置发布设置：

   • 选择 "Product" → "Scheme" → "Edit Scheme"
   • 选择 "Run" → "Build Configuration" → "Release"
   • 点击 "Close"

3. 检查应用权限：

   • 确保在 Info.plist 中添加了所有必要的权限描述
   • 例如：相机、位置、通知等权限

4. 清理构建缓存：

   • 选择 "Product" → "Clean Build Folder"
   • 或使用快捷键 Shift + Command + K

步骤2：构建应用

1. 选择设备：

   • 在 Xcode 顶部的设备选择器中，选择 "Any iOS Device (arm64)"

2. 构建应用：

   • 选择 "Product" → "Build"
   • 或使用快捷键 Command + B
   • 确保构建成功，没有错误

步骤3：导出 IPA

1. 导出归档文件：

   • 选择 "Product" → "Archive"
   • 等待归档完成
   • 归档完成后，会自动打开 "Organizer" 窗口

2. 导出 IPA：

   • 在 "Organizer" 窗口中，选择刚创建的归档
   • 点击 "Distribute App"
   • 选择 "App Store Connect"
   • 点击 "Next"
   • 选择 "Upload" 或 "Export"
     • Upload：直接上传到 App Store Connect
     • Export：导出 IPA 文件到本地
   • 点击 "Next"

3. 配置导出选项：

   • 选择 "Development" 或 "Production"
   • 选择 "Include bitcode"（推荐）
   • 选择 "Upload your app's symbols to receive symbolicated crash logs from Apple"（推荐）
   • 点击 "Next"

4. 选择证书：

   • 选择正确的发布证书
   • 点击 "Next"

5. 导出 IPA：

   • 选择保存位置
   • 点击 "Export"
   • 等待导出完成

步骤4：验证 IPA

1. 检查 IPA 文件：

   • 确认 IPA 文件已成功导出
   • 检查文件大小是否合理

2. 验证 IPA 签名：

   • 使用 codesign 工具验证签名：

     codesign -d --entitlements :- path/to/your/app.ipa

3. 检查应用信息：

   • 使用 otool 工具检查应用信息：

     otool -l path/to/your/app/executable

步骤5：自动化构建（可选）

对于持续集成/持续部署（CI/CD），可以使用以下命令：

1. 清理构建：

   xcodebuild -workspace YourProject.xcworkspace -scheme YourScheme clean

2. 构建归档：

   xcodebuild -workspace YourProject.xcworkspace -scheme YourScheme -configuration Release -sdk iphoneos -archivePath ./build/YourProject.xcarchive archive

3. 导出 IPA：

   xcodebuild -exportArchive -archivePath ./build/YourProject.xcarchive -exportOptionsPlist ExportOptions.plist -exportPath ./build

4. 创建 ExportOptions.plist：

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
       <key>method</key>
       <string>app-store</string>
       <key>teamID</key>
       <string>YOUR_TEAM_ID</string>
       <key>uploadBitcode</key>
       <true/>
       <key>uploadSymbols</key>
       <true/>
   </dict>
   </plist>

注意事项

1. 构建配置：

   • 确保使用 "Release" 配置进行构建
   • 禁用调试信息，提高应用性能

2. 代码签名：

   • 确保使用正确的发布证书
   • 确保描述文件有效

3. 应用大小：

   • 优化应用大小，移除不必要的资源
   • 使用 App Thinning 减少应用体积

4. Bitcode：

   • 启用 Bitcode 可以让 Apple 优化应用
   • 但会增加构建时间和应用大小

5. 符号文件：

   • 上传符号文件可以获取更详细的崩溃日志
   • 有助于调试应用问题

常见问题

1. 构建失败：

   • 检查代码是否有错误
   • 检查证书和描述文件是否有效
   • 检查依赖是否正确

2. 签名错误：

   • 检查证书是否过期
   • 检查描述文件是否与 App ID 匹配
   • 重启 Xcode 后重试

3. 导出失败：

   • 检查网络连接
   • 检查 Apple Developer Account 状态
   • 检查应用是否符合 App Store guidelines

4. IPA 安装失败：

   • 检查设备是否已注册
   • 检查 IPA 是否与设备兼容
   • 检查签名是否正确

5. 应用崩溃：

   • 检查是否有未处理的异常
   • 检查权限是否正确设置
   • 检查依赖版本是否兼容

总结

打包 IPA 是 iOS 应用发布的关键步骤。通过正确配置构建选项，确保签名正确，并验证 IPA 文件，可以生成高质量的应用包，为用户提供良好的体验。

建议使用 Xcode 的归档功能导出 IPA，它会自动处理许多复杂的步骤，减少出错的可能性。