文章目录
- 一、前言
- 二、xcodebuild 命令汇总
- 三、xcodebuild 可选命令
- 四、exportOptionsPlist文件内容配置说明
- 五、项目实操
- 六、拓展阅读
一、前言
关于iOS组包，详参博文《ReactNative进阶（三十四）：Jenkins 流水线 组包 iOS 应用包 ipa Archive 阶段报错error: Multiple commands produce问题修复及思考》
二、xcodebuild 命令汇总
查看xcodebuild简洁用法：
xcodebuild -usage
查看已安装的SDK：
xcodebuild -showsdks
查看项目中的Targets、Configurations和Schemes：
xcodebuild
-list
[[-project <projectname>]|[-workspace <workspacename>]]
清除编译过程生成文件：
xcodebuild clean
-workspace <xxx.workspace>
-scheme <schemeName>
-configuration <Debug|Release>
-sdk<sdkName>
编译命令：
xcodebuild build
-workspace <xxx.workspace>
-scheme <schemeName>
-configuration <Debug|Release>
-sdk<sdkName>
编译并生成.xcarchive包：
xcodebuild archive
-archivePath <archivePath> #生成的.xcarchive包存放路径
-workspace <XXX.xcworkspace>
-scheme <schemeNmae> #从-list命令中获取
-configuration <Debug|Release>
-sdk <sdkName> #sdkName可从showsdks命令中获取
将生成的.archive包导出成ipa文件：
xcodebuild -exportArchive
-archivePath <archivePath> #.archive文件的全路径 eg: .../.../XXX.xcarchive
-exportPath <exportPath> #ipa文件导出路径
-exportOptionsPlist <exportOptionsPlistPath> #exportOptionsPlist文件全路径 eg: .../.../XXX.plist，这个plist文件可以通过打一次ipa包里面去获取，然后根据需求修改
三、xcodebuild 可选命令
xcodebuild可选命令如下：
| 可选命令 | 命令说明 |
| -usage | 查看xcodebuild简洁的用法 |
| -help | 查看帮助 |
| -verbose | 提供额外的状态输出 |
| -license | 显示Xcode和SDK许可协议 |
| -checkFirstLaunchStatus | 检查是否有任何初启动任务需要执行 |
| -project NAME | 编译项目名称，例如:xcodebuild -project XXX.xcodeproj |
| -target NAME | 编译目标名称 |
| -targets | 编译全部目标 |
| -workspace NAME | 编译工作空间名称 |
| -scheme NAME | 编译计划名称 |
| -configuration NAME | 为构建每一个目标使用build配置名称 |
| -xcconfig PATH | 在PATH作为替代应用文件中定义的构建设置 |
| -arch ARCH | 建立每个目标的架构ARCH;这将覆盖在项目中定义的架构 |
| -sdk SDK | 使用指定的SDK编译项目 |
| -toolchain NAME | 使用工具链与标识或名称 |
| -destination DESTINATIONSPECIFIER | 使用由目标说明（用逗号分隔的一系列的key =描述目的地使用值对）中描述的目的地 |
| -destination-timeout TIMEOUT | 等待TIMEOUT秒，而搜索的目标设备 |
| -parallelizeTargets | 建立并行独立目标 |
| -jobs NUMBER | 指定并发生成操作的最大数量 |
| -dry-run | 做一切，除了实际运行的命令 |
| -hideShellScriptEnvironment | 不显示在构建日志shell脚本中的环境变量 |
| -showsdks | 显示已安装的SDK的列表 |
| -showBuildSettings | 显示构建设置和值的列表 |
| -list | 列出了在一个工作空间中的一个项目的目标和配置，或方案 |
| -find-executable NAME | 在所提供的SDK和工具链显示的完整路径可执行文件名称 |
| -find-library NAME | 在所提供的SDK和工具链显示的完整路径库名 |
| -version | 显示的Xcode的版本;与-sdk将显示一个或所有已安装的SDK信息 |
| -enableAddressSanitizer YES/NO | 测试时打开或关闭地址过滤 |
| -resultBundlePath PATH | 指定在描述什么发生了捆绑的结果将被放置的目录 |
| -derivedDataPath PATH | 指定的目录中生成产品和其他衍生数据会 |
| -archivePath PATH | 被指定任何创建的档案将被放置的目录，或应导出存档 |
| -exportArchive | 指定归档应导出 |
| -exportOptionsPlist PATH | 指定用于配置归档导出plist文件的路径 |
| -enableCodeCoverage YES/NO | 打开代码覆盖率或关闭时的测试 |
| -exportPath PATH | 指定从存档导出的产品的目标 |
| -skipUnavailableActions | 指定不能执行计划的行动应被跳过而不是导致失败 |
| -exportLocalizations | 出口完成优秀项目本地化 |
| -importLocalizations | 进口本地化项目，假设任何必要的本地化资源在Xcode中已创建 |
| -localizationPath | 指定XLIFF本地化文件路径 |
| -exportLanguage | 规定包括在本地化出口多个可选ISO 639-1语言 |
四、exportOptionsPlist文件内容配置说明
| Key | 类型 | value | 说明 |
| compileBitcode | Bool | For non-App Store exports, should Xcode re-compile the app from bitcode? Defaults to YES | 对于非App Store的出口，应重新编译Xcode中从bitcode应用程序？默认为YES |
| embedOnDemandResources AssetPacksInBundle | Bool | For non-App Store exports, if the app uses On Demand Resources and this is YES, asset packs are embedded in the app bundle so that the app can be tested without a server to host asset packs. Defaults to YES unless onDemandResourcesAssetPacksBaseURL is specified | 对于非App Store的出口，如果应用程序使用按需的资源，这是YES，资产包被嵌入在应用程序包，使应用程序可以在没有服务器托管资产包进行测试。默认为YES除非指定onDemandResourcesAssetPacksBaseURL |
| iCloudContainerEnvironment | For non-App Store exports, if the app is using CloudKit, this configures the "com.apple.developer.icloud-container-environment" entitlement. Available options: Development and Production. Defaults to Development | 对于非App Store的出口，如果应用程序使用CloudKit，这种配置“com.apple.developer.icloud容器环境”的权利。可用选项：开发和生产。默认为发展 | |
| manifest | Dictionary | For non-App Store exports, users can download your app over the web by opening your distribution manifest file in a web browser. To generate a distribution manifest, the value of this key should be a dictionary with three sub-keys: appURL, displayImageURL, fullSizeImageURL. The additional sub-key assetPackManifestURL is required when using on demand resources | 对于非App Store的出口，用户可以通过在Web浏览器中打开您的分发清单文件下载你的应用程序在网上。要生成分布明显，此键的值应该是有三个子键的字典：appURL，displayImageURL，fullSizeImageURL。额外的子键assetPackManifestURL是按需使用资源时，需要。 |
| method | String | Describes how Xcode should export the archive. Available options: app-store, ad-hoc, package, enterprise, development, and developer-id. The list of options varies based on the type of archive. Defaults to development | Xcode中描述如何导出存档。可用选项：应用程序商店，即席，包装，企业发展，开发人员ID。选项列表会有所不同根据存档的类型。默认为发展 |
| onDemandResourcesAssetP acksBaseURL | String | For non-App Store exports, if the app uses On Demand Resources and embedOnDemandResourcesAssetPacksInBundle isn't YES, this should be a base URL specifying where asset packs are going to be hosted. This configures the app to download asset packs from the specified URL | 对于非App Store的出口，如果应用程序使用按需资源embedOnDemandResourcesAssetPacksInBundle不是YES，这应该是一个基本URL指定，其中资产包将要举行。该配置应用从指定的URL下载资产包 |
| teamID | String | The Developer Portal team to use for this export. Defaults to the team used to build the archive | 开发者门户网站团队使用这个出口。默认为球队用来建立档案 |
| thinning | String | For non-App Store exports, should Xcode thin the package for one or more device variants? Available options: <none> (Xcode produces a non-thinned universal app), <thin-for-all-variants> (Xcode produces a universal app and all available thinned variants), or a model identifier for a specific device (e.g. "iPhone7,1"). Defaults to <none> | 对于非App Store的出口，Xcode中应该薄包一个或多个设备的变种？可用选项：<无>（Xcode中产生的非变薄普遍的应用程序），<薄参加的所有变体>（Xcode中产生一个通用的应用程序以及所有可用的变薄变型），或针对特定设备型号标识（例如“ iPhone7,1“）。默认为<无> |
| uploadBitcode | Bool | For App Store exports, should the package include bitcode? Defaults to YES | 对于App Store的导出，应包包括bitcode？默认为YES |
| uploadSymbols | Bool | For App Store exports, should the package include symbols? Defaults to YES | 对于App Store的出口，应包包含符号？默认为YES |
exportOptionsPlist文件示例如下：
<?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>compileBitcode</key><false/><key>method</key><string>development</string><key>provisioningProfiles</key><dict><key>com.669.yanyou</key><string>yanyou_dev</string></dict><key>signingCertificate</key><string>F13EE282147D6ED2CD5ACEEF20476B39C87AEAAC</string><key>signingStyle</key><string>manual</string><key>stripSwiftSymbols</key><true/><key>teamID</key><string>HW9U4B8YY9</string><key>thinning</key><string><none></string>
</dict>
</plist>
五、项目实操
cd ios_sec# 打包生成 xcarchive 文件
xcodebuild archive -workspace test.xcworkspace -scheme test -configuration Release -archivePath bin/test.xcarchive# 根据 xcarchive 文件进行签名
xcodebuild -exportArchive -archivePath bin/test.xcarchive -exportOptionsPlist test/package.plist -exportPath ../production/iOS
六、拓展阅读
- 《ReactNative进阶（三十四）：Jenkins 流水线 组包 iOS 应用包 ipa Archive 阶段报错error: Multiple commands produce问题修复及思考》
