Xcode@5 — zadanie Xcode v5

To zadanie służy do kompilowania, testowania lub archiwizowania obszaru roboczego Xcode w systemie macOS i opcjonalnie spakowania aplikacji.

Składnia

# Xcode v5
# Build, test, or archive an Xcode workspace on macOS. Optionally package an app.
- task: Xcode@5
  inputs:
    actions: 'build' # string. Required. Actions. Default: build.
    #configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
    #sdk: '$(SDK)' # string. SDK. Default: $(SDK).
    #xcWorkspacePath: '**/*.xcodeproj/project.xcworkspace' # string. Workspace or project path. Default: **/*.xcodeproj/project.xcworkspace.
    #scheme: # string. Scheme. 
    #xcodeVersion: 'default' # '8' | '9' | '10' | '11' | '12' | '13' | 'default' | 'specifyPath'. Xcode version. Default: default.
    #xcodeDeveloperDir: # string. Optional. Use when xcodeVersion == specifyPath. Xcode developer path. 
  # Package options
    #packageApp: false # boolean. Create app package. Default: false.
    #archivePath: # string. Optional. Use when packageApp == true. Archive path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageApp == true. Export path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageApp == true. Export options. Default: auto.
    #exportMethod: 'development' # string. Required when exportOptions == specify. Export method. Default: development.
    #exportTeamId: # string. Optional. Use when exportOptions == specify. Team ID. 
    #exportOptionsPlist: # string. Required when exportOptions == plist. Export options plist. 
    #exportArgs: # string. Optional. Use when packageApp == true. Export arguments. 
  # Signing & provisioning
    #signingOption: 'nosign' # 'nosign' | 'default' | 'manual' | 'auto'. Signing style. Default: nosign.
    #signingIdentity: # string. Optional. Use when signingOption = manual. Signing identity. 
    #provisioningProfileUuid: # string. Optional. Use when signingOption = manual. Provisioning profile UUID. 
    #provisioningProfileName: # string. Optional. Use when signingOption = manual. Provisioning profile name. 
    #teamId: # string. Optional. Use when signingOption = auto. Team ID. 
  # Devices & simulators
    #destinationPlatformOption: 'default' # 'default' | 'iOS' | 'tvOS' | 'macOS' | 'custom'. Destination platform. Default: default.
    #destinationPlatform: # string. Optional. Use when destinationPlatformOption == custom. Custom destination platform. 
    #destinationTypeOption: 'simulators' # 'simulators' | 'devices'. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS. Destination type. Default: simulators.
    #destinationSimulators: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Simulator. 
    #destinationDevices: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices. Device. 
  # Advanced
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #useXcpretty: true # boolean. Use xcpretty. Default: true.
    #xcprettyArgs: # string. Optional. Use when useXcpretty == true. Xcpretty arguments. 
    #publishJUnitResults: false # boolean. Publish test results to Azure Pipelines. Default: false.
    #testRunTitle: # string. Optional. Use when publishJUnitResults == true. Test run title.

Dane wejściowe

actions - Działania
string. Wymagane. Wartość domyślna: build.

Określa rozdzielaną spacją listę akcji. Niektóre prawidłowe opcje to build, , testclean, analyzei archive. Na przykładclean build wykonuje czystą kompilację. Zobacz Apple: Tworzenie z poziomu wiersza polecenia za pomocą języka Xcode — często zadawane pytania.

configuration - Konfiguracji
string. Wartość domyślna: $(Configuration).

Określa konfigurację projektu Xcode lub obszaru roboczego do skompilowania. W przypadku używania zmiennej określ wartość (na przykład Release) na karcie Zmienne .

sdk - SDK
string. Wartość domyślna: $(SDK).

Określa zestaw SDK do użycia podczas kompilowania projektu lub obszaru roboczego Xcode. W aplikacji terminalu systemu macOS uruchom polecenie xcodebuild -showsdks , aby wyświetlić prawidłową listę zestawów SDK. W przypadku używania zmiennej określ wartość (na przykład iphonesimulator) na karcie Zmienne .

