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 |