Xcode@5 - Xcode v5 任务

使用此任务在 macOS 上生成、测试或存档 Xcode 工作区，并选择性地打包应用。

语法

# Xcode v5
# Build, test, or archive an Xcode workspace on macOS. Optionally package an app.
- task: Xcode@5
  inputs:
    actions: 'build' # string. Required. Actions. Default: build.
    #configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
    #sdk: '$(SDK)' # string. SDK. Default: $(SDK).
    #xcWorkspacePath: '**/*.xcodeproj/project.xcworkspace' # string. Workspace or project path. Default: **/*.xcodeproj/project.xcworkspace.
    #scheme: # string. Scheme. 
    #xcodeVersion: 'default' # '8' | '9' | '10' | '11' | '12' | '13' | 'default' | 'specifyPath'. Xcode version. Default: default.
    #xcodeDeveloperDir: # string. Optional. Use when xcodeVersion == specifyPath. Xcode developer path. 
  # Package options
    #packageApp: false # boolean. Create app package. Default: false.
    #archivePath: # string. Optional. Use when packageApp == true. Archive path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageApp == true. Export path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageApp == true. Export options. Default: auto.
    #exportMethod: 'development' # string. Required when exportOptions == specify. Export method. Default: development.
    #exportTeamId: # string. Optional. Use when exportOptions == specify. Team ID. 
    #exportOptionsPlist: # string. Required when exportOptions == plist. Export options plist. 
    #exportArgs: # string. Optional. Use when packageApp == true. Export arguments. 
  # Signing & provisioning
    #signingOption: 'nosign' # 'nosign' | 'default' | 'manual' | 'auto'. Signing style. Default: nosign.
    #signingIdentity: # string. Optional. Use when signingOption = manual. Signing identity. 
    #provisioningProfileUuid: # string. Optional. Use when signingOption = manual. Provisioning profile UUID. 
    #provisioningProfileName: # string. Optional. Use when signingOption = manual. Provisioning profile name. 
    #teamId: # string. Optional. Use when signingOption = auto. Team ID. 
  # Devices & simulators
    #destinationPlatformOption: 'default' # 'default' | 'iOS' | 'tvOS' | 'macOS' | 'custom'. Destination platform. Default: default.
    #destinationPlatform: # string. Optional. Use when destinationPlatformOption == custom. Custom destination platform. 
    #destinationTypeOption: 'simulators' # 'simulators' | 'devices'. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS. Destination type. Default: simulators.
    #destinationSimulators: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Simulator. 
    #destinationDevices: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices. Device. 
  # Advanced
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #useXcpretty: true # boolean. Use xcpretty. Default: true.
    #xcprettyArgs: # string. Optional. Use when useXcpretty == true. Xcpretty arguments. 
    #publishJUnitResults: false # boolean. Publish test results to Azure Pipelines. Default: false.
    #testRunTitle: # string. Optional. Use when publishJUnitResults == true. Test run title.

输入

actions - 行动
string. 必需。 默认值：build。

指定以空格分隔的操作列表。 一些有效选项包括 build、 clean、 test、 analyze和 archive。 例如，clean build 执行干净生成。 请参阅 Apple：使用 Xcode 常见问题解答从命令行生成。

configuration - 配置
string. 默认值：$(Configuration)。

指定要生成的 Xcode 项目或工作区配置。 使用变量时， (指定一个值，例如， Release 在“ 变量 ”选项卡上) 。

sdk - Sdk
string. 默认值：$(SDK)。

指定生成 Xcode 项目或工作区时要使用的 SDK。 在 macOS 终端应用程序中，运行 xcodebuild -showsdks 以显示有效的 SDK 列表。 使用变量时， (指定一个值，例如， iphonesimulator 在“ 变量 ”选项卡上) 。