xcWorkspacePath - Ścieżka obszaru roboczego lub projektu
string. Wartość domyślna: **/*.xcodeproj/project.xcworkspace.

Opcjonalny. Określa ścieżkę względną z katalogu głównego repozytorium do obszaru roboczego lub projektu Xcode. Na przykład: MyApp/MyApp.xcworkspace lub MyApp/MyApp.xcodeproj. Symbole wieloznaczne mogą być używane. Dowiedz się więcej o wzorcach dopasowywania plików.

scheme - Schemat
string.

Opcjonalny. Określa nazwę schematu Xcode. Musi być schematem udostępnionym (pole wyboru udostępnionego w obszarze Schematy zarządzane w programie Xcode). Jeśli nie określisz schematu, a określony obszar roboczy ma jeden schemat udostępniony, zostanie użyty schemat obszaru roboczego.

xcodeVersion - Wersja programu Xcode
string. Dozwolone wartości: 8 (Xcode 8), 9 (Xcode 9), 10 (Xcode 10), (Xcode 11), 1112 (Xcode 12), (Xcode 13), 13default, specifyPath (Określ ścieżkę). Wartość domyślna: default.

Określa docelową wersję programu Xcode. Wybierz Default , aby użyć domyślnej wersji programu Xcode na maszynie agenta. Określenie numeru wersji (na przykład Xcode 9) zależy od lokalizacji wersji, która ma być ustawiana przez zmienne środowiskowe na maszynie agenta (na przykład XCODE_9_DEVELOPER_DIR=/Applications/Xcode_9.0.0.app/Contents/Developer). Wybierz Specify path , aby podać określoną ścieżkę do katalogu dewelopera Xcode.

xcodeDeveloperDir - Ścieżka dewelopera Xcode
string. Opcjonalny. Użyj polecenia , gdy xcodeVersion == specifyPath.

Określa ścieżkę do określonego katalogu dewelopera Xcode (na przykład /Applications/Xcode_9.0.0.app/Contents/Developer). Te dane wejściowe są przydatne, gdy na maszynie agenta jest zainstalowanych wiele wersji programu Xcode.

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

Określa, czy plik pakietu aplikacji IPA jest generowany w ramach kompilacji.

archivePath - Ścieżka archiwum
string. Opcjonalny. Użyj polecenia , gdy packageApp == true.

Określa katalog, w którym są umieszczane utworzone archiwa.

exportPath - Ścieżka eksportu
string. Opcjonalny. Użyj polecenia , gdy packageApp == true. Wartość domyślna: output/$(SDK)/$(Configuration).

Określa miejsce docelowe produktu wyeksportowanego z archiwum.

exportOptions - Opcje eksportowania
string. Opcjonalny. Użyj polecenia , gdy packageApp == true. Dozwolone wartości: auto (automatyczne), plist, specify. Wartość domyślna: auto.

Określa opcje eksportowania archiwum. Po wybraniu wartości domyślnej Automatic metoda eksportu jest automatycznie wykrywana z archiwum. Wybierz, Plist aby określić plik plist zawierający opcje eksportu. Wybierz Specify , aby podać określoną metodę eksportu i identyfikator zespołu.

exportMethod - Export, metoda
string. Wymagane, gdy exportOptions == specify. Wartość domyślna: development.

Określa metodę używaną przez program Xcode do wyeksportowania archiwum. Na przykład: app-store, , ad-hocpackage, enterpriselub development.

exportTeamId - Identyfikator zespołu
string. Opcjonalny. Użyj polecenia , gdy exportOptions == specify.

Określa identyfikator 10-znakowego zespołu portalu dla deweloperów firmy Apple do użycia podczas eksportowania.

exportOptionsPlist - Opcje eksportu plist
string. Wymagane, gdy exportOptions == plist.

Określa ścieżkę do pliku plist zawierającego opcje do użycia podczas eksportowania.

exportArgs - Eksportowanie argumentów
string. Opcjonalny. Użyj polecenia , gdy packageApp == true.

Określa dodatkowe argumenty wiersza polecenia używane podczas eksportowania.

signingOption - Styl podpisywania
string. Dozwolone wartości: nosign (Nie podpisz kodu), default (Wartości domyślne projektu), manual (Podpisywanie ręczne), auto (Automatyczne podpisywanie). Wartość domyślna: nosign.

Określa metodę podpisywania kompilacji. Wybierz Do not code sign , aby wyłączyć podpisywanie. Wybierz Project defaults opcję, aby używać tylko konfiguracji podpisywania projektu. Wybierz Manual signing , aby wymusić ręczne podpisywanie i opcjonalnie określić tożsamość podpisywania i profil aprowizacji. Wybierz Automatic signing , aby wymusić automatyczne podpisywanie i opcjonalnie określić identyfikator zespołu deweloperów. Jeśli projekt wymaga podpisania, przed kompilacją programu Xcode użyj zadań Zainstaluj firmę Apple... w celu zainstalowania certyfikatów i profilów aprowizacji.

signingIdentity - Podpisywanie tożsamości
string. Opcjonalny. Użyj polecenia , gdy signingOption = manual.

Określa zastępowanie tożsamości podpisywania, za pomocą której ma być podpisywanie kompilacji. Odblokowanie domyślnego łańcucha kluczy na maszynie agenta może być wymagane. Jeśli nie zostanie wprowadzona żadna wartość, zostanie użyte ustawienie projektu Xcode.

provisioningProfileUuid - Identyfikator UUID profilu aprowizacji
string. Opcjonalny. Użyj polecenia , gdy signingOption = manual.

Określa identyfikator UUID zainstalowanego profilu aprowizacji używanego dla kompilacji. Użyj oddzielnych zadań kompilacji z różnymi schematami lub obiektami docelowymi, aby określić profile aprowizacji według lokalizacji docelowej w jednym obszarze roboczym (iOS, tvOS, watchOS).

provisioningProfileName - Nazwa profilu aprowizacji
string. Opcjonalny. Użyj polecenia , gdy signingOption = manual.

Określa nazwę zainstalowanego profilu aprowizacji używanego dla kompilacji. Jeśli zostanie określony, ma to pierwszeństwo przed identyfikatorem UUID profilu aprowizacji. Użyj oddzielnych zadań kompilacji z różnymi schematami lub obiektami docelowymi, aby określić profile aprowizacji według lokalizacji docelowej w jednym obszarze roboczym (iOS, tvOS, watchOS).

teamId - Identyfikator zespołu
string. Opcjonalny. Użyj polecenia , gdy signingOption = auto.

Wymagane, jeśli jesteś członkiem wielu zespołów programistycznych. Określa 10-znakowy identyfikator zespołu deweloperów.

destinationPlatformOption - Platforma docelowa
string. Dozwolone wartości: default, ( iOS iOS i watchOS), tvOS, macOS. custom Wartość domyślna: default.

Określa platformę urządzenia docelowego używanego do testowania interfejsu użytkownika, gdy ogólne urządzenie kompilacji jest nieprawidłowe. Wybierz Custom , aby określić platformę, która nie znajduje się na tej liście. Po Default wybraniu opcji nie są przeznaczone żadne symulatory ani urządzenia.

destinationPlatform - Niestandardowa platforma docelowa
string. Opcjonalny. Użyj polecenia , gdy destinationPlatformOption == custom.

Określa platformę urządzenia docelowego używanego do testowania interfejsu użytkownika, gdy ogólne urządzenie kompilacji jest nieprawidłowe. Wybierz Custom , aby określić platformę, która nie znajduje się na liście. Po Default wybraniu opcji nie są przeznaczone żadne symulatory ani urządzenia.

destinationTypeOption - Typ miejsca docelowego
string. Opcjonalny. Użyj polecenia , gdy destinationPlatformOption != default && destinationPlatformOption != macOS. Dozwolone wartości: simulators (Symulator), devices (Połączone urządzenie). Wartość domyślna: simulators.

Określa typ docelowy do użycia na potrzeby testowania interfejsu użytkownika. Urządzenia muszą być podłączone do komputera Mac wykonującego kompilację za pośrednictwem kabla lub połączenia sieciowego. Aby uzyskać więcej informacji, zobacz Urządzenia i symulatory w programie Xcode.

destinationSimulators - Simulator
string. Opcjonalny. Użyj polecenia , gdy destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators.

Określa nazwę symulatora Xcode używanego do testowania interfejsu użytkownika. Na przykład iPhone X (iOS i watchOS) lub Apple TV 4K (tvOS). Opcjonalna docelowa wersja systemu operacyjnego może być określona w formacie OS=<versionNumber>, takim jak iPhone X,OS=11.1. Aby uzyskać więcej informacji, zobacz tę listę symulatorów zainstalowanych w agencie hostowanego systemu macOS.

destinationDevices - Urządzenia
string. Opcjonalny. Użyj polecenia , gdy destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices.

Określa nazwę urządzenia używanego do testowania interfejsu użytkownika, na przykład Raisa's iPad. Obecnie obsługiwane jest tylko jedno urządzenie. Należy pamiętać, że firma Apple nie zezwala na apostrofy (') w nazwach urządzeń. Zamiast tego można użyć prawego cudzysłowu (').

args - Argumenty
string.

Opcjonalny. Określa dodatkowe argumenty wiersza polecenia, z którymi ma być kompilowanie. Te dane wejściowe są przydatne do określania -target argumentów lub -project zamiast obszaru roboczego/projektu i schematu. Zobacz Apple: Tworzenie z poziomu wiersza polecenia za pomocą języka Xcode — często zadawane pytania.

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

Opcjonalny. Określa katalog roboczy, w którym ma zostać uruchomiona kompilacja. Jeśli nie zostanie wprowadzona żadna wartość, zostanie użyty katalog główny repozytorium.

useXcpretty - Korzystanie z elementu xcpretty
boolean. Wartość domyślna: true.

Określa, czy ma być używany xcpretty do formatowania xcodebuild danych wyjściowych. xcpretty należy zainstalować na maszynie agenta (jest ona wstępnie zainstalowana w usłudze Azure Pipelines hostowanych agentów kompilacji). Jeśli xcpretty nie zainstalowano, zostaną wyświetlone nieprzetworzone xcodebuild dane wyjściowe. Aby uzyskać więcej informacji, zobacz xcpretty .

xcprettyArgs - Argumenty Xcpretty
string. Opcjonalny. Użyj polecenia , gdy useXcpretty == true.

Jeśli xcpretty jest włączona, dane wejściowe określają argumenty dla xcprettyelementu . Zobacz listę argumentów xcpretty w witrynie GitHub.

publishJUnitResults - Publikowanie wyników testów w usłudze Azure Pipelines
boolean. Wartość domyślna: false.

Określa, czy opublikować wyniki testu JUnit w usłudze Azure Pipelines. xcpretty Wymaga to włączenia generowania wyników testu JUnit.

testRunTitle - Tytuł przebiegu testu
string. Opcjonalny. Użyj polecenia , gdy publishJUnitResults == true.

Jeśli xcpretty i publishJUnitResults są włączone, możesz określić tytuł przebiegu testowego.

Opcje sterowania zadania

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

Zmienne wyjściowe

Brak.

Uwagi

To zadanie służy do kompilowania, testowania lub archiwizowania obszaru roboczego programu Xcode w systemie macOS i opcjonalnie spakowania aplikacji.

Korzystanie z wielu profilów aprowizacji

Obecnie nie ma obsługi wielu profilów aprowizacji dla zadania Xcode (na przykład rozszerzenia aplikacji systemu iOS).

Przykłady

Tworzenie aplikacji Xcode

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja
Działa w	Agent, DeploymentGroup
Wymagania	Agenci hostowani samodzielnie muszą mieć możliwości zgodne z następującymi wymaganiami dotyczącymi uruchamiania zadań korzystających z tego zadania: xcode
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