Xcode@4 — zadanie Xcode w wersji 4

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

# Xcode v4
# Build, test, or archive an Xcode workspace on macOS. Optionally package an app.
- task: Xcode@4
  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' | '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. 
    #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: 'iPhone 7' # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Simulator. Default: iPhone 7.
    #destinationDevices: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices. Device. 
  # Advanced
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #outputPattern: # string. Output directory. 
    #useXcpretty: false # boolean. Use xcpretty. Default: false.
    #publishJUnitResults: false # boolean. Publish test results to VSTS/TFS. Default: false.

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

Określa rozdzielaną spacjami listę akcji. Prawidłowe opcje to build, , clean, testanalyze, i archive. Na przykładclean build wykonuje czystą kompilację. Zobacz Apple: kompilowanie z poziomu wiersza polecenia za pomocą platformy Xcode — często zadawane pytania.

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. Jeśli określisz wartość, musisz również określić schemat. Nie określaj wartości, jeśli określasz -target flag ją w Argumenty zaawansowane. Na przykład: MyApp/MyApp.xcworkspace lub MyApp/MyApp.xcodeproj.

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), 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 powinien zostać wygenerowany 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).

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

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 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. Wartość domyślna: iPhone 7.

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. Dowiedz się więcej o zainstalowanych symulatorach na hostowanym agencie systemu macOS w wersji zapoznawczej.

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.

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 poziomu wiersza polecenia za pomocą platformy Xcode — często zadawane pytania.

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.

katalogu wyjściowego outputPattern -
string.

Opcjonalny. Określa ścieżkę względną do katalogu roboczego, w którym są umieszczane dane wyjściowe kompilacji (pliki binarne). Na przykład: output/$(SDK)/$(Configuration) lub output/$(TestSDK)/$(TestConfiguration). Ścieżki archiwizacji i eksportu są konfigurowane oddzielnie. Określ wartości na karcie Zmienne.

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

Określa, czy użyć formatowania xcprettyxcodebuild danych wyjściowych, i generuje wyniki testu JUnit. xcpretty musi być zainstalowany na maszynie agenta (jest wstępnie zainstalowany na hostowanych agentach kompilacji usługi VSTS). Więcej informacji można znaleźć na stronie xcpretty .

publishJUnitResults - Publikowanie wyników testów w usłudze VSTS/TFS
boolean. Wartość domyślna: false.

Jeśli xcpretty ta opcja jest włączona, te dane wejściowe określają, czy publikować wyniki testu JUnit w usłudze VSTS/TFS.

Żaden.