Xcode@2 - Xcode 生成 v2 任务

使用此任务可以在 macOS 上生成 Xcode 工作区。

# Xcode Build v2
# Build an Xcode workspace on Mac OS.
- task: Xcode@2
  inputs:
    actions: 'build' # string. Required. Actions. Default: build.
    #configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
    #sdk: '$(SDK)' # string. SDK. Default: $(SDK).
    #xcWorkspacePath: '**/*.xcodeproj/*.xcworkspace' # string. Workspace/Project Path. Default: **/*.xcodeproj/*.xcworkspace.
    #scheme: # string. Scheme. 
    #packageApp: true # boolean. Create App Package. Default: true.
  # Package Options
    packageTool: 'xcodebuild' # 'xcrun' | 'xcodebuild'. Required. Create Package (IPA) using. Default: xcodebuild.
    #archivePath: # string. Optional. Use when packageTool == xcodebuild. Archive Path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageTool == xcodebuild. Export Path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageTool == xcodebuild. 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. 
  # Signing & Provisioning
    #xcode8AutomaticSigning: false # boolean. Automatic Signing. Default: false.
    #teamId: # string. Optional. Use when xcode8AutomaticSigning = true. Team ID. 
    #signMethod: 'file' # 'file' | 'id'. Override Using. Default: file.
    #iosSigningIdentity: # string. Optional. Use when signMethod = id. Signing Identity. 
    #unlockDefaultKeychain: false # boolean. Optional. Use when signMethod = id. Unlock Default Keychain. Default: false.
    #defaultKeychainPassword: # string. Optional. Use when signMethod = id. Default Keychain Password. 
    #provProfileUuid: # string. Optional. Use when signMethod = id. Provisioning Profile UUID. 
    #p12: # string. Optional. Use when signMethod = file. P12 Certificate File. 
    #p12pwd: # string. Optional. Use when signMethod = file. P12 Password. 
    #provProfile: # string. Optional. Use when signMethod = file. Provisioning Profile File. 
    #removeProfile: false # boolean. Optional. Use when signMethod = file. Remove Profile After Build. Default: false.
  # Advanced
    #args: # string. Arguments. 
    #cwd: # string. Working Directory. 
    outputPattern: 'output/$(SDK)/$(Configuration)' # string. Required. Output Directory. Default: output/$(SDK)/$(Configuration).
    #xcodeDeveloperDir: # string. Xcode Developer Path. 
    #useXcpretty: false # boolean. Use xcpretty. Default: false.
    #publishJUnitResults: false # boolean. Publish to VSTS/TFS. Default: false.
  # xctool (deprecated)
    #useXctool: # boolean. Use xctool. 
    #xctoolReporter: # string. xctool Test Reporter Format.

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

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

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

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

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

根据指定的 SDK 生成 Xcode 项目或工作区。 运行 xcodebuild -showsdks 以查看 SDK 的有效列表。

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

可选。 指定从存储库根目录到 Xcode 工作区或项目的相对路径。 例如： MyApp/MyApp.xcworkspace 或 MyApp/MyApp.xcworkspace/MyApp.xcodeproj 。
如果要在“高级参数”下使用-target flag，请留空。

scheme - 方案
string.

