XamariniOS@2 - Xamarin.iOS v2 任务

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

语法

# Xamarin.iOS v2
# Build an iOS app with Xamarin on macOS.
- task: XamariniOS@2
  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: false # boolean. Run NuGet restore. Default: false.
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #mdtoolFile: # string. Alias: buildToolLocation | mdtoolLocation. Build tool path. 
  # Signing & Provisioning
    #signingIdentity: # string. Alias: iosSigningIdentity. Signing identity. 
    #signingProvisioningProfileID: # string. Alias: provProfileUuid. Provisioning profile UUID.

输入

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

指定从解决方案或 csproj 项目的存储库根目录 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. 默认值:false

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


args - 参数
string.

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


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

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


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

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


signingIdentity - 签名标识
输入别名: iosSigningIdentitystring.

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


signingProvisioningProfileID - 预配配置文件 UUID
输入别名: provProfileUuidstring.

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


任务控件选项

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

输出变量

无。

备注

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

此任务版本中的新增功能

  • iOS 签名设置已从任务中删除。 使用 Secure Files 与支持任务 Install Apple CertificateInstall Apple Provisioning Profile 一起使用来设置签名。 更新了选项以更好地使用 Visual Studio for Mac

示例

要求

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