XamariniOS@2 - Xamarin.iOS v2 工作

文章
07/02/2024

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

Syntax

# 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 - 解決方案
輸入別名： solution 。 string. 必要。預設值：**/*.sln。

指定從方案或 csproj 專案存放庫根目錄到組建的 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. 預設值：false。

在 Xamarin iOS 解決方案上執行 nuget restore ，以在建置之前安裝所有參考的套件。使用 nuget 組建代理程式機器 PATH 中的工具。若要使用不同的 NuGet 版本或設定其他引數，請使用 NuGet 安裝程式工作。

args - 參數
string.

選擇性。指定用來建置的其他命令列引數。

workingDirectory - 工作目錄
輸入別名： cwd 。 string.

選擇性。指定要在其中執行組建的工作目錄。如果值是空的，則會使用存放庫的根目錄。

mdtoolFile - 建置工具路徑
輸入別名： buildToolLocation | mdtoolLocation 。 string.

選擇性。提供 (Xamarin Studio mono 建置工具的路徑，) 或 MSBuild (Visual Studio for Mac建置工具) 。如果值是空的，則會使用預設的 xbuild 或 MSBuild 路徑。

signingIdentity - 簽署身分識別
輸入別名： iosSigningIdentity 。 string.

選擇性。覆寫將用來簽署組建的簽署身分識別。如果值是空的，則會使用 Xcode 專案中的設定。如果您使用此選項，您可能需要選取 signingUnlockDefaultKeychain 。

signingProvisioningProfileID - 布建設定檔 UUID
輸入別名： provProfileUuid 。 string.

選擇性。指定要用於此組建的已安裝布建設定檔覆寫的 UUID。

工作控制選項

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

輸出變數

無。

備註

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

此工作版本的新功能

iOS 簽署設定已從工作中移除。搭配支援的工作 Install Apple Certificate 和 Install Apple Provisioning Profile 設定簽署使用 Secure Files 。已更新選項，以更妥善地使用 Visual Studio for Mac 。

範例

建置 Xamarin 應用程式

規格需求

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

分享方式：