可选。 指定 Xcode 方案名称。 必须是 Xcode) 中 托管方案 下的共享方案 (共享复选框。 如果指定了 Workspace，则为必需项。

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

指定是否在生成过程中生成 IPA。 若要使用 Xcode 7 和 Xcode 8 导出存档，请查看 “包选项” 部分中的其他输入。

packageTool - 使用 创建包 (IPA)
string. 必需。 允许的值： xcrun apple) ) 弃用的 (xcrun (， xcodebuild (xcodebuild 存档和导出) 。 默认值：xcodebuild。

指定要用于生成 IPA 的工具。

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

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

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

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

exportOptions - 导出选项
string. 可选。 在 时 packageTool == xcodebuild使用 。 允许的值：auto、plist、specify。 默认值：auto。

指定在导出存档时传入 导出选项 的方法。

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

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

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

指定要用于导出的 Apple 开发人员门户 10 位团队 ID。

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

指定配置存档导出的 plist 文件的路径。

xcode8AutomaticSigning - 自动签名
boolean. 默认值：false。

如果为自动签名配置了 Xcode 8 或 Xcode 9 项目，请使用此输入。

teamId - 团队 ID
string. 可选。 在 时 xcode8AutomaticSigning = true使用 。

指定 10 位开发人员团队 ID。 如果你是多个开发团队的成员，则此参数是必需的。

signMethod - 替代使用
string. 允许的值： file (文件内容) ， id (标识符) 。 默认值：file。

如果生成使用的签名或预配方法不同于默认值，请使用此输入。 选择 File Contents 使用 P12 证书和预配配置文件。 选择Identifiers从默认密钥链和预安装的配置文件检索签名设置。 如果不希望替代默认生成设置，请将相应的字段留空。

iosSigningIdentity - 对标识进行签名
string. 可选。 在 时 signMethod = id使用 。

指定用于对生成进行签名的签名标识替代。 默认为 Xcode 项目设置。 可能需要选择“解锁默认密钥链”。

unlockDefaultKeychain - 解锁默认密钥链
boolean. 可选。 在 时 signMethod = id使用 。 默认值：false。

通过解锁默认密钥链解决不允许用户交互的错误。

defaultKeychainPassword - 默认密钥链密码
string. 可选。 在 时 signMethod = id使用 。

指定用于解锁默认密钥链的密码。

provProfileUuid - 预配配置文件 UUID
string. 可选。 在 时 signMethod = id使用 。

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

p12 - P12 证书文件
string. 可选。 在 时 signMethod = file使用 。

指定 PKCS12 格式的 P12 证书文件的相对路径，该文件包含要用于生成的签名证书。

p12pwd - P12 密码
string. 可选。 在 时 signMethod = file使用 。

指定 P12 证书文件的密码（如果指定）。 使用生成变量进行加密。

provProfile - 预配配置文件
string. 可选。 在 时 signMethod = file使用 。

指定包含要用于生成的预配配置文件替代的文件的相对路径。 使用具有不同方案或目标的单独生成任务，按单个工作区中的目标指定预配配置文件， (iOS、WatchKit、tvOS) 。

removeProfile - 生成后删除配置文件
boolean. 可选。 在 时 signMethod = file使用 。 默认值：false。

生成完成后，从生成代理中删除预配配置文件的内容。 仅当每个用户运行一个代理时，才检查。

args - 参数
string.

指定用于生成的其他命令行参数。 如果要使用 -target 或 -project 而不是指定工作区和方案，此输入非常有用。

cwd - 工作目录
string.

指定生成运行的工作目录。 默认为存储库的根目录。

outputPattern - 输出目录
string. 必需。 默认值：output/$(SDK)/$(Configuration)。

指定生成输出 (二进制文件) 放置的相对路径。

xcodeDeveloperDir - Xcode 开发人员路径
string.

可选。 指定 Xcode Developer 文件夹的路径（如果不是系统默认值）。 在系统上安装多个 Xcode 版本时使用。 例如：/Applications/Xcode 7.app/Contents/Developer。

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

格式化 xcodebuild 输出并生成 JUnit 测试结果报告。 必须在代理主机上安装。 详细了解 xcpretty。

publishJUnitResults - 发布到 VSTS/TFS
boolean. 默认值：false。

使用 xctool 生成的 JUnit 测试结果将发布到 VSTS/TFS。

useXctool - 使用 xctool
boolean.

使用 xctool 而不是 xcodebuild。 必须在代理主机上安装。 详细了解 xctool。
注意：xctool 已弃用，不适用于 Xcode 8。

xctoolReporter - xctool 测试报告器格式
string.

测试指定 测试 操作并选中 “使用 xctool” 时要使用的报告器格式。 指定 junit:output-file-path-here.xml 以生成与发布测试结果任务兼容的文件格式。 指定后，会自动添加 plain 。 xctool 必须在代理主机上安装。 详细了解 xctool。
注意：xctool 已弃用，不适用于 Xcode 8。

无。