Share via


Xcode@4 - Xcode v4-taak

Gebruik deze taak om een Xcode-werkruimte in macOS te bouwen, testen of archiveren en eventueel een app te verpakken.

Syntax

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

Invoerwaarden

actions - Acties
string. Vereist. Standaardwaarde: build.

Hiermee geeft u een door spaties gescheiden lijst met acties op. Geldige opties zijn build, clean, test, analyzeen archive. Voert bijvoorbeeldclean build een schone build uit. Zie apple: bouwen vanaf de opdrachtregel met veelgestelde vragen over Xcode.


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

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


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

Hiermee geeft u een SDK op die moet worden gebruikt bij het bouwen van het Xcode-project of de werkruimte. Voer in de macOS Terminal-toepassing uit xcodebuild -showsdks om de geldige lijst met SDK's weer te geven. Wanneer u een variabele gebruikt, geeft u een waarde op (bijvoorbeeld iphonesimulator) op het tabblad Variabelen .


xcWorkspacePath - Werkruimte- of projectpad
string. Standaardwaarde: **/*.xcodeproj/project.xcworkspace.

Optioneel. Hiermee geeft u een relatief pad op van de hoofdmap van de opslagplaats naar de Xcode-werkruimte of het Xcode-project. Als u een waarde opgeeft, moet u ook het schema opgeven. Geef geen waarde op als u opgeeft -target flag in Geavanceerde argumenten. Bijvoorbeeld MyApp/MyApp.xcworkspace of MyApp/MyApp.xcodeproj.


scheme - Regeling
string.

Optioneel. Hiermee geeft u een Xcode-schemanaam op. Moet een gedeeld schema zijn (gedeeld selectievakje onder Beheerde schema's in Xcode). Als u geen schema opgeeft en de opgegeven werkruimte één gedeeld schema heeft, wordt het werkruimteschema gebruikt.


xcodeVersion - Xcode-versie
string. Toegestane waarden: 8 (Xcode 8), 9 (Xcode 9), default, specifyPath (Pad opgeven). Standaardwaarde: default.

Hiermee geeft u de doelversie van Xcode. Selecteer Default om de standaardversie van Xcode op de agentcomputer te gebruiken. Het opgeven van een versienummer (bijvoorbeeld Xcode 9) is afhankelijk van de locatie van de versie die moet worden ingesteld door omgevingsvariabelen op de agentcomputer (bijvoorbeeld XCODE_9_DEVELOPER_DIR=/Applications/Xcode_9.0.0.app/Contents/Developer). Selecteer Specify path om een specifiek pad naar de Xcode-ontwikkelaarsmap op te geven.


xcodeDeveloperDir - Xcode-ontwikkelaarspad
string. Optioneel. Gebruik wanneer xcodeVersion == specifyPath.

Hiermee geeft u een pad naar een specifieke Xcode-ontwikkelaarsmap (bijvoorbeeld /Applications/Xcode_9.0.0.app/Contents/Developer). Deze invoer is handig wanneer meerdere versies van Xcode zijn geïnstalleerd op de agentcomputer.


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

Hiermee geeft u op of een IPA-app-pakketbestand moet worden gegenereerd als onderdeel van de build.


archivePath - Archiefpad
string. Optioneel. Gebruik wanneer packageApp == true.

Hiermee geeft u een map op waar gemaakte archieven worden geplaatst.


exportPath - Exportpad
string. Optioneel. Gebruik wanneer packageApp == true. Standaardwaarde: output/$(SDK)/$(Configuration).

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


exportOptions - Exportopties
string. Optioneel. Gebruik wanneer packageApp == true. Toegestane waarden: auto (Automatisch), plist, specify. Standaardwaarde: auto.

Hiermee geeft u opties voor het exporteren van het archief. Wanneer de standaardwaarde van Automatic is geselecteerd, wordt de exportmethode automatisch gedetecteerd in het archief. Selecteer Plist om een plist-bestand met exportopties op te geven. Selecteer Specify om een specifieke exportmethode en team-id op te geven.


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

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


exportTeamId - Team-id
string. Optioneel. Gebruik wanneer exportOptions == specify.

Hiermee geeft u de team-id van 10 tekens van de Apple Developer Portal op die tijdens het exporteren moet worden gebruikt.


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

Hiermee geeft u het pad op naar het plist-bestand dat opties bevat die tijdens het exporteren moeten worden gebruikt.


exportArgs - Argumenten exporteren
string. Optioneel. Gebruik wanneer packageApp == true.

Hiermee geeft u aanvullende opdrachtregelargumenten die worden gebruikt tijdens het exporteren.


signingOption - Ondertekeningsstijl
string. Toegestane waarden: nosign (Geen code ondertekenen), default (standaardinstellingen voor Project), manual (Handmatige ondertekening), auto (Automatische ondertekening). Standaardwaarde: nosign.

Hiermee geeft u de methode voor het ondertekenen van de build. Selecteer Do not code sign om ondertekening uit te schakelen. Selecteer Project defaults om alleen de ondertekeningsconfiguratie van het project te gebruiken. Selecteer Manual signing deze optie om handmatige ondertekening af te dwingen en eventueel een ondertekenings-identiteit en inrichtingsprofiel op te geven. Selecteer Automatic signing deze optie om automatische ondertekening af te dwingen en geef eventueel een id van het ontwikkelteam op. Als uw project moet worden ondertekend, gebruikt u de taken Apple installeren... om certificaten en inrichtingsprofielen vóór de Xcode-build te installeren.


signingIdentity - Ondertekeningsidentiteit
string. Optioneel. Gebruik wanneer signingOption = manual.

Hiermee geeft u een ondertekeningsidentiteit op waarmee de build moet worden ondertekend. Mogelijk moet de standaardsleutelhanger op de agentcomputer worden ontgrendeld. Als er geen waarde wordt ingevoerd, wordt de instelling van het Xcode-project gebruikt.


provisioningProfileUuid - UUID van inrichtingsprofiel
string. Optioneel. Gebruik wanneer signingOption = manual.

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


teamId - Team-id
string. Optioneel. Gebruik wanneer signingOption = auto.

Vereist als u lid bent van meerdere ontwikkelteams. Hiermee geeft u de id van het ontwikkelteam van 10 tekens op.


destinationPlatformOption - Doelplatform
string. Toegestane waarden: default, iOS (iOS en watchOS), tvOS, macOS, custom. Standaardwaarde: default.

Hiermee geeft u het platform van het doelapparaat op dat wordt gebruikt voor het testen van de gebruikersinterface wanneer het algemene build-apparaat niet geldig is. Kies Custom ervoor om een platform op te geven dat niet in de lijst is opgenomen. Wanneer Default is geselecteerd, worden er geen simulators of apparaten gebruikt.


destinationPlatform - Aangepast doelplatform
string. Optioneel. Gebruik wanneer destinationPlatformOption == custom.

Hiermee geeft u het platform van een doelapparaat op dat wordt gebruikt voor het testen van de gebruikersinterface wanneer het algemene build-apparaat niet geldig is.


destinationTypeOption - Doeltype
string. Optioneel. Gebruik wanneer destinationPlatformOption != default && destinationPlatformOption != macOS. Toegestane waarden: simulators (Simulator), devices (Verbonden apparaat). Standaardwaarde: simulators.

Hiermee geeft u het doeltype op dat wordt gebruikt voor het testen van de gebruikersinterface. Apparaten moeten zijn verbonden met de Mac die de build uitvoert via een kabel- of netwerkverbinding. Zie Apparaten en simulators in Xcode voor meer informatie.


destinationSimulators - Simulator
string. Optioneel. Gebruik wanneer destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Standaardwaarde: iPhone 7.

Hiermee geeft u de naam van een Xcode-simulator op die wordt gebruikt voor het testen van de gebruikersinterface. Bijvoorbeeld iPhone X (iOS en watchOS) of Apple TV 4K (tvOS). Een optionele doelversie van het besturingssysteem kan worden opgegeven in de indeling OS=<versionNumber>, zoals iPhone X,OS=11.1. Meer informatie over geïnstalleerde simulators op de gehoste macOS Preview-agent.


destinationDevices - Apparaat
string. Optioneel. Gebruik wanneer destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices.

Hiermee geeft u de naam op van het apparaat dat wordt gebruikt voor het testen van de gebruikersinterface, zoals Raisa's iPad.


args - Argumenten
string.

Optioneel. Hiermee geeft u aanvullende opdrachtregelargumenten op waarmee moet worden gebouwd. Deze invoer is handig voor het -target opgeven van of -project argumenten in plaats van een werkruimte/project en schema. Zie apple: bouwen vanaf de opdrachtregel met veelgestelde vragen over Xcode.


workingDirectory - Werkmap
Invoeralias: cwd. string.

Optioneel. Hiermee geeft u de werkmap waarin de build moet worden uitgevoerd. Als er geen waarde wordt ingevoerd, wordt de hoofdmap van de opslagplaats gebruikt.


outputPattern - Uitvoermap
string.

Optioneel. Hiermee geeft u een relatief pad naar de werkmap waar build-uitvoer (binaire bestanden) wordt geplaatst. Bijvoorbeeld: output/$(SDK)/$(Configuration) of output/$(TestSDK)/$(TestConfiguration). Archief- en exportpaden worden afzonderlijk geconfigureerd. Geef waarden op het tabblad Variabelen op.


useXcpretty - xcpretty gebruiken
boolean. Standaardwaarde: false.

Hiermee geeft u op of de uitvoer moet worden xcodebuild opgemaakt xcpretty en worden JUnit-testresultaten gegenereerd. xcpretty moet worden geïnstalleerd op de agentcomputer (deze is vooraf geïnstalleerd op door VSTS gehoste buildagents). Zie xcpretty voor meer informatie.


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

Als xcpretty is ingeschakeld, geeft deze invoer aan of de JUnit-testresultaten moeten worden gepubliceerd naar VSTS/TFS.


Opties voor taakbeheer

Alle taken hebben naast de taakinvoer besturingsopties. Zie Opties voor besturingselementen en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

Opmerkingen

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

Voorbeelden

Vereisten

Vereiste Beschrijving
Pijplijntypen YAML, klassieke build
Wordt uitgevoerd op Agent, DeploymentGroup
Eisen Zelf-hostende agents moeten mogelijkheden hebben die voldoen aan de volgende vereisten om taken uit te voeren die gebruikmaken van deze taak: xcode
Functies Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen Alle
Instelbare variabelen Alle
Agentversie Alle ondersteunde agentversies.
Taakcategorie Build