XamariniOS@1 - Xamarin.iOS v1 工作

發行項
04/16/2024

在管線中使用這項工作，在 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 - 解決方案
輸入別名： solution 。 string. 必要。預設值：**/*.sln。

指定從解決方案的存放庫根目錄到組建的 Xamarin.iOS 相對路徑。可能包含萬用字元。

configuration - 配置
string. 必要。預設值：Release。

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

clean - 清潔
boolean. 預設值：false。

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

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

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

buildForSimulator - 適用于 iOS 模擬器的組建
輸入別名： forSimulator 。 boolean. 預設值：false。

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

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

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

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

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

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。

指定建置完成後，應該從組建代理程式移除布建設定檔的內容。 只有在每個使用者執行一個代理程式時，才啟用此功能。

工作控制選項

除了工作輸入之外，所有工作都有控制選項。如需詳細資訊，請參閱控制項選項和一般工作屬性。

輸出變數

無。

規格需求

需求	描述
管線類型	YAML，傳統組建
執行于	Agent、DeploymentGroup
要求	自我裝載代理程式必須具備符合下列需求的功能，才能執行使用此工作的作業：Xamarin.iOS
Capabilities	此工作不符合作業中後續工作的任何需求。
命令限制	任意
Settable 變數	任意
代理程式版本	所有支援的代理程式版本。
工作類別	組建