Xcode@5 - Tarefa Xcode v5

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

Syntax

# 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

actions - Ações
string. Obrigatórios. Valor padrão: build.

Especifica uma lista de ações delimitada por espaço. Algumas opções válidas são build, clean, test, analyzee archive. Por exemplo,clean build executa um build limpo. Confira Apple: compilando a partir da linha de comando com perguntas frequentes sobre o Xcode.

configuration - Configuração
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 - SDK
string. Valor padrão: $(SDK).

Especifica um SDK a ser usado ao criar o projeto ou workspace do Xcode. No aplicativo terminal do macOS, 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 - Workspace ou caminho do projeto
string. Valor padrão: **/*.xcodeproj/project.xcworkspace.

Opcional. Especifica um caminho relativo da raiz do repositório para o projeto ou workspace do Xcode. Por exemplo, MyApp/MyApp.xcworkspace ou MyApp/MyApp.xcodeproj. Caracteres curinga podem ser usados. Saiba mais sobre padrões de correspondência de arquivos.

scheme - Esquema
string.

Opcional. Especifica um nome de esquema Xcode. Deve ser um esquema compartilhado (caixa de seleção compartilhada em Esquemas Gerenciados no Xcode). Se você não especificar um esquema e o workspace especificado tiver um único esquema compartilhado, o esquema de workspace 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. Especificar um número de versão (por exemplo, Xcode 9) depende do local da versão a ser definido por variáveis de ambiente no computador 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 do desenvolvedor do Xcode.

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

Especifica um caminho para um diretório de desenvolvedor específico do Xcode (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 do aplicativo
boolean. Valor padrão: false.

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

archivePath - Caminho do arquivo morto
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 opções para exportar o arquivo morto. Quando o valor padrão de Automatic é selecionado, o método de exportação é detectado automaticamente no arquivo morto. Selecione Plist para especificar um arquivo plist que contém opções de exportação. Selecione Specify para fornecer um método de Exportação e uma ID de Equipe específicos.

exportMethod - Método Export
string. Obrigatório quando exportOptions == specify. Valor padrão: development.

Especifica o método que o Xcode usa para exportar o arquivo morto. 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. Obrigató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 assinar código), default (padrões do Project), 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 desabilitar 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 de equipe de desenvolvimento. Se o projeto exigir assinatura, use as tarefas Instalar Apple... para instalar certificados e perfis de provisionamento antes do build do Xcode.

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

Especifica uma substituição de identidade de assinatura com a qual assinar o build. Pode ser necessário desbloquear o keychain 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 a UUID de um perfil de provisionamento instalado usado para o build. Use tarefas de build separadas com esquemas ou destinos diferentes 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 o build. Se especificado, isso terá precedência sobre o perfil de provisionamento UUID. Use tarefas de build separadas com esquemas ou destinos diferentes para especificar perfis de provisionamento por destino em um único workspace (iOS, tvOS, watchOS).

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

Necessá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 dispositivos são direcionados.

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 executando a compilação por meio de uma conexão de rede ou cabo. 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 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. Confira esta lista de simuladores instalados no agente 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, há suporte para apenas um dispositivo. Observe que a Apple não permite apóstrofos (') em nomes de dispositivos. Em vez disso, as aspas simples direitas (') podem ser usadas.

args - Argumentos
string.

Opcional. Especifica argumentos de linha de comando adicionais com os quais compilar. Essa entrada é útil para especificar -target argumentos ou -project em vez de um workspace/projeto e esquema. Confira Apple: compilando a partir da linha de comando com perguntas frequentes sobre o Xcode.

workingDirectory - Diretório de trabalho
Alias de entrada: cwd. string.

Opcional. Especifica o diretório de trabalho no qual executar o build. 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 em agentes de build hospedados no 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 habilitada, essa entrada especificará argumentos para xcpretty. Confira 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 que seja habilitado para gerar resultados de teste do JUnit.

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

Se xcpretty e publishJUnitResults estiverem habilitados, 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 Opções de controle e propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Comentários

Use essa 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, Extensão de Aplicativo do iOS).

Exemplos

Criar seu aplicativo Xcode

Requisitos

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