Dela via

Xcode@2 – Xcode Build v2-uppgift

  • Artikel

Använd den här uppgiften för att skapa en Xcode-arbetsyta på macOS.

Syntax

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

Ingångar

actions - Åtgärder
string. Obligatoriskt. Standardvärde: build.

Anger en utrymmesavgränsad lista över åtgärder. Giltiga alternativ är build, clean, test, analyzeoch archive. Till exempel utför build clean en ren version. Se Apple: Building från kommandoraden med vanliga frågor och svar om Xcode.


configuration - Konfiguration
string. Standardvärde: $(Configuration).

Anger Xcode-projekt- eller arbetsytekonfigurationen som ska skapas. När du använder en variabel anger du ett värde (till exempel Release) på fliken Variabler.


sdk - SDK
string. Standardvärde: $(SDK).

Skapar ett Xcode-projekt eller en arbetsyta mot angivet SDK. Kör xcodebuild -showsdks för att se en giltig lista över SDK:er.


xcWorkspacePath - Arbetsyta/Projektsökväg
string. Standardvärde: **/*.xcodeproj/*.xcworkspace.

Valfritt. Anger den relativa sökvägen från lagringsplatsens rot till Xcode-arbetsytan eller projektet. Till exempel: MyApp/MyApp.xcworkspace eller MyApp/MyApp.xcworkspace/MyApp.xcodeproj.
Lämna tomt om du tänker använda -target flag under Avancerade argument.


scheme - schema
string.

Valfritt. Anger Xcode-schemanamnet. Måste vara ett delat schema (delad kryssruta under hanterade scheman i Xcode). Krävs om arbetsytan har angetts.


packageApp - Skapa
boolean. Standardvärde: true.

Anger om en IPA genereras som en del av bygget. Om du vill exportera arkiv med Xcode 7 och Xcode 8 läser du ytterligare indata i avsnittet Paketalternativ.


packageTool - Skapa paket (IPA) med
string. Obligatoriskt. Tillåtna värden: xcrun (xcrun (inaktuell av Apple)), xcodebuild (xcodebuild arkiv och export). Standardvärde: xcodebuild.

Anger vilket verktyg som ska användas för att generera IPA.


archivePath - arkivsökväg
string. Valfritt. Använd när packageTool == xcodebuild.

Anger en katalog där skapade arkiv placeras.


exportPath - Exportera sökväg
string. Valfritt. Använd när packageTool == xcodebuild. Standardvärde: output/$(SDK)/$(Configuration).

Anger målet för den produkt som exporteras från arkivet.


exportOptions - Exportalternativ
string. Valfritt. Använd när packageTool == xcodebuild. Tillåtna värden: auto, plist, specify. Standardvärde: auto.

Anger ett sätt att skicka in Exportalternativ när du exporterar arkivet.


exportMethod - exportmetod
string. Krävs när exportOptions == specify. Standardvärde: development.

Anger vilken metod Xcode använder för att exportera arkivet. Till exempel app-store, package, ad-hoc, enterpriseeller development.


exportTeamId - team-ID
string. Valfritt. Använd när exportOptions == specify.

Anger det 10-siffriga team-ID för Apple Developer Portal som ska användas för exporten.


exportOptionsPlist - Lista över exportalternativ
string. Krävs när exportOptions == plist.

Anger sökvägen till en plist-fil som konfigurerar arkivexportering.


xcode8AutomaticSigning - automatisk signering
boolean. Standardvärde: false.

Använd dessa indata om du har ett Xcode 8- eller Xcode 9-projekt konfigurerat för automatisk signering.


teamId - team-ID
string. Valfritt. Använd när xcode8AutomaticSigning = true.

Anger det tiosiffriga utvecklarteam-ID:t. Detta krävs om du är medlem i flera utvecklingsteam.


signMethod - åsidosättning med hjälp av
string. Tillåtna värden: file (filinnehåll), id (identifierare). Standardvärde: file.

Använd dessa indata om bygget använder en signerings- eller etableringsmetod som skiljer sig från standardvärdet. Välj File Contents för att använda ett P12-certifikat och en etableringsprofil. Välj Identifiers för att hämta signeringsinställningar från standardnyckelringen och förinstallerade profiler. Lämna motsvarande fält tomma om du inte vill åsidosätta standardinställningarna för bygget.


iosSigningIdentity - signeringsidentitet
string. Valfritt. Använd när signMethod = id.

Anger den åsidosättning av signeringsidentitet som används för att signera bygget. Standardvärdet för Xcode-projektinställningen. Lås upp standardnyckelringen kan behöva väljas.


unlockDefaultKeychain - Låsa upp standardnyckelringen
boolean. Valfritt. Använd när signMethod = id. Standardvärde: false.

Löser användarinteraktion inte tillåts fel genom att låsa upp standardnyckelringen.


defaultKeychainPassword - standardnyckelringslösenord
string. Valfritt. Använd när signMethod = id.

Anger lösenordet för att låsa upp standardnyckelringen.


provProfileUuid - Etableringsprofil UUID
string. Valfritt. Använd när signMethod = id.

Anger UUID för en installerad etableringsprofil som ska användas för bygget. Använd separata bygguppgifter med olika scheman eller mål för att ange etableringsprofiler efter mål på en enda arbetsyta (iOS, WatchKit och tvOS).


p12 - P12-certifikatfil
string. Valfritt. Använd när signMethod = file.

Anger den relativa sökvägen till en PKCS12-formaterad P12-certifikatfil som innehåller ett signeringscertifikat som ska användas för bygget.


p12pwd - P12 Lösenord
string. Valfritt. Använd när signMethod = file.

Anger lösenordet till en P12-certifikatfil om det anges. Använd en byggvariabel för att kryptera.


provProfile - Etableringsprofilfil
string. Valfritt. Använd när signMethod = file.

Anger den relativa sökvägen till en fil som innehåller en åsidosättning av etableringsprofil som ska användas för bygget. Använd separata bygguppgifter med olika scheman eller mål för att ange etableringsprofiler efter mål på en enda arbetsyta (iOS, WatchKit och tvOS).


removeProfile - ta bort profil efter build-
boolean. Valfritt. Använd när signMethod = file. Standardvärde: false.

Tar bort innehållet i etableringsprofilfilen från byggagenten när bygget är klart. Kontrollera endast om du kör en agent per användare.


args - argument
string.

Anger ytterligare kommandoradsargument som används för att skapa. Den här indatan är användbar om du vill använda -target eller -project i stället för att ange en arbetsyta och ett schema.


cwd - Arbetskatalog
string.

Anger arbetskatalogen för byggkörningar. Standardvärdet är lagringsplatsens rot.


outputPattern - Utdatakatalog
string. Obligatoriskt. Standardvärde: output/$(SDK)/$(Configuration).

Anger den relativa sökväg där byggutdata (binärfiler) placeras.


xcodeDeveloperDir - Xcode Developer Path
string.

Valfritt. Anger sökvägen till mappen Xcode Developer om det inte är systemets standard. Används när flera versioner av Xcode är installerade i ett system. Till exempel: /Applications/Xcode 7.app/Contents/Developer.


useXcpretty - Använd xcpretty
boolean. Standardvärde: false.

Formaterar xcodebuild utdata och genererar en JUnit-testresultatrapport. Måste vara installerat på agentvärdar. Läs mer om xcpretty.


publishJUnitResults - Publicera till VSTS/TFS-
boolean. Standardvärde: false.

JUnit-testresultat som producerades med hjälp av xctool publiceras till VSTS/TFS.


useXctool - Använd xctool
boolean.

Använder xctool i stället för xcodebuild. Måste vara installerat på agentvärdar. Läs mer om xctool.
Obs!xctool är inaktuell och fungerar inte med Xcode 8.


xctoolReporter - xctool Test Reporter Format
string.

Testar det reporterformat som ska användas när åtgärden test anges och Använd xctool är markerad. Ange junit:output-file-path-here.xml för att generera ett filformat som är kompatibelt med uppgiften Publicera testresultat. När det anges läggs oformaterade automatiskt till. xctool måste installeras på agentvärdar. Läs mer om xctool.
Obs!xctool är inaktuell och fungerar inte med Xcode 8.


Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Ingen.

Krav

Krav Beskrivning
Pipelinetyper YAML, klassisk version
Körs på Agent, DeploymentGroup
kräver Lokalt installerade agenter måste ha funktioner som matchar följande kräver att köra jobb som använder den här uppgiften: xcode
funktioner Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar Vilken som helst
variabler som kan Vilken som helst
Agentversion Alla agentversioner som stöds.
Aktivitetskategori Skapa