Xcode@2 - Tarefa Xcode Build v2

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

Syntax

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

Entradas

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

Especifica uma lista de ações delimitada por espaço. As opções válidas são build, clean, test, analyze e archive. Por exemplo, build clean executa um build limpo. Confira a 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).

Cria um projeto ou workspace do Xcode no SDK especificado. Execute xcodebuild -showsdks para ver uma lista válida de SDKs.

xcWorkspacePath - Workspace/Caminho do Projeto
string. Valor padrão: **/*.xcodeproj/*.xcworkspace.

Opcional. Especifica o caminho relativo da raiz do repositório para o workspace ou projeto do Xcode. Por exemplo: MyApp/MyApp.xcworkspace ou MyApp/MyApp.xcworkspace/MyApp.xcodeproj.
Deixe em branco se você pretende usar -target flag em Argumentos Avançados.

scheme - Esquema
string.

Opcional. Especifica o nome do esquema Xcode. Deve ser um esquema compartilhado (caixa de seleção compartilhada em Esquemas Gerenciados no Xcode). Obrigatório se Workspace for especificado.

packageApp - Criar Pacote do Aplicativo
boolean. Valor padrão: true.

Especifica se um IPA é gerado como parte do build. Para exportar arquivos com Xcode 7 e Xcode 8, examine as entradas adicionais na seção Opções de Pacote .

packageTool - Criar pacote (IPA) usando
string. Obrigatórios. Valores permitidos: xcrun (xcrun (preterido pela Apple)), xcodebuild (arquivo e exportação do xcodebuild). Valor padrão: xcodebuild.

Especifica a ferramenta a ser usada para gerar o IPA.

archivePath - Caminho do Arquivo Morto
string. Opcional. Use quando packageTool == xcodebuild.

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

exportPath - Caminho de Exportação
string. Opcional. Use quando packageTool == xcodebuild. 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 packageTool == xcodebuild. Valores permitidos: auto, plist, specify. Valor padrão: auto.

Especifica uma maneira de passar opções de exportação ao exportar o arquivo morto.

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 de equipe de 10 dígitos do Portal do Desenvolvedor da Apple a ser usada para a exportação.

exportOptionsPlist - Plist de Opções de Exportação
string. Obrigatório quando exportOptions == plist.

Especifica o caminho para um arquivo plist que configura a exportação de arquivos.

xcode8AutomaticSigning - Assinatura automática
boolean. Valor padrão: false.

Use essa entrada se você tiver um projeto Xcode 8 ou Xcode 9 configurado para Assinatura Automática.

teamId - ID da equipe
string. Opcional. Use quando xcode8AutomaticSigning = true.

Especifica a ID da equipe de desenvolvedor de 10 dígitos. Isso será necessário se você for membro de várias equipes de desenvolvimento.

signMethod - Substituir usando
string. Valores permitidos: file (Conteúdo do Arquivo), id (Identificadores). Valor padrão: file.

Use essa entrada se o build usar um método de assinatura ou provisionamento diferente do padrão. Escolha File Contents usar um certificado P12 e um perfil de provisionamento. Escolha Identifiers recuperar as configurações de assinatura dos perfis padrão keychain e pré-instalados. Deixe os campos correspondentes em branco se você não quiser substituir as configurações de build padrão.

iosSigningIdentity - Identidade de Assinatura
string. Opcional. Use quando signMethod = id.

Especifica a substituição de identidade de assinatura usada para assinar o build. O padrão é a configuração do projeto Xcode. Talvez seja necessário selecionar Desbloquear Conjunto de Chaves Padrão.

unlockDefaultKeychain - Desbloquear conjunto de chaves padrão
boolean. Opcional. Use quando signMethod = id. Valor padrão: false.

Resolve erros não permitidos pela interação do usuário desbloqueando o keychain padrão.

defaultKeychainPassword - Senha do conjunto de chaves padrão
string. Opcional. Use quando signMethod = id.

Especifica a senha para desbloquear o keychain padrão.

provProfileUuid - UUID do perfil de provisionamento
string. Opcional. Use quando signMethod = id.

Especifica a UUID de um perfil de provisionamento instalado a ser 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, WatchKit, tvOS).

p12 - Arquivo de certificado P12
string. Opcional. Use quando signMethod = file.

Especifica o caminho relativo para um arquivo de certificado P12 formatado PKCS12 que contém um certificado de autenticação a ser usado para o build.

p12pwd - Senha P12
string. Opcional. Use quando signMethod = file.

Especifica a senha para um arquivo de certificado P12, se especificado. Use uma variável de build para criptografar.

provProfile - Arquivo de perfil de provisionamento
string. Opcional. Use quando signMethod = file.

Especifica o caminho relativo para um arquivo que contém uma substituição de perfil de provisionamento a ser usada 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, WatchKit, tvOS).

removeProfile - Remover perfil após compilação
boolean. Opcional. Use quando signMethod = file. Valor padrão: false.

Remove o conteúdo do arquivo de perfil de provisionamento do agente de build após a conclusão do build. Somente marcar se você estiver executando um agente por usuário.

args - Argumentos
string.

Especifica argumentos de linha de comando adicionais usados para compilar. Essa entrada será útil se você quiser usar -target ou -project em vez de especificar um workspace e um esquema.

cwd - Diretório de Trabalho
string.

Especifica o diretório de trabalho para execuções de build. O padrão é a raiz do repositório.

outputPattern - Diretório de Saída
string. Obrigatórios. Valor padrão: output/$(SDK)/$(Configuration).

Especifica o caminho relativo em que a saída de build (binários) é colocada.

xcodeDeveloperDir - Caminho do desenvolvedor do Xcode
string.

Opcional. Especifica o caminho para a pasta Desenvolvedor do Xcode se não for o padrão do sistema. Para uso quando várias versões do Xcode são instaladas em um sistema. Por exemplo: /Applications/Xcode 7.app/Contents/Developer.

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

Formata xcodebuild a saída e gera um relatório de resultados de teste JUnit. Deve ser instalado em hosts de agente. Saiba mais sobre xcpretty.

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

Os resultados do teste JUnit que foram produzidos usando xctool são publicados no VSTS/TFS.

useXctool - Usar xctool
boolean.

xctool Usa em vez de xcodebuild. Deve ser instalado em hosts de agente. Saiba mais sobre xctool.
Nota:xctool foi preterido e não funciona com o Xcode 8.

xctoolReporter - Formato do Repórter de Teste xctool
string.

Testa o formato do repórter a ser usado quando a ação de teste é especificada e Usar xctool é verificado. Especifique junit:output-file-path-here.xml para gerar um formato de arquivo compatível com a tarefa Publicar Resultados do Teste. Quando especificado, plain é adicionado automaticamente. xctool deve ser instalado em hosts de agente. Saiba mais sobre xctool.
Nota:xctool foi preterido e não funciona com o Xcode 8.

Opções de controle da 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.

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