tarefa Xcode@4 - Xcode v4
Use essa tarefa para criar, testar ou arquivar um workspace do Xcode no macOS e, opcionalmente, empacotar um aplicativo.
Syntax
# Xcode v4
# Build, test, or archive an Xcode workspace on macOS. Optionally package an app.
- task: Xcode@4
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' | '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.
#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: 'iPhone 7' # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Simulator. Default: iPhone 7.
#destinationDevices: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices. Device.
# Advanced
#args: # string. Arguments.
#workingDirectory: # string. Alias: cwd. Working directory.
#outputPattern: # string. Output directory.
#useXcpretty: false # boolean. Use xcpretty. Default: false.
#publishJUnitResults: false # boolean. Publish test results to VSTS/TFS. Default: false.
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,clean build executa um build limpo. Consulte a Apple: compilando a partir da linha de comando com perguntas frequentes sobre 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 do 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 workspace ou projeto do Xcode. Se você especificar um valor, também deverá especificar o esquema. Não especifique um valor se você estiver especificando -target flag em Argumentos Avançados. Por exemplo, MyApp/MyApp.xcworkspace ou MyApp/MyApp.xcodeproj.
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), 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 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 aplicativos
boolean. Valor padrão: false.
Especifica se um arquivo de pacote de aplicativo IPA deve ser gerado como parte do build.
archivePath - Caminho de 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 específico e a ID da equipe.
exportMethod - Método de exportação
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 - Plist de opções de exportação
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 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 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 da 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 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 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).
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 na 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.
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 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. Valor padrão: iPhone 7.
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. Saiba mais sobre simuladores instalados no agente de versão prévia do macOS hospedado.
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.
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 a 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.
outputPattern - Diretório de saída
string.
Opcional. Especifica um caminho relativo para o diretório de trabalho em que a saída de build (binários) é colocada. Por exemplo: output/$(SDK)/$(Configuration) ou output/$(TestSDK)/$(TestConfiguration). Os caminhos de arquivamento e exportação são configurados separadamente. Especifique valores na guia Variáveis.
useXcpretty - Usar xcpretty
boolean. Valor padrão: false.
Especifica se deve ser usado xcpretty para formatar xcodebuild a saída e gera os resultados do teste JUnit. xcpretty deve ser instalado no computador do agente (ele é pré-instalado em agentes de build hospedados no VSTS). Consulte xcpretty para obter mais informações.
publishJUnitResults - Publicar resultados de teste no VSTS/TFS
boolean. Valor padrão: false.
Se xcpretty estiver habilitada, essa entrada especificará se os resultados do teste JUnit serão publicados no VSTS/TFS.
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 um workspace do Xcode no macOS.
Exemplos
Requisitos
| Requisito | Descrição |
|---|---|
| Tipos de pipeline | YAML, build clássico |
| Executa 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 para 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 |
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de