Xcode@4 - Tarefa do Xcode v4

2025-06-24

Use esta tarefa para criar, testar ou arquivar um workspace do Xcode no macOS e, opcionalmente, empacotar um aplicativo.

Sintaxe

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

Entradas

ações actions -
string. Obrigatório Valor padrão: build.

Especifica uma lista delimitada por espaço de ações. As opções válidas são build, clean, test, analyze e archive. Por exemplo,clean build executa uma compilação limpa. Consulte o Apple: compilando a partir da linha de comando com perguntas frequentes do Xcode.

de Configuração do configuration -
string. Valor padrão: $(Configuration).

Especifica a configuração de projeto ou workspace do Xcode a ser compilada. Ao usar uma variável, especifique um valor (por exemplo, Release) na guia variáveis.

sdk - do SDK
string. Valor padrão: $(SDK).

Especifica um SDK a ser usado ao criar o projeto ou workspace do Xcode. No aplicativo macOS Terminal, execute xcodebuild -showsdks para exibir a lista válida de SDKs. Ao usar uma variável, especifique um valor (por exemplo, iphonesimulator) na guia variáveis.

xcWorkspacePath - Espaço de trabalho ou caminho do projeto
string. Valor padrão: **/*.xcodeproj/project.xcworkspace.

Opcional. Especifica um caminho relativo da raiz do repositório para o workspace ou projeto do Xcode. Se você especificar um valor, também deverá especificar o esquema. Não especifique um valor se você estiver especificando -target flag em Argumentos Avançados. Por exemplo, MyApp/MyApp.xcworkspace ou MyApp/MyApp.xcodeproj.

esquema scheme -
string.

Opcional. Especifica um nome de esquema do Xcode. Deve ser um esquema compartilhado (caixa de seleção compartilhada em Esquemas Gerenciados no Xcode). Se você não especificar um esquema e a área de trabalho especificada tiver um único esquema compartilhado, o esquema de área de trabalho será usado.

xcodeVersion - Versão do Xcode
string. Valores permitidos: 8 (Xcode 8), 9 (Xcode 9), default, specifyPath (Especificar caminho). Valor padrão: default.

Especifica a versão de destino do Xcode. Selecione Default para usar a versão padrão do Xcode no computador do agente. A especificação de um número de versão (por exemplo, Xcode 9) depende do local da versão a ser definida por variáveis de ambiente na máquina do agente (por exemplo, XCODE_9_DEVELOPER_DIR=/Applications/Xcode_9.0.0.app/Contents/Developer). Selecione Specify path para fornecer um caminho específico para o diretório de desenvolvedor do Xcode.

xcodeDeveloperDir - Caminho do desenvolvedor do Xcode
string. Opcional. Use quando xcodeVersion == specifyPath.

Especifica um caminho para um diretório de desenvolvedor Xcode específico (por exemplo, /Applications/Xcode_9.0.0.app/Contents/Developer). Essa entrada é útil quando várias versões do Xcode são instaladas no computador do agente.

packageApp - Criar pacote de aplicativo
boolean. Valor padrão: false.

Especifica se um arquivo de pacote de aplicativo IPA deve ser gerado como parte do build.

archivePath - Caminho do arquivo
string. Opcional. Use quando packageApp == true.

Especifica um diretório em que os arquivos criados são colocados.

exportPath - Caminho de exportação
string. Opcional. Use quando packageApp == true. Valor padrão: output/$(SDK)/$(Configuration).

Especifica o destino do produto exportado do arquivo morto.

exportOptions - Opções de exportação
string. Opcional. Use quando packageApp == true. Valores permitidos: auto (Automático), plist, specify. Valor padrão: auto.

Especifica as opções para exportar o arquivo. Quando o valor padrão de é selecionado, o método de Automatic exportação é detectado automaticamente no arquivo. Selecione Plist para especificar um arquivo plist contendo opções de exportação. Selecione Specify para fornecer um método de exportação específico e uma ID da equipe.

exportMethod - Método de exportação
string. Necessário quando exportOptions == specify. Valor padrão: development.

Especifica o método que o Xcode usa para exportar o arquivo. Por exemplo app-store, package, ad-hoc, enterprise ou development.

exportTeamId - ID da equipe
string. Opcional. Use quando exportOptions == specify.

Especifica a ID da equipe de 10 caracteres do Portal do Desenvolvedor da Apple a ser usada durante a exportação.

exportOptionsPlist - Opções de exportação plist
string. Necessário quando exportOptions == plist.

Especifica o caminho para o arquivo plist que contém opções a serem usadas durante a exportação.

exportArgs - Exportar argumentos
string. Opcional. Use quando packageApp == true.

Especifica argumentos de linha de comando adicionais usados durante a exportação.

signingOption - Estilo de assinatura
string. Valores permitidos: nosign (Não codificar sinal), default (Padrões do projeto), manual (Assinatura manual), auto (Assinatura automática). Valor padrão: nosign.

Especifica o método de assinatura do build. Selecione Do not code sign para desativar a assinatura. Selecione Project defaults para usar apenas a configuração de assinatura do projeto. Selecione Manual signing para forçar a assinatura manual e, opcionalmente, especifique uma identidade de assinatura e um perfil de provisionamento. Selecione Automatic signing para forçar a assinatura automática e, opcionalmente, especifique uma ID da equipe de desenvolvimento. Se o seu projeto exigir assinatura, use as tarefas Instalar Apple... para instalar certificados e perfis de provisionamento antes da compilação do Xcode.

signingIdentity - Identidade de assinatura
string. Opcional. Use quando signingOption = manual.

Especifica uma substituição de identidade de assinatura com a qual assinar a compilação. Pode ser necessário desbloquear o conjunto de chaves padrão no computador do agente. Se nenhum valor for inserido, a configuração do projeto Xcode será usada.

provisioningProfileUuid - UUID do perfil de provisionamento
string. Opcional. Use quando signingOption = manual.

Especifica o UUID de um perfil de provisionamento instalado usado para a compilação. Use tarefas de build separadas com diferentes esquemas ou destinos para especificar perfis de provisionamento por destino em um único workspace (iOS, tvOS, watchOS).

teamId - ID da equipe
string. Opcional. Use quando signingOption = auto.

Obrigatório se você for membro de várias equipes de desenvolvimento. Especifica a ID da equipe de desenvolvimento de 10 caracteres.

destinationPlatformOption - Plataforma de destino
string. Valores permitidos: default, iOS (iOS e watchOS), tvOS, macOS, custom. Valor padrão: default.

Especifica a plataforma do dispositivo de destino usada para teste de interface do usuário quando o dispositivo de build genérico não é válido. Escolha Custom especificar uma plataforma não incluída na lista. Quando Default é selecionado, nenhum simulador ou dispositivo é direcionado.

destinationPlatform - Plataforma de destino personalizada
string. Opcional. Use quando destinationPlatformOption == custom.

Especifica a plataforma de um dispositivo de destino usada para teste de interface do usuário quando o dispositivo de build genérico não é válido.

destinationTypeOption - Tipo de destino
string. Opcional. Use quando destinationPlatformOption != default && destinationPlatformOption != macOS. Valores permitidos: simulators (Simulador), devices (Dispositivo conectado). Valor padrão: simulators.

Especifica o tipo de destino usado para teste de interface do usuário. Os dispositivos devem estar conectados ao Mac que executa a compilação por meio de um cabo ou conexão de rede. Consulte Dispositivos e simuladores no Xcode para obter mais informações.

destinationSimulators - Simulador
string. Opcional. Use quando destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Valor padrão: iPhone 7.

Especifica um nome de simulador do Xcode usado para teste de interface do usuário. Por exemplo, iPhone X (iOS e watchOS) ou Apple TV 4K (tvOS). Uma versão opcional do sistema operacional de destino pode ser especificada no formato OS=<versionNumber>, como iPhone X,OS=11.1. Saiba mais sobre os simuladores instalados no agente de visualização do macOS hospedado.

destinationDevices - Dispositivo
string. Opcional. Use quando destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices.

Especifica o nome do dispositivo usado para teste de interface do usuário, como Raisa's iPad.

argumentos args -
string.

Opcional. Especifica argumentos de linha de comando adicionais com os quais construir. Essa entrada é útil para especificar -target argumentos or -project em vez de um espaço de trabalho/projeto e esquema. Consulte o Apple: compilando a partir da linha de comando com perguntas frequentes do Xcode.

do diretório de trabalho do
Alias de entrada: cwd. string.

Opcional. Especifica o diretório de trabalho no qual executar a compilação. Se nenhum valor for inserido, a raiz do repositório será usada.

do diretório de saída do outputPattern -
string.

Opcional. Especifica um caminho relativo para o diretório de trabalho em que a saída de build (binários) é colocada. Por exemplo: output/$(SDK)/$(Configuration) ou output/$(TestSDK)/$(TestConfiguration). Os caminhos de arquivamento e exportação são configurados separadamente. Especifique valores na guia Variáveis.

useXcpretty - Usar xcpretty
boolean. Valor padrão: false.

Especifica se deve ser usado xcpretty para formatar xcodebuild a saída e gera resultados de teste JUnit. xcpretty deve ser instalado no computador do agente (ele é pré-instalado em agentes de compilação hospedados no VSTS). Consulte xcpretty para obter mais informações.

publishJUnitResults - Publicar resultados de teste no VSTS/TFS
boolean. Valor padrão: false.

Se xcpretty estiver habilitado, essa entrada especificará se os resultados do teste JUnit devem ser publicados no VSTS/TFS.

Opções de controle de tarefa

Todas as tarefas têm opções de controle além das suas entradas de tarefas. Para obter mais informações, consulte as opções de Controle de e as propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Observações

Use essa tarefa para criar um workspace do Xcode no macOS.

Exemplos

Criar, testar e implantar aplicativos Xcode

Requisitos

Requisito	Descrição
Tipos de pipeline	YAML, build clássico
Execuções em	Agent, DeploymentGroup
de demandas	Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas de para executar trabalhos que usam esta tarefa: xcode
recursos	Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando	Qualquer
variáveis settable	Qualquer
Versão do agente	Todas as versões de agente com suporte.
Categoria de tarefa	Construir