4.1 KiB
4.1 KiB
iOS 自动化构建指南
本指南将帮助您使用自动化脚本构建和签名 iOS 应用，并创建 DMG 安装包。
🎯 目标
创建经过签名的 iOS 应用 DMG 文件，用于分发和安装。
📋 前提条件
1. Apple Developer 账户
- 需要有效的 Apple Developer 账户
- 需要 iOS Development 证书
- 需要 Provisioning Profile
2. 获取证书和配置文件
- 登录 Apple Developer Portal
- 进入 "Certificates, Identifiers & Profiles"
- 创建以下证书：
- iOS Development (用于应用签名)
- 创建 App ID 和 Provisioning Profile
- 下载并安装证书和配置文件
🚀 快速开始
步骤 1: 配置签名信息
# 运行配置脚本
./update_team_id.sh
按照提示输入您的 Team ID，脚本会自动更新配置文件。
步骤 2: 加载配置
# 加载签名配置
source ios_signing_config.sh
步骤 3: 构建 DMG
# 构建发布版本
./build_ios_dmg.sh
# 或构建调试版本
./build_ios_dmg.sh debug
📁 输出文件
构建完成后，文件将位于：
build/ios/
├── BearVPN-1.0.0.ipa # 签名的 IPA 文件
└── BearVPN-1.0.0-iOS.dmg # DMG 安装包
🛠️ 可用的构建脚本
1. build_ios_dmg.sh - 主要构建脚本
- 构建签名的 iOS 应用
- 创建 DMG 安装包
- 支持调试和发布版本
./build_ios_dmg.sh [debug|release]
2. build_ios_simple.sh - 简化构建脚本
- 构建未签名的版本
- 仅用于测试和开发
./build_ios_simple.sh [debug|release]
3. build_ios_appstore.sh - App Store 构建脚本
- 构建用于 App Store 分发的版本
- 支持自动上传到 App Store Connect
./build_ios_appstore.sh [upload|build]
🔧 配置文件
ios_signing_config.sh
包含所有签名配置信息：
# Apple Developer 账户信息
export APPLE_ID="your-apple-id@example.com"
export APPLE_PASSWORD="your-app-password"
export TEAM_ID="YOUR_TEAM_ID"
# 应用信息
export APP_NAME="BearVPN"
export BUNDLE_ID="com.bearvpn.app"
export VERSION="1.0.0"
export BUILD_NUMBER="1"
# 签名身份
export SIGNING_IDENTITY="iPhone Developer: Your Name (YOUR_TEAM_ID)"
export DISTRIBUTION_IDENTITY="iPhone Distribution: Your Name (YOUR_TEAM_ID)"
🔍 验证构建结果
构建完成后，您可以验证结果：
# 验证 IPA 文件
unzip -l build/ios/BearVPN-1.0.0.ipa
# 验证 DMG 文件
hdiutil verify build/ios/BearVPN-1.0.0-iOS.dmg
# 查看 DMG 内容
hdiutil mount build/ios/BearVPN-1.0.0-iOS.dmg
🛠️ 故障排除
1. 证书问题
# 查看可用证书
security find-identity -v -p codesigning
# 如果看到 "0 valid identities found"，说明没有安装证书
2. 配置文件问题
- 确保 Provisioning Profile 已正确安装
- 检查 Bundle ID 是否匹配
- 确保证书和配置文件匹配
3. 构建失败
- 检查 Xcode 是否正确安装
- 确保 Flutter 环境正确配置
- 查看构建日志中的具体错误信息
4. 签名失败
- 确保证书已正确安装
- 检查签名身份名称是否正确
- 确保证书未过期
📚 相关文档
⚠️ 重要提醒
- 安全性：请妥善保管您的开发者证书和密码
- 测试：在分发前，请在真实的 iOS 设备上测试
- 更新：定期更新证书，避免过期
- 备份：建议备份您的签名配置
🎉 成功标志
如果构建成功，您应该看到：
- ✅ 应用构建成功
- ✅ 应用签名成功
- ✅ IPA 文件创建成功
- ✅ DMG 文件创建成功
- ✅ 最终验证通过
📞 支持
如果遇到问题，请检查：
- 构建日志中的错误信息
- 证书和配置文件是否正确安装
- 网络连接是否正常
- Xcode 和 Flutter 版本是否兼容