XamariniOS@1 — zadanie Xamarin.iOS w wersji 1

Użyj tego zadania w potoku, aby utworzyć aplikację systemu iOS za pomocą 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 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.

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 rozwiązania do kompilacji. Może zawierać symbole wieloznaczne.

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

Określa konfigurację. Standardowe konfiguracje 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 ustawiono wartość true, generuje usługę IPA w ramach kompilacji.

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

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

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

Działa nuget restore w rozwiązaniu Xamarin dla systemu iOS, aby zainstalować wszystkie pakiety, do których odwołuje się odwołanie przed kompilacją. Narzędzie nuget w ścieżce maszyny agenta kompilacji jest używane. 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, zostanie użyty katalog główny repozytorium.

buildToolOption - Narzędzie do tworzenia
Alias wejściowy: buildTool. string. Dozwolone wartości: xbuild (xbuild (Xamarin Studio)), msbuild (MSBuild (Visual Studio dla komputerów Mac)). Wartość domyślna: xbuild.

Określa narzędzia kompilacji, których będzie używać zadanie.

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

Opcjonalny. Dostarcza ścieżkę do programu xbuild (narzędzia do kompilowania mono platformy Xamarin Studio) 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.

signingOption - Przesłoń przy użyciu polecenia
Alias wejściowy: signMethod. string. Dozwolone wartości: file (Zawartość pliku), id (Identyfikatory). Wartość domyślna: file.

Użyj tych danych wejściowych, jeśli kompilacja używa metody podpisywania lub aprowizacji innej niż domyślna. Wybierz file opcję użycia certyfikatu P12 i profilu aprowizacji. Wybierz id opcję pobierania ustawień podpisywania z domyślnych profilów łańcucha kluczy i wstępnie zainstalowanych profilów. Pozostaw odpowiednie pola puste, jeśli nie chcesz zastąpić domyślnych ustawień kompilacji.

signingIdentity - Podpisywanie tożsamości
Alias wejściowy: iosSigningIdentity. string. Opcjonalny. Użyj polecenia , gdy signMethod = id.

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 opcji, jeśli używasz tej opcji.

signingUnlockDefaultKeychain - Odblokowywanie domyślnego łańcucha kluczy
Alias wejściowy: unlockDefaultKeychain. boolean. Opcjonalny. Użyj polecenia , gdy signMethod = id. Wartość domyślna: false.

Usuwa błędy "Interakcja użytkownika jest niedozwolona", odblokowując domyślny pęk kluczy.

signingDefaultKeychainPassword - Domyślne hasło łańcucha kluczy
Alias wejściowy: defaultKeychainPassword. string. Opcjonalny. Użyj polecenia , gdy signMethod = id.

Określa hasło do odblokowania domyślnego łańcucha kluczy po signingUnlockDefaultKeychain ustawieniu.

signingProvisioningProfileID - Identyfikator UUID profilu aprowizacji
Alias wejściowy: provProfileUuid. string. Opcjonalny. Użyj polecenia , gdy signMethod = id.

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

signingP12File - Plik certyfikatu P12
Alias wejściowy: p12. string. Opcjonalny. Użyj polecenia , gdy signMethod = file.

Określa ścieżkę względną do pliku certyfikatu PKCS12 w formacie P12 zawierającego certyfikat podpisywania, który ma być używany dla tej kompilacji.

signingP12Password - Hasło P12
Alias wejściowy: p12pwd. string. Opcjonalny. Użyj polecenia , gdy signMethod = file.

Określa hasło do pliku certyfikatu P12. Użyj zmiennej kompilacji, aby zaszyfrować tę wartość.

signingProvisioningProfileFile - Plik profilu aprowizacji
Alias wejściowy: provProfile. string. Opcjonalny. Użyj polecenia , gdy signMethod = file.

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

signingRemoveProfile - Usuwanie profilu po kompilacji
Alias wejściowy: removeProfile. boolean. Opcjonalny. Użyj polecenia , gdy signMethod = file. Wartość domyślna: false.

Określa, że zawartość pliku profilu aprowizacji powinna zostać usunięta z agenta kompilacji po zakończeniu kompilacji. Włącz tę opcję tylko wtedy, gdy uruchamiasz jednego agenta na użytkownika.

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.

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