Delen via

Xcode@2 - Xcode Build v2-taak

  • Artikel

Gebruik deze taak om een Xcode-werkruimte te bouwen in macOS.

Syntaxis

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

Invoer

actions - acties
string. Verplicht. Standaardwaarde: build.

Hiermee geeft u een door spaties gescheiden lijst met acties op. Geldige opties zijnbuild, , , cleanen testanalyzearchive. build clean voert bijvoorbeeld een schone build uit. Zie de Apple: Bouwen vanaf de opdrachtregel met Xcode FAQ.


configuration - configuratie
string. Standaardwaarde: $(Configuration).

Hiermee geeft u de Xcode-project- of werkruimteconfiguratie op die moet worden gebouwd. Wanneer u een variabele gebruikt, geeft u een waarde op (bijvoorbeeld Release) op het tabblad Variabelen.


sdk - SDK-
string. Standaardwaarde: $(SDK).

Hiermee wordt een Xcode-project of werkruimte gebouwd op basis van de opgegeven SDK. Voer xcodebuild -showsdks uit om een geldige lijst met SDK's te zien.


xcWorkspacePath - werkruimte/projectpad
string. Standaardwaarde: **/*.xcodeproj/*.xcworkspace.

Facultatief. Hiermee geeft u het relatieve pad van de hoofdmap van de opslagplaats naar de Xcode-werkruimte of het project. Bijvoorbeeld: MyApp/MyApp.xcworkspace of MyApp/MyApp.xcworkspace/MyApp.xcodeproj.
Laat leeg als u -target flag wilt gebruiken onder Geavanceerde argumenten.


scheme -
string.

Facultatief. Hiermee geeft u de naam van het Xcode-schema. Moet een gedeeld schema zijn (gedeeld selectievakje onder Beheerde schema's in Xcode). Vereist als werkruimte is opgegeven.


packageApp - App-pakket maken
boolean. Standaardwaarde: true.

Hiermee geeft u op of een IPA wordt gegenereerd als onderdeel van de build. Raadpleeg aanvullende invoer in de sectie Pakketopties voor het exporteren van archieven met Xcode 7 en Xcode 8.


packageTool - IPA (Create Package) met behulp van
string. Verplicht. Toegestane waarden: xcrun (xcrun (afgeschaft door Apple)), xcodebuild (xcodebuild archive en export). Standaardwaarde: xcodebuild.

Hiermee geeft u het hulpprogramma dat moet worden gebruikt voor het genereren van de IPA.


archivePath - archiefpad
string. Facultatief. Gebruiken wanneer packageTool == xcodebuild.

Hiermee geeft u een map waarin gemaakte archieven worden geplaatst.


exportPath - pad exporteren
string. Facultatief. Gebruiken wanneer packageTool == xcodebuild. Standaardwaarde: output/$(SDK)/$(Configuration).

Hiermee geeft u de bestemming voor het product dat uit het archief is geëxporteerd.


exportOptions - exportopties
string. Facultatief. Gebruiken wanneer packageTool == xcodebuild. Toegestane waarden: auto, plist, specify. Standaardwaarde: auto.

Hiermee geeft u een manier om exportopties door te geven bij het exporteren van het archief.


exportMethod - exportmethode
string. Vereist wanneer exportOptions == specify. Standaardwaarde: development.

Hiermee geeft u de methode Xcode die wordt gebruikt om het archief te exporteren. Bijvoorbeeld: app-store, package, ad-hoc, enterpriseof development.


exportTeamId - team-id
string. Facultatief. Gebruiken wanneer exportOptions == specify.

Hiermee geeft u de team-id voor Apple Developer Portal 10 cijfers op die moet worden gebruikt voor de export.


exportOptionsPlist - Plist- voor exportopties
string. Vereist wanneer exportOptions == plist.

Hiermee geeft u het pad naar een plist-bestand waarmee archiefexport wordt geconfigureerd.


xcode8AutomaticSigning - automatische ondertekening
boolean. Standaardwaarde: false.

Gebruik deze invoer als u een Xcode 8- of Xcode 9-project hebt geconfigureerd voor automatische ondertekening.


teamId - team-id
string. Facultatief. Gebruiken wanneer xcode8AutomaticSigning = true.

Hiermee geeft u de team-id van tien cijfers voor ontwikkelaars op. Dit is vereist als u lid bent van meerdere ontwikkelteams.


signMethod - overschrijven met behulp van
string. Toegestane waarden: file (bestandsinhoud), id (id's). Standaardwaarde: file.

Gebruik deze invoer als de build gebruikmaakt van een ondertekenings- of inrichtingsmethode die anders is dan de standaardwaarde. Kies File Contents om een P12-certificaat en inrichtingsprofiel te gebruiken. Kies Identifiers om ondertekeningsinstellingen op te halen uit de standaardsleutelhanger en vooraf geïnstalleerde profielen. Laat de bijbehorende velden leeg als u de standaard build-instellingen niet wilt overschrijven.


iosSigningIdentity - handtekeningidentiteit
string. Facultatief. Gebruiken wanneer signMethod = id.

Hiermee geeft u de ondertekeningsidentiteit die wordt gebruikt om de build te ondertekenen. Standaard ingesteld op de Xcode-projectinstelling. Standaardsleutelhanger ontgrendelen mogelijk moet worden geselecteerd.


unlockDefaultKeychain - Standaardsleutelhanger ontgrendelen
boolean. Facultatief. Gebruiken wanneer signMethod = id. Standaardwaarde: false.

Hiermee wordt gebruikersinteractie niet toegestaan fouten door de standaardsleutelhanger te ontgrendelen.


defaultKeychainPassword - standaardsleutelhangerwachtwoord
string. Facultatief. Gebruiken wanneer signMethod = id.

Hiermee geeft u het wachtwoord voor het ontgrendelen van de standaardsleutelhanger.


provProfileUuid - UUID- voor inrichtingsprofielen
string. Facultatief. Gebruiken wanneer signMethod = id.

Hiermee geeft u de UUID van een geïnstalleerd inrichtingsprofiel dat moet worden gebruikt voor de build. Gebruik afzonderlijke buildtaken met verschillende schema's of doelen om inrichtingsprofielen op doel in één werkruimte op te geven (iOS, WatchKit, tvOS).


p12 - P12-certificaatbestand
string. Facultatief. Gebruiken wanneer signMethod = file.

Hiermee geeft u het relatieve pad naar een P12-certificaatbestand met PKCS12-indeling dat een handtekeningcertificaat bevat dat moet worden gebruikt voor de build.


p12pwd - P12-wachtwoord
string. Facultatief. Gebruiken wanneer signMethod = file.

Hiermee geeft u het wachtwoord voor een P12-certificaatbestand op, indien opgegeven. Gebruik een buildvariabele om te versleutelen.


provProfile - inrichtingsprofielbestand
string. Facultatief. Gebruiken wanneer signMethod = file.

Hiermee geeft u het relatieve pad naar een bestand met een onderdrukking van een inrichtingsprofiel moet worden gebruikt voor de build. Gebruik afzonderlijke buildtaken met verschillende schema's of doelen om inrichtingsprofielen op doel in één werkruimte op te geven (iOS, WatchKit, tvOS).


removeProfile - Profiel verwijderen na build
boolean. Facultatief. Gebruiken wanneer signMethod = file. Standaardwaarde: false.

Hiermee verwijdert u de inhoud van het inrichtingsprofielbestand uit de buildagent nadat de build is voltooid. Controleer alleen of u één agent per gebruiker uitvoert.


args - argumenten
string.

Hiermee geeft u aanvullende opdrachtregelargumenten op die worden gebruikt om te bouwen. Deze invoer is handig als u -target of -project wilt gebruiken in plaats van een werkruimte en schema op te geven.


cwd - werkmap
string.

Hiermee geeft u de werkmap voor build-uitvoeringen. De standaardinstelling is de hoofdmap van de opslagplaats.


outputPattern - uitvoermap
string. Verplicht. Standaardwaarde: output/$(SDK)/$(Configuration).

Hiermee geeft u het relatieve pad waarin build-uitvoer (binaire bestanden) worden geplaatst.


xcodeDeveloperDir - Xcode Developer Path
string.

Facultatief. Hiermee geeft u het pad naar de map Xcode Developer op als dit niet de systeemstandaard is. Voor gebruik wanneer meerdere versies van Xcode op een systeem zijn geïnstalleerd. Voorbeeld: /Applications/Xcode 7.app/Contents/Developer.


useXcpretty - xcpretty- gebruiken
boolean. Standaardwaarde: false.

Hiermee wordt xcodebuild uitvoer opgemaakt en wordt een rapport met JUnit-testresultaten gegenereerd. Moet worden geïnstalleerd op agenthosts. Meer informatie over xcpretty.


publishJUnitResults - publiceren naar VSTS/TFS-
boolean. Standaardwaarde: false.

JUnit-testresultaten die zijn geproduceerd met xctool worden gepubliceerd naar VSTS/TFS.


useXctool - xctool gebruiken
boolean.

Gebruikt xctool in plaats van xcodebuild. Moet worden geïnstalleerd op agenthosts. Meer informatie over xctool.
Opmerking:xctool is afgeschaft en werkt niet met Xcode 8.


xctoolReporter - xctool Test Reporter Format
string.

Test de indeling van de rapportrapporteur die moet worden gebruikt wanneer de testactie is opgegeven en xctool gebruiken is ingeschakeld. Geef junit:output-file-path-here.xml op om een bestandsindeling te genereren die compatibel is met de taak Testresultaten publiceren. Wanneer dit is opgegeven, wordt automatisch toegevoegd. xctool moet worden geïnstalleerd op agenthosts. Meer informatie over xctool.
Opmerking:xctool is afgeschaft en werkt niet met Xcode 8.


Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Vereisten

Voorwaarde Beschrijving
Pijplijntypen YAML, klassieke build
Wordt uitgevoerd op Agent, DeploymentGroup
eisen Zelf-hostende agents moeten mogelijkheden hebben die overeenkomen met de volgende eisen taken uit te voeren die gebruikmaken van deze taak: xcode
mogelijkheden Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen Welk dan ook
variabelen instellen Welk dan ook
Agentversie Alle ondersteunde agentversies.
Taakcategorie Bouwen