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
- 解决 方案
输入别名: solution
。 string
. 必需。 默认值:**/*.sln
。
指定从解决方案的 Xamarin.iOS
存储库根目录到生成的相对路径。 可以包含通配符。
configuration
- 配置
string
. 必需。 默认值:Release
。
指定配置。 标准配置包括 Ad-Hoc、AppStore、Debug 和 Release。
clean
- 清洁
boolean
. 默认值:false
。
可选。 在生成之前 (/t:clean
) 运行干净生成。
packageApp
- 创建应用包
boolean
. 默认值:true
。
如果设置为 true
,则会在生成过程中生成 IPA。
buildForSimulator
- 针对 iOS 模拟器生成
输入别名: forSimulator
。 boolean
. 默认值:false
。
可选。 针对 iOS 模拟器而不是物理 iOS 设备生成。
runNugetRestore
- 运行 NuGet 还原
boolean
. 默认值:true
。
nuget restore
在 Xamarin iOS 解决方案上运行,以在生成之前安装所有引用的包。 使用 nuget
生成代理计算机的 PATH 中的工具。 若要使用不同版本的 NuGet 或设置其他参数,请使用 NuGet 安装程序任务。
args
- 参数
string
.
可选。 指定用于生成的其他命令行参数。
workingDirectory
- 工作目录
输入别名: cwd
。 string
.
可选。 指定要在其中运行生成的工作目录。 如果值为空,则使用存储库的根。
buildToolOption
- 生成工具
输入别名: buildTool
。 string
. 允许的值: xbuild
(xbuild (Xamarin Studio) ) 、 msbuild
(MSBuild (Visual Studio for Mac) ) 。 默认值:xbuild
。
指定任务将使用的生成工具。
mdtoolFile
- 生成工具路径
输入别名: mdtoolLocation
。 string
.
可选。 (Xamarin Studio mono 生成工具) 或 MSBuild (Visual Studio for Mac生成工具) 提供 xbuild 的路径。 如果值为空,则使用默认的 xbuild 或 MSBuild 路径。
signingOption
- 使用 替代
输入别名: signMethod
。 string
. 允许的值: file
(文件内容) 、 id
(标识符) 。 默认值:file
。
如果生成使用的签名或预配方法不同于默认值,请使用此输入。 选择 file
使用 P12 证书和预配配置文件。 选择 id
从默认密钥链和预安装的配置文件检索签名设置。 如果不希望替代默认生成设置,请将相应的字段留空。
signingIdentity
- 签名标识
输入别名: iosSigningIdentity
。 string
. 可选。 在 时 signMethod = id
使用 。
替代将用于对生成进行签名的签名标识。 如果值为空,将使用 Xcode 项目中的设置。 如果使用此选项,可能需要选择 signingUnlockDefaultKeychain
。
signingUnlockDefaultKeychain
- 解锁默认密钥链
输入别名: unlockDefaultKeychain
。 boolean
. 可选。 在 时 signMethod = id
使用 。 默认值:false
。
通过解锁默认密钥链解决“不允许用户交互”错误。
signingDefaultKeychainPassword
- 默认密钥链密码
输入别名: defaultKeychainPassword
。 string
. 可选。 在 时 signMethod = id
使用 。
指定在设置 时 signingUnlockDefaultKeychain
解锁默认密钥链的密码。
signingProvisioningProfileID
- 预配配置文件 UUID
输入别名: provProfileUuid
。 string
. 可选。 在 时 signMethod = id
使用 。
指定要用于此生成的已安装预配配置文件的 UUID。
signingP12File
- P12 证书文件
输入别名: p12
。 string
. 可选。 在 时 signMethod = file
使用 。
指定 PKCS12 格式的 P12 证书文件的相对路径,其中包含要用于此生成的签名证书。
signingP12Password
- P12 密码
输入别名: p12pwd
。 string
. 可选。 在 时 signMethod = file
使用 。
指定 P12 证书文件的密码。 使用生成变量加密此值。
signingProvisioningProfileFile
- 预配配置文件
输入别名: provProfile
。 string
. 可选。 在 时 signMethod = file
使用 。
指定要用于此生成的已安装预配配置文件替代的 UUID。
signingRemoveProfile
- 生成后删除配置文件
输入别名: removeProfile
。 boolean
. 可选。 在 时 signMethod = file
使用 。 默认值:false
。
指定在生成完成后应从生成代理中删除预配配置文件的内容。 仅当每个用户运行一个代理时,才启用此功能。
任务控件选项
除任务输入外,所有任务都有控制选项。 有关详细信息,请参阅 控制选项和常见任务属性。
输出变量
无。