Udostępnij za pośrednictwem

Xcode@2 — zadanie Xcode Build v2

To zadanie służy do tworzenia obszaru roboczego programu Xcode w systemie macOS.

Składnia

# Xcode Build v2
# Build an Xcode workspace on Mac OS.
- task: Xcode@2
  inputs:
    actions: 'build' # string. Required. Actions. Default: build.
    #configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
    #sdk: '$(SDK)' # string. SDK. Default: $(SDK).
    #xcWorkspacePath: '**/*.xcodeproj/*.xcworkspace' # string. Workspace/Project Path. Default: **/*.xcodeproj/*.xcworkspace.
    #scheme: # string. Scheme. 
    #packageApp: true # boolean. Create App Package. Default: true.
  # Package Options
    packageTool: 'xcodebuild' # 'xcrun' | 'xcodebuild'. Required. Create Package (IPA) using. Default: xcodebuild.
    #archivePath: # string. Optional. Use when packageTool == xcodebuild. Archive Path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageTool == xcodebuild. Export Path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageTool == xcodebuild. 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. 
  # Signing & Provisioning
    #xcode8AutomaticSigning: false # boolean. Automatic Signing. Default: false.
    #teamId: # string. Optional. Use when xcode8AutomaticSigning = true. Team ID. 
    #signMethod: 'file' # 'file' | 'id'. Override Using. Default: file.
    #iosSigningIdentity: # string. Optional. Use when signMethod = id. Signing Identity. 
    #unlockDefaultKeychain: false # boolean. Optional. Use when signMethod = id. Unlock Default Keychain. Default: false.
    #defaultKeychainPassword: # string. Optional. Use when signMethod = id. Default Keychain Password. 
    #provProfileUuid: # string. Optional. Use when signMethod = id. Provisioning Profile UUID. 
    #p12: # string. Optional. Use when signMethod = file. P12 Certificate File. 
    #p12pwd: # string. Optional. Use when signMethod = file. P12 Password. 
    #provProfile: # string. Optional. Use when signMethod = file. Provisioning Profile File. 
    #removeProfile: false # boolean. Optional. Use when signMethod = file. Remove Profile After Build. Default: false.
  # Advanced
    #args: # string. Arguments. 
    #cwd: # string. Working Directory. 
    outputPattern: 'output/$(SDK)/$(Configuration)' # string. Required. Output Directory. Default: output/$(SDK)/$(Configuration).
    #xcodeDeveloperDir: # string. Xcode Developer Path. 
    #useXcpretty: false # boolean. Use xcpretty. Default: false.
    #publishJUnitResults: false # boolean. Publish to VSTS/TFS. Default: false.
  # xctool (deprecated)
    #useXctool: # boolean. Use xctool. 
    #xctoolReporter: # string. xctool Test Reporter Format.

Dane wejściowe

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ład build clean 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).

Kompiluje projekt Xcode lub obszar roboczy względem określonego zestawu SDK. Uruchom xcodebuild -showsdks, aby wyświetlić prawidłową listę zestawów SDK.


