asc-xcode-build 是做什么的？
使用当前的 asc xcode 助手，在 App Store Connect 上传或提交之前构建、归档、导出、上传并管理 Xcode 版本/构建号。用于创建用于上传的 IPA 或 PKG 文件。
功能
- 使用
xcodebuild构建和归档 Xcode 项目或工作区 - 导出归档文件为 IPA 或 PKG
- 使用
xcrun altool上传到 App Store Connect - 在构建前自动更新 Info.plist 中的版本号和构建号
要求
- 已安装 Xcode 和命令行工具
- 有效的 Apple 开发者账户和 App Store Connect API 密钥或 Apple ID
- 项目或工作区已正确为归档配置好证书和描述文件
用法
# 查看帮助
asc xcode-build --help
# 构建并归档项目
asc xcode-build --project MyProject.xcodeproj --scheme MyScheme
# 构建并归档工作区
asc xcode-build --workspace MyWorkspace.xcworkspace --scheme MyScheme
# 指定输出目录
asc xcode-build --project MyProject.xcodeproj --scheme MyScheme --output-dir ./Build
# 更新版本号和构建号
asc xcode-build --project MyProject.xcodeproj --scheme MyScheme --version 1.0.1 --build-number 42
# 导出为 IPA 并上传
asc xcode-build --project MyProject.xcodeproj --scheme MyScheme --upload
配置
| 环境变量 | 描述 | 必填 |
|---|---|---|
APP_STORE_CONNECT_USERNAME | App Store Connect 用户名（Apple ID） | 是（如果使用 Apple ID） |
APP_STORE_CONNECT_PASSWORD | App Store Connect 密码或应用专用密码 | 是（如果使用 Apple ID） |
APP_STORE_CONNECT_API_KEY | API 密钥 ID | 是（如果使用 API 密钥） |
APP_STORE_CONNECT_API_ISSUER_ID | API 签发者 ID | 是（如果使用 API 密钥） |
APP_STORE_CONNECT_API_KEY_FILE | API 密钥文件路径 | 是（如果使用 API 密钥） |
示例
1. 构建并归档
asc xcode-build --project MyApp.xcodeproj --scheme MyApp --output-dir ./Archive
2. 构建、归档并上传
asc xcode-build --workspace MyApp.xcworkspace --scheme MyApp --upload
3. 更新版本号并构建
asc xcode-build --project MyApp.xcodeproj --scheme MyApp --version 2.0.0 --build-number 100
常见问题
- 构建失败：检查 Xcode 项目配置、证书和描述文件。运行
xcodebuild -list验证可用的 scheme。 - 上传失败：确保 App Store Connect 凭据或 API 密钥配置正确。检查网络连接和权限。
- 版本号更新失败：确保 Info.plist 包含正确的
CFBundleShortVersionString和CFBundleVersion键。
许可证
MIT