Compartilhar via


Xcode@3 – Tarefa Xcode Build v3

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

Sintaxe

# Xcode Build v3
# Build an Xcode workspace on macOS.
- task: Xcode@3
  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
    #archivePath: # string. Archive Path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Export Path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. 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. Export Arguments. 
  # 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.

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: build clean executa um build limpo. 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).

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


xcWorkspacePath - workspace/ de 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.


esquema scheme -
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 o Workspace for especificado.


packageApp - Criar pacote de aplicativos
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.


archivePath - de caminho de arquivamento
string.

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


exportPath - de caminho de exportação
string. Valor padrão: output/$(SDK)/$(Configuration).

Opcional. Especifica o destino do produto exportado do arquivo morto.


opções de exportação exportOptions -
string. Valores permitidos: auto, plist, specify. Valor padrão: auto.

Especifica uma maneira de passar Opções de Exportação ao exportar o arquivo morto.


método de exportação exportMethod -
string. Necessá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, enterpriseou development.


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

Especifica a ID da equipe de 10 dígitos do Portal do Desenvolvedor da Apple a ser usada para a exportação.


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

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


exportArgs - exportar argumentos
string.

Especifica argumentos de linha de comando adicionais usados para exportar.


xcode8AutomaticSigning - de 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.


substituição de signMethod - 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 para usar um certificado P12 e um perfil de provisionamento. Escolha Identifiers para recuperar as configurações de assinatura do conjunto de chaves padrão e dos perfis pré-instalados. Deixe os campos correspondentes em branco se você não quiser substituir as configurações de build padrão.


iosSigningIdentity - de 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. desbloquear de conjunto de chaves padrão pode precisar ser selecionado.


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

Resolve A interação do usuário não é permitida erros desbloqueando o conjunto de chaves padrão.


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

Especifica a senha para desbloquear o conjunto de chaves 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 - de 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 assinatura a ser usado para o build.


p12pwd - de senha P12
string. Opcional. Use quando signMethod = file.

Especifica a senha para um arquivo de certificado P12. 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 de build
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. Verifique somente se você está executando um agente por usuário.


argumentos args -
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.


do Diretório de Trabalho do
string.

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


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

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


xcodeDeveloperDir - de 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 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.


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.

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