XamariniOS@2 — zadanie Xamarin.iOS w wersji 2

Artykuł
07/02/2024

Użyj tego zadania w potoku, aby utworzyć aplikację systemu iOS przy użyciu platformy Xamarin w systemie macOS. Aby uzyskać więcej informacji, zobacz wskazówki dotyczące platformy Xamarin i Podpisywanie aplikacji podczas ciągłej integracji.

Składnia

# 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.

Dane wejściowe

solutionFile - Rozwiązanie
Alias wejściowy: solution. string. Wymagane. Wartość domyślna: **/*.sln.

Określa ścieżkę względną z katalogu głównego Xamarin.iOS repozytorium projektu rozwiązania lub csproj do kompilacji. Może zawierać symbole wieloznaczne.

configuration - Konfiguracji
string. Wymagane. Wartość domyślna: Release.

Określa konfigurację. Konfiguracje standardowe to Ad-Hoc, AppStore, Debug i Release.

clean - Czyste
boolean. Wartość domyślna: false.

Opcjonalny. Uruchamia czystą kompilację (/t:clean) przed kompilacją.

packageApp - Tworzenie pakietu aplikacji
boolean. Wartość domyślna: true.

Jeśli jest ustawiona wartość true, generuje adres IPA w ramach kompilacji.

buildForSimulator - Kompilacja dla symulatora systemu iOS
Alias wejściowy: forSimulator. boolean. Wartość domyślna: false.

Opcjonalny. Kompilacje dla symulatora systemu iOS zamiast fizycznych urządzeń z systemem iOS.

runNugetRestore - Uruchamianie przywracania nuGet
boolean. Wartość domyślna: false.

Uruchamia się nuget restore w rozwiązaniu Xamarin dla systemu iOS, aby zainstalować wszystkie pakiety, do których się odwołujesz przed kompilacją. Używane nuget jest narzędzie w ścieżce maszyny agenta kompilacji. Aby użyć innej wersji narzędzia NuGet lub ustawić dodatkowe argumenty, użyj zadania Instalatora NuGet.

args - Argumenty
string.

Opcjonalny. Określa dodatkowe argumenty wiersza polecenia używane do kompilacji.

workingDirectory - Katalog roboczy
Alias wejściowy: cwd. string.

Opcjonalny. Określa katalog roboczy, w którym będą uruchamiane kompilacje. Jeśli wartość jest pusta, używany jest katalog główny repozytorium.

mdtoolFile - Ścieżka narzędzia kompilacji
Alias wejściowy: buildToolLocation | mdtoolLocation. string.

Opcjonalny. Dostarcza ścieżkę do narzędzia xbuild (narzędzia Xamarin Studio mono build) lub MSBuild (narzędzia do kompilacji Visual Studio dla komputerów Mac). Jeśli wartość jest pusta, zostanie użyta domyślna ścieżka xbuild lub MSBuild.

signingIdentity - Tożsamość podpisywania
Alias wejściowy: iosSigningIdentity. string.

Opcjonalny. Zastępuje tożsamość podpisywania, która będzie używana do podpisywania kompilacji. Jeśli wartość jest pusta, zostanie użyte ustawienie w projekcie Xcode. Może być konieczne wybranie signingUnlockDefaultKeychain , jeśli używasz tej opcji.

signingProvisioningProfileID - Identyfikator UUID profilu aprowizacji
Alias wejściowy: provProfileUuid. string.

Opcjonalny. Określa identyfikator UUID zainstalowanego profilu aprowizacji, który ma być używany dla tej kompilacji.

Opcje sterowania zadaniami

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań podrzędnych. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.

Zmienne wyjściowe

Brak.

Uwagi

Co nowego w tej wersji zadania

Konfiguracja rejestracji systemu iOS została usunięta z zadania. Służy Secure Files z zadaniami Install Apple Certificate pomocniczymi i Install Apple Provisioning Profile do konfigurowania podpisywania. Zaktualizowano opcje, aby lepiej pracować z programem Visual Studio for Mac.

Przykłady

Tworzenie aplikacji platformy Xamarin

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja
Działa w	Agent, DeploymentGroup
Wymagania	Agenci hostowani samodzielnie muszą mieć funkcje zgodne z następującymi wymaganiami dotyczącymi uruchamiania zadań korzystających z tego zadania: Xamarin.iOS
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń	Dowolne
Zmienne ustawialne	Dowolne
Wersja agenta	Wszystkie obsługiwane wersje agenta.
Kategoria zadania	Kompilacja

Udostępnij za pośrednictwem