xcodebuild 使用说明
2021-06-07 本文已影响0人
风云永杰
用法:
xcodebuild [-project <projectname>] [[-target <targetname>]...|-alltargets] [-configuration <configurationname>] [-arch <architecture>]... [-sdk [<sdkname>| <sdkpath>]] [-showBuildSettings [-json]] [<buildsetting>=<value>]... [<buildaction>]...
xcodebuild [-project <projectname>] -scheme <schemeName> [-destination <destinationspecifier>]... [-configuration <configurationname>] [-arch <architecture>]... [-sdk [<sdkname>|<sdkpath >]] [-showBuildSettings [-json]] [-showdestinations] [<buildsetting>=<value>]... [<buildaction>]...
xcodebuild -workspace <workspacename> -scheme <schemeName> [-destination <destinationspecifier>]... [-configuration <configurationname>] [-arch <architecture>]... [-sdk [<sdkname>|<sdkpath>] ] [-showBuildSettings] [-showdestinations] [<buildsetting>=<value>]... [<buildaction>]...
xcodebuild -version [-sdk [<sdkfullpath>|<sdkname>] [-json] [<infoitem>] ]
xcodebuild -list [[-project <项目名称>]|[-workspace <工作空间名称>]] [-json]
xcodebuild -showsdks [-json]
xcodebuild -exportArchive -archivePath <xcarchivepath> [-exportPath <destinationpath>] -exportOptionsPlist <plistpath>
xcodebuild -exportNotarizedApp -archivePath <xcarchivepath> -exportPath <destinationpath>
xcodebuild -exportLocalizations -localizationPath <path> -project <projectname> [-exportLanguage <targetlanguage>...[-includeScreenshots]]
xcodebuild -importLocalizations -localizationPath <path> -project <projectname> [-mergeImport]
xcodebuild -resolvePackageDependencies [-project <projectname>|-workspace <workspacename>] -clonedSourcePackagesDirPath <path>
xcodebuild -create-xcframework [-help] [-framework <path>] [-library <path> [-headers <path>]] -output <path>
选项:
-usage 打印简要用法
-help 打印完整的用法
-verbose 提供额外的状态输出
-license 显示 Xcode 和 SDK 许可协议
-checkFirstLaunchStatus 检查是否有任何首次启动任务需要执行
-runFirstLaunch 安装软件包并同意许可
-project NAME 构建项目名称
-target NAME 构建目标 NAME
-alltargets 构建所有目标
-workspace NAME 构建工作区名称
-scheme NAME 构建方案名称
-configuration NAME 使用构建配置 NAME 来构建每个目标
-xcconfig PATH 应用 PATH 文件中定义的构建设置作为覆盖
-arch ARCH 为架构 ARCH 构建每个目标;这将覆盖项目中定义的架构
-sdk SDK 在构建项目时使用 SDK 作为基础 SDK 的名称或路径
-toolchain NAME 使用带有标识符或名称 NAME 的工具链
-destination DESTINATIONSPECIFIER 使用 DESTINATIONSPECIFIER 描述的目的地(以逗号分隔的一组键=值对描述要使用的目的地)
-destination-timeout TIMEOUT 在搜索目标设备时等待 TIMEOUT 秒
-parallelizeTargets 并行构建独立目标
-jobs NUMBER 指定并发构建操作的最大数量
-maximum-concurrent-test-device-destinations NUMBER 要同时测试的最大设备目的地数
-maximum-concurrent-test-simulator-destinations NUMBER 要同时测试的模拟器目的地的最大数量
-parallel-testing-enabled YES|NO 覆盖方案中的每个目标设置
-parallel-testing-worker-count NUMBER 并行测试期间将产生的测试运行程序的确切数量
-maximum-parallel-testing-workers NUMBER 并行测试期间将产生的最大测试运行程序数量
-dry-run 执行除实际运行命令之外的所有操作
-quiet 除警告和错误外不打印任何输出
-hideShellScriptEnvironment 不在构建日志中显示 shell 脚本环境变量
-showsdks 显示已安装 SDK 的紧凑列表
-showdestinations 显示目的地列表
-showTestPlans 显示测试计划列表
-showBuildSettings 显示构建设置和值的列表
-showBuildSettingsForIndex 显示索引服务的构建设置
-list 列出项目中的目标和配置,或工作区中的方案
-find-executable NAME 在提供的 SDK 和工具链中显示可执行 NAME 的完整路径
-find-library NAME 在提供的 SDK 和工具链中显示库 NAME 的完整路径
-version 显示Xcode的版本;使用 -sdk 将显示有关一个或所有已安装 SDK 的信息
-enableAddressSanitizer YES|NO 打开或关闭地址清理器
-enableThreadSanitizer YES|NO 打开或关闭线程消毒器
-enableUndefinedBehaviorSanitizer YES|NO 打开或关闭未定义行为清理器
-resultBundlePath PATH 指定将放置描述所发生情况的结果包的目录
-resultStreamPath PATH 指定结果流将写入的文件(该文件必须已经存在)
-resultBundleVersion 3 [default] 指定应该使用哪个结果包版本
-clonedSourcePackagesDirPath PATH 指定获取远程源包或希望找到的目录
-derivedDataPath PATH 指定构建产品和其他派生数据所在的目录
-archivePath PATH 指定任何创建的档案将被放置的目录,或者应该导出的档案
-exportArchive 指定应导出存档
-exportNotarizedApp 导出已由 Apple 公证的档案
-exportOptionsPlist PATH 指定配置存档导出的 plist 文件的路径
-enableCodeCoverage YES|NO 在测试时打开或关闭代码覆盖率
-exportPath PATH 指定从存档导出的产品的目的地
-skipUnavailableActions 指定不能执行的方案动作应该被跳过而不是导致失败
-exportLocalizations 导出已完成和未完成的项目本地化
-importLocalizations 为项目导入本地化,假设任何必要的本地化资源已经在 Xcode 中创建
-localizationPath 指定 XLIFF 本地化文件的路径
-exportLanguage 指定本地化导出中包含的多种可选 ISO 639-1 语言
-xcroot 指定用于构建和/或测试的 .xcroot 的路径
-xctestrun 指定测试运行规范的路径
-testPlan 指定与用于测试的方案关联的测试计划的名称
-only-testing 通过指定要包含的测试和排除其他测试来限制测试
-only-testing:TEST-IDENTIFIER 通过指定要包含的测试并排除其他测试来限制测试
-skip-testing 通过指定要排除的测试来限制测试,但包括其他测试
-skip-testing:TEST-IDENTIFIER 通过指定要排除的测试来限制测试,但包括其他测试
-test-timeouts-enabled YES|NO 启用或禁用测试超时行为
-default-test-execution-time-allowance SECONDS 指定单个测试执行的默认执行时间,如果启用了测试超时
-maximum-test-execution-time-allowance SECONDS 单个测试执行的最大执行时间,无论测试的首选允许
-only-test-configuration 通过指定要包含的测试配置并排除其他测试配置来限制测试
-skip-test-configuration 通过指定要排除的测试配置来限制测试,但包括其他测试配置
-testLanguage 通过指定运行测试的 ISO 639-1 语言来限制测试
-testRegion 通过指定运行测试的 ISO 3166-1 区域来限制测试
-resolvePackageDependencies 解析项目或工作区引用的任何 Swift 包依赖项
-disableAutomaticPackageResolution 防止包自动解析为除“Package.resolved”文件中记录的版本以外的版本
-json 输出为 JSON(注意:-json 意味着 -quiet)
-allowProvisioningUpdates 允许 xcodebuild 与 Apple Developer 网站进行通信。对于自动签名的目标,xcodebuild 将创建和更新配置文件、应用程序 ID 和证书。对于手动签名的目标,xcodebuild 将下载丢失或更新的配置文件。需要在 Xcode 的“帐户”首选项窗格中添加开发人员帐户。
-allowProvisioningDeviceRegistration 如有必要,允许 xcodebuild 在开发人员门户上注册您的目标设备。此标志仅在 -allowProvisioningUpdates 也被传递时生效。
-scmProvider 用于 Git 操作的实现(系统/xcode)
-showBuildTimingSummary 显示构建期间调用的所有命令的时间报告
-create-xcframework 从预建库创建一个 xcframework; -帮助以获取更多信息。