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 |