在 macos 上用 xcode 命令行工具自动化导出 ios 测试包需执行清理→构建→归档→导出 ipa 四步，关键在于签名配置正确（证书导入钥匙串、描述文件安装、bundle id 与 team id 匹配），并使用 exportoptions.plist 指定导出方式。
在 macos 上用 xcode 命令行工具自动化导出 ios 测试包，核心是用 xcodebuild 完成「清理→构建→归档→导出 ipa」四步，全程无需打开 xcode 界面。关键在于签名配置正确、路径参数准确、环境已就绪。
确保签名环境就位
命令行打包成败几乎全取决于签名资源是否可用：
- 开发者证书必须已导入钥匙串（登录钥匙串），且状态为「已确认」；
- 对应证书的 Provisioning Profile（开发或 Ad Hoc 类型）需已下载并双击安装；
- 项目中 Bundle ID、Team ID 与证书/描述文件严格匹配（可在 Xcode 的 Signing & Capabilities 页核对）；
- 若使用自动管理签名，建议先在 Xcode 中成功手动 Archive 一次，让系统自动拉取并关联好配置。
执行四步命令流
进入项目根目录后，按顺序运行以下命令（以 .xcworkspace 为例，若为 .xcodeproj 则替换 -workspace 为 -project）：
-
清理：
xcodebuild clean -workspace MyApp.xcworkspace -scheme MyApp -configuration Release -
归档：
xcodebuild archive -workspace MyApp.xcworkspace -scheme MyApp -configuration Release -sdk iphoneos -archivePath ./build/MyApp.xcarchive -
导出 IPA：
xcodebuild -exportArchive -archivePath ./build/MyApp.xcarchive -exportPath ./build/ipa -exportOptionsPlist exportOptions.plist
其中 exportOptions.plist 是必需的配置文件，内容示例：
<?xml version="1.0" encoding="UTF-8"?><plist version="1.0"><dict><key>method</key><string>development</string><!-- 或 ad-hoc, enterprise --><key>teamID</key><string>YOUR_TEAM_ID</string><key>compileBitcode</key><false></false></dict></plist>
快速验证与常见问题
导出成功后，./build/ipa/MyApp.ipa 即可直接安装到已信任证书的设备上测试：
- 若报错
No signing certificate matching team ID：检查钥匙串中证书是否过期、是否被标记为“始终信任”； - 若提示
Provisioning profile doesn't match bundle identifier：确认 plist 中 bundle ID 与 Xcode 工程一致，且描述文件确已安装； - 导出 IPA 后无法安装：用
codesign -dv MyApp.ipa检查签名完整性，或用security find-identity -v -p codesigning查看可用证书列表； - 想跳过手动建 plist？可加
-exportFormat ipa并指定-exportMethod development（Xcode 14+ 支持，但推荐显式用 plist 更可控）。
封装为可复用脚本
把上述流程写成 shell 脚本，就能一键打包：
#!/bin/bash
PROJECT_NAME="MyApp"
WORKSPACE="${PROJECT_NAME}.xcworkspace"
SCHEME="${PROJECT_NAME}"
ARCHIVE_PATH="./build/${PROJECT_NAME}.xcarchive"
EXPORT_PATH="./build/ipa"
<p>xcodebuild clean -workspace "$WORKSPACE" -scheme "$SCHEME" -configuration Release
xcodebuild archive -workspace "$WORKSPACE" -scheme "$SCHEME" -configuration Release -sdk iphoneos -archivePath "$ARCHIVE_PATH"
xcodebuild -exportArchive -archivePath "$ARCHIVE_PATH" -exportPath "$EXPORT_PATH" -exportOptionsPlist exportOptions.plist</p>
赋予执行权限：chmod +x build.sh，运行 ./build.sh 即可。
