XamariniOS@1 - Xamarin.iOS v1 任务

在管道中使用此任务在 macOS 上使用 Xamarin 生成 iOS 应用。 有关详细信息,请参阅 Xamarin 指南在 CI 期间对应用进行签名

语法

# Xamarin.iOS v1
# Build an iOS app with Xamarin on macOS.
- task: XamariniOS@1
  inputs:
    solutionFile: '**/*.sln' # string. Alias: solution. Required. Solution. Default: **/*.sln.
    configuration: 'Release' # string. Required. Configuration. Default: Release.
    #clean: false # boolean. Clean. Default: false.
    #packageApp: true # boolean. Create app package. Default: true.
    #buildForSimulator: false # boolean. Alias: forSimulator. Build for iOS Simulator. Default: false.
  # Advanced
    #runNugetRestore: true # boolean. Run NuGet restore. Default: true.
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #buildToolOption: 'xbuild' # 'xbuild' | 'msbuild'. Alias: buildTool. Build tool. Default: xbuild.
    #mdtoolFile: # string. Alias: mdtoolLocation. Build tool path. 
  # Signing & Provisioning
    #signingOption: 'file' # 'file' | 'id'. Alias: signMethod. Override using. Default: file.
    #signingIdentity: # string. Alias: iosSigningIdentity. Optional. Use when signMethod = id. Signing identity. 
    #signingUnlockDefaultKeychain: false # boolean. Alias: unlockDefaultKeychain. Optional. Use when signMethod = id. Unlock default keychain. Default: false.
    #signingDefaultKeychainPassword: # string. Alias: defaultKeychainPassword. Optional. Use when signMethod = id. Default keychain password. 
    #signingProvisioningProfileID: # string. Alias: provProfileUuid. Optional. Use when signMethod = id. Provisioning profile UUID. 
    #signingP12File: # string. Alias: p12. Optional. Use when signMethod = file. P12 certificate file. 
    #signingP12Password: # string. Alias: p12pwd. Optional. Use when signMethod = file. P12 password. 
    #signingProvisioningProfileFile: # string. Alias: provProfile. Optional. Use when signMethod = file. Provisioning profile file. 
    #signingRemoveProfile: false # boolean. Alias: removeProfile. Optional. Use when signMethod = file. Remove profile after build. Default: false.

输入

solutionFile - 解决 方案
输入别名: solutionstring. 必需。 默认值:**/*.sln

指定从解决方案的 Xamarin.iOS 存储库根目录到生成的相对路径。 可以包含通配符。


configuration - 配置
string. 必需。 默认值:Release

指定配置。 标准配置包括 Ad-Hoc、AppStore、Debug 和 Release。


clean - 清洁
boolean. 默认值:false

可选。 在生成之前 (/t:clean) 运行干净生成。


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

如果设置为 true,则会在生成过程中生成 IPA。


buildForSimulator - 针对 iOS 模拟器生成
输入别名: forSimulatorboolean. 默认值:false

可选。 针对 iOS 模拟器而不是物理 iOS 设备生成。


runNugetRestore - 运行 NuGet 还原
boolean. 默认值:true

nuget restore在 Xamarin iOS 解决方案上运行,以在生成之前安装所有引用的包。 使用 nuget 生成代理计算机的 PATH 中的工具。 若要使用不同版本的 NuGet 或设置其他参数,请使用 NuGet 安装程序任务


args - 参数
string.

可选。 指定用于生成的其他命令行参数。


workingDirectory - 工作目录
输入别名: cwdstring.

可选。 指定要在其中运行生成的工作目录。 如果值为空,则使用存储库的根。


buildToolOption - 生成工具
输入别名: buildToolstring. 允许的值: xbuild (xbuild (Xamarin Studio) ) 、 msbuild (MSBuild (Visual Studio for Mac) ) 。 默认值:xbuild

指定任务将使用的生成工具。


mdtoolFile - 生成工具路径
输入别名: mdtoolLocationstring.

可选。 (Xamarin Studio mono 生成工具) 或 MSBuild (Visual Studio for Mac生成工具) 提供 xbuild 的路径。 如果值为空,则使用默认的 xbuild 或 MSBuild 路径。


signingOption - 使用 替代
输入别名: signMethodstring. 允许的值: file (文件内容) 、 id (标识符) 。 默认值:file

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


signingIdentity - 签名标识
输入别名: iosSigningIdentitystring. 可选。 在 时 signMethod = id使用 。

替代将用于对生成进行签名的签名标识。 如果值为空,将使用 Xcode 项目中的设置。 如果使用此选项,可能需要选择 signingUnlockDefaultKeychain


signingUnlockDefaultKeychain - 解锁默认密钥链
输入别名: unlockDefaultKeychainboolean. 可选。 在 时 signMethod = id使用 。 默认值:false

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


signingDefaultKeychainPassword - 默认密钥链密码
输入别名: defaultKeychainPasswordstring. 可选。 在 时 signMethod = id使用 。

指定在设置 时 signingUnlockDefaultKeychain 解锁默认密钥链的密码。


signingProvisioningProfileID - 预配配置文件 UUID
输入别名: provProfileUuidstring. 可选。 在 时 signMethod = id使用 。

指定要用于此生成的已安装预配配置文件的 UUID。


signingP12File - P12 证书文件
输入别名: p12string. 可选。 在 时 signMethod = file使用 。

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


signingP12Password - P12 密码
输入别名: p12pwdstring. 可选。 在 时 signMethod = file使用 。

指定 P12 证书文件的密码。 使用生成变量加密此值。


signingProvisioningProfileFile - 预配配置文件
输入别名: provProfilestring. 可选。 在 时 signMethod = file使用 。

指定要用于此生成的已安装预配配置文件替代的 UUID。


signingRemoveProfile - 生成后删除配置文件
输入别名: removeProfileboolean. 可选。 在 时 signMethod = file使用 。 默认值:false

指定在生成完成后应从生成代理中删除预配配置文件的内容。 仅当每个用户运行一个代理时,才启用此功能


任务控件选项

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

输出变量

无。

要求

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