Xcode@5 – Tarefa do Xcode v5

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

Sintaxe

# Xcode v5
# Build, test, or archive an Xcode workspace on macOS. Optionally package an app.
- task: Xcode@5
  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' | '10' | '11' | '12' | '13' | '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. 
    #provisioningProfileName: # string. Optional. Use when signingOption = manual. Provisioning profile name. 
    #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: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Simulator. 
    #destinationDevices: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices. Device. 
  # Advanced
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #useXcpretty: true # boolean. Use xcpretty. Default: true.
    #xcprettyArgs: # string. Optional. Use when useXcpretty == true. Xcpretty arguments. 
    #publishJUnitResults: false # boolean. Publish test results to Azure Pipelines. Default: false.
    #testRunTitle: # string. Optional. Use when publishJUnitResults == true. Test run title.

Entradas

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

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

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. Por exemplo, MyApp/MyApp.xcworkspace ou MyApp/MyApp.xcodeproj. Curingas podem ser usados. Saiba mais sobre padrões de correspondência de arquivos.

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), 10 (Xcode 10), 11 (Xcode 11), 12 (Xcode 12), 13 (Xcode 13), 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 é 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).

provisioningProfileName - Nome do perfil de provisionamento
string. Opcional. Use quando signingOption = manual.

Especifica o nome de um perfil de provisionamento instalado usado para a compilação. Se especificado, isso tem precedência sobre o UUID do perfil de provisionamento. 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 nesta 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. Escolha Custom especificar uma plataforma não incluída na lista. Quando Default selecionado, nenhum simulador nem dispositivo é direcionado.

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 a ser 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.

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. Consulte esta lista de simuladores instalados no agente do macOS hospedado para obter mais informações.

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. No momento, apenas um dispositivo é compatível. Observe que a Apple não permite apóstrofos (') em nomes de dispositivos. Em vez disso, aspas simples à direita (') podem ser usadas.

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 Apple: compilando a partir da linha de comando com o Xcode FAQ.

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.

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

Especifica se deve ser usado xcpretty para formatar xcodebuild a saída. xcpretty deve ser instalado no computador do agente (ele é pré-instalado nos agentes de build hospedados do Azure Pipelines). Se xcpretty não estiver instalado, a saída bruta xcodebuild será mostrada. Consulte xcpretty para obter mais informações.

xcprettyArgs - Argumentos Xcpretty
string. Opcional. Use quando useXcpretty == true.

Se xcpretty estiver habilitado, essa entrada especificará argumentos para xcpretty. Veja uma lista de argumentos xcpretty no GitHub.

publishJUnitResults - Publicar resultados de teste no Azure Pipelines
boolean. Valor padrão: false.

Especifica se os resultados do teste JUnit devem ser publicados no Azure Pipelines. Isso requer xcpretty ser habilitado para gerar resultados de teste JUnit.

testRunTitle - Título da execução de teste
string. Opcional. Use quando publishJUnitResults == true.

Se xcpretty e publishJUnitResults estiverem ativados, você poderá especificar o título da execução de teste.

Opções de controle de tarefa

Todas as tarefas têm opções de controle além de suas entradas de tarefa. 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 esta tarefa para criar, testar ou arquivar um workspace do Xcode no macOS e, opcionalmente, empacotar um aplicativo.

Usando vários perfis de provisionamento

Atualmente, não há suporte para vários perfis de provisionamento para a tarefa Xcode (por exemplo, para a Extensão de Aplicativo iOS).

Exemplos

Criar seu aplicativo 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