共用方式為


XamariniOS@1 - Xamarin.iOS v1 工作

在管線中使用這項工作,在 macOS 上使用 Xamarin 建置 iOS 應用程式。 如需詳細資訊,請參閱 Xamarin 指引在 CI 期間簽署您的應用程式

Syntax

# 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

指定組態。 標準設定為臨機操作、AppStore、偵錯和發行。


clean - 清潔
boolean. 預設值:false

選擇性。 在建置之前執行全新組建 (/t:clean) 。


packageApp - 建立應用程式套件
boolean. 預設值:true

如果設定為 true ,則會產生 IPA 做為組建的一部分。


buildForSimulator - 適用于 iOS 模擬器的組建
輸入別名: forSimulatorboolean. 預設值:false

選擇性。 針對 iOS 模擬器建置,而不是實體 iOS 裝置。


runNugetRestore - 執行 NuGet 還原
boolean. 預設值:true

在 Xamarin iOS 解決方案上執行 nuget restore ,以在建置之前安裝所有參考的套件。 使用 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 或 MSBuild 路徑。


signingOption - 使用 覆寫
輸入別名: signMethodstring. 允許的值: file (檔案內容) , id (識別碼) 。 預設值:file

如果組建使用與預設值不同的簽署或布建方法,請使用此輸入。 選擇 file 使用 P12 憑證和布建設定檔。 選擇 id 從預設 Keychain 和預先安裝的設定檔擷取簽署設定。 如果您不想覆寫預設組建設定,請將對應的欄位保留空白。


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
Capabilities 此工作不符合作業中後續工作的任何需求。
命令限制 任意
Settable 變數 任意
代理程式版本 所有支援的代理程式版本。
工作類別 組建