XamariniOS@2 - Xamarin.iOS v2 工作

  • 發行項

在管線中使用這項工作，在 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 。

範例

規格需求

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