Xcode@5 — zadanie Xcode w wersji 5

To zadanie służy do kompilowania, testowania lub archiwizowania obszaru roboczego Xcode w systemie macOS i opcjonalnie pakowania 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

akcji actions -
string. To jest wymagane. Wartość domyślna: build.

Określa rozdzielaną spacjami listę akcji. Niektóre poprawne opcje to build, clean, test, analyzei archive. Na przykładclean build wykonuje czystą kompilację. Zobacz Apple: kompilowanie z wiersza polecenia za pomocą Xcode FAQ.

konfiguracji configuration -
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 - Zestaw SDK (zestaw SDK
string. Wartość domyślna: $(SDK).

Określa zestaw SDK do użycia podczas kompilowania projektu lub obszaru roboczego Xcode. W aplikacji terminala 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ą od katalogu głównego repozytorium do obszaru roboczego lub projektu Xcode. Na przykład: MyApp/MyApp.xcworkspace lub MyApp/MyApp.xcodeproj. Można używać symboli wieloznacznych. Dowiedz się więcej o wzorcach dopasowywania plików .

schematu scheme -
string.

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

xcodeVersion - Wersja programu Xcode
string. Dozwolone wartości: 8 (Xcode 8), 9 (Xcode 9), 10 (Xcode 10), 11 (Xcode 11), 12 (Xcode 12), 13 (Xcode 13), default, 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 ) opiera się na lokalizacji wersji, Xcode 9któ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 deweloperów 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 zainstalowano wiele wersji programu Xcode.

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

Określa, czy plik pakietu aplikacji IPA jest generowany jako część 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 eksportu
string. Opcjonalny. Użyj polecenia , gdy packageApp == true. Dozwolone wartości: auto (Automatic), 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 tę opcję Plist , aby określić plik plist zawierający opcje eksportu. Wybierz Specify , aby podać określoną metodę eksportu i identyfikator zespołu.

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

Określa metodę używaną przez program Xcode do eksportowania archiwum. Na przykład: app-store, , packagead-hoc, enterprise, lub development.

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

Określa 10-znakowy identyfikator zespołu portalu dla deweloperów firmy Apple, który ma być używany podczas eksportu.

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

Określa ścieżkę do pliku plist, który zawiera opcje, które mają być używane podczas eksportu.

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

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

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

Określa metodę podpisywania kompilacji. Zaznacz Do not code sign , aby wyłączyć podpisywanie. Wybierz Project defaults , aby używać tylko konfiguracji podpisywania projektu. Zaznacz Manual signing , aby wymusić ręczne podpisywanie i opcjonalnie określić tożsamość podpisywania i profil obsługi. Wybierz Automatic signing , aby wymusić automatyczne podpisywanie i opcjonalnie określić identyfikator zespołu deweloperskiego. Jeśli projekt wymaga podpisania, użyj zadań Zainstaluj firmę Apple..., aby zainstalować certyfikaty i profile aprowizacji przed kompilacją Xcode.

signingIdentity - Tożsamość podpisywania
string. Opcjonalny. Użyj polecenia , gdy signingOption = manual.

Określa przesłonięcie tożsamości podpisywania, za pomocą którego ma zostać podpisana kompilacja. Może być wymagane odblokowanie domyślnego pęku kluczy na komputerze agenta. Jeśli żadna wartość nie zostanie wprowadzona, 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 elementu docelowego 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 elementu docelowego w jednym obszarze roboczym (iOS, tvOS, watchOS).

identyfikator zespołu teamId -
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 deweloperskiego.

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żywaną 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 tej opcji nie są kierowane żadne symulatory ani urządzenia.

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

Określa platformę urządzenia docelowego używaną 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 tej 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 miejsca docelowego, który ma być używany do testowania interfejsu użytkownika. Urządzenia muszą być podłączone do komputera Mac wykonującego kompilację za pomocą 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żywaną 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>, na przykład iPhone X,OS=11.1. Aby uzyskać więcej informacji, zobacz tę listę symulatorów zainstalowanych w hostowanym agencie systemu macOS.

destinationDevices - Urządzenie
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ć prawych pojedynczych cudzysłowów (').

args - argumenty
string.

Opcjonalny. Określa dodatkowe argumenty wiersza polecenia, za pomocą których ma być kompilowana. Te dane wejściowe są przydatne do określania argumentów -target or -project zamiast obszaru roboczego/projektu i schematu. Zobacz Apple: kompilowanie z wiersza polecenia za pomocą Xcode FAQ.

katalogu roboczego workingDirectory -
Alias wejściowy: cwd. string.

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

useXcpretty - używanie xcpretty
boolean. Wartość domyślna: true.

Określa, czy formatować xcprettyxcodebuild dane wyjściowe. xcpretty musi być zainstalowany na maszynie agenta (jest wstępnie zainstalowany na hostowanych agentach kompilacji usługi Azure Pipelines). Jeśli xcpretty nie jest zainstalowany, wyświetlane są nieprzetworzone xcodebuild dane wyjściowe. Więcej informacji można znaleźć na stronie xcpretty .

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

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

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

Określa, czy publikować wyniki testów JUnit w usłudze Azure Pipelines. Wymaga xcpretty to włączenia możliwości generowania wyników testów JUnit.

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

Jeśli xcpretty opcja i publishJUnitResults jest włączona, można określić tytuł uruchomienia testu.

Opcje sterowania zadania

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

Zmienne wyjściowe

Żaden.

Uwagi

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

Korzystanie z wielu profilów aprowizacji

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

Przykłady

Tworzenie aplikacji Xcode

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja
Działa na	Agent, DeploymentGroup
Wymagania	Agenci hostowani samodzielnie muszą mieć możliwości zgodne z następującymi wymaganiami do 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ń	Jakikolwiek
zmienne ustawiane	Jakikolwiek
Wersja agenta	Wszystkie obsługiwane wersje agentów.
Kategoria zadań	Zbuduj