xcWorkspacePath - obszaru roboczego/ścieżki projektu
string. Wartość domyślna: **/*.xcodeproj/*.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.xcworkspace/MyApp.xcodeproj.
Pozostaw wartość pustą, jeśli zamierzasz użyć -target flag w obszarze Argumenty zaawansowane.


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). wymagane, jeśli określono obszar roboczy.


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

Określa, czy usługa IPA jest generowana w ramach kompilacji. Aby wyeksportować archiwa z programem Xcode 7 i Xcode 8, zapoznaj się z dodatkowymi danymi wejściowymi w sekcji Opcje pakietów.


packageTool - tworzenie pakietu (IPA) przy użyciu
string. To jest wymagane. Dozwolone wartości: xcrun (xcrun (przestarzałe przez firmę Apple)), xcodebuild (archiwum i eksportowanie xcodebuild). Wartość domyślna: xcodebuild.

Określa narzędzie do użycia do generowania adresów IPA.


ścieżka archiwum archivePath -
string. Opcjonalny. Użyj polecenia , gdy packageTool == xcodebuild.

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


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

Określa miejsce docelowe produktu wyeksportowanego z archiwum.


opcje eksportu exportOptions -
string. Opcjonalny. Użyj polecenia , gdy packageTool == xcodebuild. Dozwolone wartości: auto, plist, specify. Wartość domyślna: auto.

Określa sposób przekazywania opcji eksportu podczas eksportowania archiwum.


metoda eksportu exportMethod -
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, package, ad-hoc, enterpriselub development.


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

Określa 10-cyfrowy identyfikator zespołu portalu dla deweloperów firmy Apple do użycia na potrzeby eksportu.


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

Określa ścieżkę do pliku plist, który konfiguruje eksportowanie archiwum.


xcode8AutomaticSigning - automatyczne podpisywanie
boolean. Wartość domyślna: false.

Użyj tych danych wejściowych, jeśli masz projekt Xcode 8 lub Xcode 9 skonfigurowany do automatycznego podpisywania.


identyfikator zespołu teamId -
string. Opcjonalny. Użyj polecenia , gdy xcode8AutomaticSigning = true.

Określa 10-cyfrowy identyfikator zespołu deweloperów. Jest to wymagane, jeśli jesteś członkiem wielu zespołów programistycznych.


signMethod - przesłonięć przy użyciu
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 Contents, aby użyć certyfikatu P12 i profilu aprowizacji. Wybierz Identifiers, aby pobrać ustawienia 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.


iosSigningIdentity - podpisywania tożsamości
string. Opcjonalny. Użyj polecenia , gdy signMethod = id.

Określa zastąpienie tożsamości podpisywania używane do podpisywania kompilacji. Domyślnie jest to ustawienie projektu Xcode. może być konieczne wybranie domyślnego łańcucha kluczy.


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

Rozwiązuje interakcja z użytkownikiem nie jest dozwolona błędów przez odblokowanie domyślnego łańcucha kluczy.


defaultKeychainPassword - domyślne hasło łańcucha kluczy
string. Opcjonalny. Użyj polecenia , gdy signMethod = id.

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


identyfikator UUID profilu aprowizacji provProfileUuid -
string. Opcjonalny. Użyj polecenia , gdy signMethod = id.

Określa identyfikator UUID zainstalowanego profilu aprowizacji do użycia 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, WatchKit, tvOS).


pliku certyfikatu P12 p12 -
string. Opcjonalny. Użyj polecenia , gdy signMethod = file.

Określa ścieżkę względną do pliku certyfikatu PKCS12 sformatowanego P12, który zawiera certyfikat podpisywania, który ma być używany do kompilacji.


haseł p12pwd - P12
string. Opcjonalny. Użyj polecenia , gdy signMethod = file.

Określa hasło do pliku certyfikatu P12, jeśli określono. Szyfrowanie za pomocą zmiennej kompilacji.


provProfile - plik profilu aprowizacji
string. Opcjonalny. Użyj polecenia , gdy signMethod = file.

Określa ścieżkę względną do pliku zawierającego przesłonięcia profilu aprowizacji, które mają być używane 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, WatchKit, tvOS).


removeProfile - usuń profil po kompilacji
boolean. Opcjonalny. Użyj polecenia , gdy signMethod = file. Wartość domyślna: false.

Usuwa zawartość pliku profilu aprowizacji z agenta kompilacji po zakończeniu kompilacji. sprawdź tylko, czy używasz jednego agenta na użytkownika.


args - argumenty
string.

Określa dodatkowe argumenty wiersza polecenia używane do kompilowania. Te dane wejściowe są przydatne, jeśli chcesz użyć -target lub -project zamiast określać obszar roboczy i schemat.


katalogu roboczego cwd -
string.

Określa katalog roboczy dla przebiegów kompilacji. Domyślnie jest to katalog główny repozytorium.


outputPattern - katalogu wyjściowego
string. To jest wymagane. Wartość domyślna: output/$(SDK)/$(Configuration).

Określa ścieżkę względną, w której są umieszczane dane wyjściowe kompilacji (pliki binarne).


xcodeDeveloperDir - ścieżki dewelopera Xcode
string.

Opcjonalny. Określa ścieżkę do folderu Xcode Developer, jeśli nie jest to domyślny system. Do użycia, gdy w systemie jest zainstalowanych wiele wersji programu Xcode. Na przykład: /Applications/Xcode 7.app/Contents/Developer.


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

Formatuje dane wyjściowe xcodebuild i generuje raport wyników testu JUnit. Należy zainstalować na hostach agentów. Dowiedz się więcej o xcpretty.


publishJUnitResults - publikowanie w usługach VSTS/TFS
boolean. Wartość domyślna: false.

Wyniki testów JUnit utworzone przy użyciu xctool są publikowane w usługach VSTS/TFS.


useXctool - używanie narzędzia xctool
boolean.

Używa xctool zamiast xcodebuild. Należy zainstalować na hostach agentów. Dowiedz się więcej o xctool.
Uwaga:xctool jest przestarzała i nie działa z programem Xcode 8.


format xctoolReporter - xctool Test Reporter Format
string.

Testuje format reportera do użycia, gdy określono akcję testu, a jest zaznaczona opcja Użyj narzędzia xctool. Określ junit:output-file-path-here.xml, aby wygenerować format pliku zgodny z zadaniem Publikowanie wyników testów. Po określeniu jest automatycznie dodawany zwykły. xctool należy zainstalować na hostach agentów. Dowiedz się więcej o xctool.
Uwaga:xctool jest przestarzała i nie działa z programem Xcode 8.


Opcje sterowania zadaniami

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.

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