xcWorkspacePath - 工作区或项目路径
string. 默认值：**/*.xcodeproj/project.xcworkspace。

可选。 指定从存储库根目录到 Xcode 工作区或项目的相对路径。 例如，MyApp/MyApp.xcworkspace 或 MyApp/MyApp.xcodeproj。 可以使用通配符。 详细了解 文件匹配模式。

scheme - 方案
string.

可选。 指定 Xcode 方案名称。 必须是 Xcode) 中 托管方案 下的共享方案 (共享复选框。 如果未指定方案，并且指定的工作区具有单个共享方案，则将使用工作区方案。

xcodeVersion - Xcode 版本
string. 允许的值： 8 (Xcode 8) 、 9 (Xcode 9) 、 10 (Xcode 10) 、 11 (Xcode 11) 、 12 (Xcode 12) 、 13 (Xcode 13) 、 default (specifyPath 指定路径) 。 默认值：default。

指定 Xcode 的目标版本。 选择 Default 以在代理计算机上使用 Xcode 的默认版本。 例如， (指定版本号) Xcode 9 依赖于由代理计算机上的环境变量设置的版本位置， (例如 XCODE_9_DEVELOPER_DIR=/Applications/Xcode_9.0.0.app/Contents/Developer ，) 。 选择 Specify path 可提供 Xcode 开发人员目录的特定路径。

xcodeDeveloperDir - Xcode 开发人员路径
string. 可选。 在 时 xcodeVersion == specifyPath使用 。

指定特定 Xcode 开发人员目录 (的路径， /Applications/Xcode_9.0.0.app/Contents/Developer 例如) 。 在代理计算机上安装多个版本的 Xcode 时，此输入非常有用。

packageApp - 创建应用包
boolean. 默认值：false。

指定是否在生成过程中生成 IPA 应用包文件。

archivePath - 存档路径
string. 可选。 在 时 packageApp == true使用 。

指定在其中放置已创建存档的目录。

exportPath - 导出路径
string. 可选。 在 时 packageApp == true使用 。 默认值：output/$(SDK)/$(Configuration)。

指定从存档导出的产品的目标。

exportOptions - 导出选项
string. 可选。 在 时 packageApp == true使用 。 允许的值： auto (自动) 、 plist、 specify。 默认值：auto。

指定用于导出存档的选项。 选择 的默认值 Automatic 后，会自动从存档中检测到导出方法。 选择此选项 Plist 可指定包含导出选项的 plist 文件。 选择 Specify 可提供特定的导出方法和团队 ID。

exportMethod - Export 方法
string. 当 exportOptions == specify 时，需要此选项。 默认值：development。

指定 Xcode 用于导出存档的方法。 例如：app-store、package、ad-hoc、enterprise 或 development。

exportTeamId - 团队 ID
string. 可选。 在 时 exportOptions == specify使用 。

指定在导出过程中要使用的 Apple 开发人员门户 10 个字符的团队 ID。

exportOptionsPlist - 导出选项 plist
string. 当 exportOptions == plist 时，需要此选项。

指定 plist 文件的路径，其中包含导出期间要使用的选项。

exportArgs - 导出参数
string. 可选。 在 时 packageApp == true使用 。

指定导出期间使用的其他命令行参数。

signingOption - 签名样式
string. 允许的值： nosign (不对) 进行代码签名、 default (Project 默认值) 、 manual (手动签名) (auto 自动签名) 。 默认值：nosign。

指定对生成进行签名的方法。 选择 Do not code sign 禁用签名。 选择 Project defaults 以仅使用项目的签名配置。 选择此选项 Manual signing 可强制手动签名，并选择性地指定签名标识和预配配置文件。 选择此选项 Automatic signing 可强制自动签名，并选择性地指定开发团队 ID。 如果项目需要签名，请在 Xcode 生成之前使用 安装 Apple... 任务来安装证书和预配配置文件。

signingIdentity - 签名标识
string. 可选。 在 时 signingOption = manual使用 。

指定用于对生成进行签名的签名标识替代。 可能需要解锁代理计算机上的默认密钥链。 如果未输入任何值，则使用 Xcode 项目的 设置。

provisioningProfileUuid - 预配配置文件 UUID
string. 可选。 在 时 signingOption = manual使用 。

指定用于生成的已安装预配配置文件的 UUID。 使用具有不同方案或目标的单独生成任务，在单个工作区中按目标指定预配配置文件， (iOS、tvOS、watchOS) 。

provisioningProfileName - 预配配置文件名称
string. 可选。 在 时 signingOption = manual使用 。

指定用于生成的已安装预配配置文件的名称。 如果指定，则它优先于预配配置文件 UUID。 使用具有不同方案或目标的单独生成任务，在单个工作区中按目标指定预配配置文件， (iOS、tvOS、watchOS) 。

teamId - 团队 ID
string. 可选。 在 时 signingOption = auto使用 。

如果你是多个开发团队的成员，则是必需的。 指定 10 个字符的开发团队 ID。

destinationPlatformOption - 目标平台
string. 允许的值： default、 iOS (iOS 和 watchOS) 、 tvOS、 macOS、 custom。 默认值：default。

指定在通用生成设备无效时用于 UI 测试的目标设备平台。 选择 Custom 指定此列表中未包含的平台。 选择 时 Default ，不会以模拟器或设备为目标。

destinationPlatform - 自定义目标平台
string. 可选。 在 时 destinationPlatformOption == custom使用 。

指定在通用生成设备无效时用于 UI 测试的目标设备的平台。 选择 Custom 指定未包含在列表中的平台。 选择 时 Default ，不会以模拟器和设备为目标。

destinationTypeOption - 目标类型
string. 可选。 在 时 destinationPlatformOption != default && destinationPlatformOption != macOS使用 。 允许的值： simulators (模拟器) 、 devices (连接的设备) 。 默认值：simulators。

指定用于 UI 测试的目标类型。 设备必须通过电缆或网络连接连接到执行生成的 Mac。 有关详细信息，请参阅 Xcode 中的 设备和模拟器 。

destinationSimulators - 模拟
string. 可选。 在 时 destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators使用 。

指定用于 UI 测试的 Xcode 模拟器名称。 例如， iPhone X (iOS 和 watchOS) 或 Apple TV 4K (tvOS) 。 可以使用 格式 OS=<versionNumber>指定可选的目标 OS 版本，例如 iPhone X,OS=11.1。 有关详细信息 ，请参阅 此安装在托管 macOS 代理上的模拟器列表 。

destinationDevices - 装置
string. 可选。 在 时 destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices使用 。

指定用于 UI 测试的设备的名称，例如 Raisa's iPad。 目前仅支持一台设备。 请注意，Apple 不允许在设备名称中使用撇号 (') 。 相反，可以使用右单引号 (') 。

args - 参数
string.

可选。 指定要用来生成的其他命令行参数。 此输入可用于指定 -target 或 -project 参数，而不是工作区/项目和方案。 请参阅 Apple：使用 Xcode 常见问题解答从命令行生成。

workingDirectory - 工作目录
输入别名： cwd。 string.

可选。 指定要在其中运行生成的工作目录。 如果未输入任何值，则使用存储库的根目录。

useXcpretty - 使用 xcpretty
boolean. 默认值：true。

指定是否使用 xcpretty 设置输出格式 xcodebuild 。 xcpretty 必须安装在代理计算机上， (它预安装在 Azure Pipelines 托管的生成代理) 上。 如果未 xcpretty 安装 ，则显示原始 xcodebuild 输出。 有关详细信息 ，请参阅 xcpretty 。

xcprettyArgs - Xcpretty 参数
string. 可选。 在 时 useXcpretty == true使用 。

如果 xcpretty 启用 ，则此输入指定 的参数 xcpretty。 请参阅 GitHub 上的 xcpretty 参数列表。

publishJUnitResults - 将测试结果发布到 Azure Pipelines
boolean. 默认值：false。

指定是否将 JUnit 测试结果发布到 Azure Pipelines。 这需要 xcpretty 启用才能生成 JUnit 测试结果。

testRunTitle - 测试运行标题
string. 可选。 在 时 publishJUnitResults == true使用 。

如果 xcpretty 启用了 和 publishJUnitResults ，则可以指定测试运行标题。

任务控制选项

除了任务输入，所有任务都有控制选项。 有关详细信息，请参阅 控制选项和常见任务属性。

输出变量

无。

备注

使用此任务在 macOS 上生成、测试或存档 Xcode 工作区，并选择性地打包应用。

使用多个预配配置文件

目前，Xcode 任务不支持多个预配配置文件 (例如 iOS 应用扩展) 。

示例

生成 Xcode 应用

要求

要求	说明
管道类型	YAML，经典版本
运行平台	Agent、DeploymentGroup
需求	自承载代理必须具有满足以下要求的功能才能运行使用此任务的作业： xcode
功能	此任务不满足作业中后续任务的任何要求。
命令限制	Any
可设置变量	任意
代理版本	所有支持的代理版本。
任务类别	构建