Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Use esta tarefa para criar, testar ou arquivar um workspace do Xcode no macOS e, opcionalmente, empacotar um aplicativo.
Sintaxe
# 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
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,clean build executa uma compilação limpa. 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).
Especifica um SDK a ser usado ao criar o projeto ou workspace do Xcode. No aplicativo macOS Terminal, 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
-
Espaço de trabalho 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.
esquema scheme -
string.
Opcional. Especifica um nome de esquema do Xcode. Deve ser um esquema compartilhado (caixa de seleção compartilhada em Esquemas Gerenciados no Xcode). Se você não especificar um esquema e a área de trabalho especificada tiver um único esquema compartilhado, o esquema de área de trabalho 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. A especificação de um número de versão (por exemplo, Xcode 9) depende do local da versão a ser definida por variáveis de ambiente na máquina 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 de 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 aplicativo
boolean. Valor padrão: false.
Especifica se um arquivo de pacote de aplicativo IPA deve ser gerado como parte do build.
archivePath
-
Caminho do arquivo
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 as opções para exportar o arquivo. Quando o valor padrão de é selecionado, o método de Automatic exportação é detectado automaticamente no arquivo. Selecione Plist para especificar um arquivo plist contendo opções de exportação. Selecione Specify para fornecer um método de exportação específico e uma ID da equipe.
exportMethod
-
Método de exportação
string. Necessário quando exportOptions == specify. Valor padrão: development.
Especifica o método que o Xcode usa para exportar o arquivo. 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
-
Opções de exportação plist
string. Necessá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 codificar sinal), 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 desativar 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 seu projeto exigir assinatura, use as tarefas Instalar Apple... para instalar certificados e perfis de provisionamento antes da compilação do Xcode.
signingIdentity
-
Identidade de assinatura
string. Opcional. Use quando signingOption = manual.
Especifica uma substituição de identidade de assinatura com a qual assinar a compilação. 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 o UUID de um perfil de provisionamento instalado usado para a compilação. Use tarefas de build separadas com diferentes esquemas ou destinos para especificar perfis de provisionamento por destino em um único workspace (iOS, tvOS, watchOS).
teamId
-
ID da equipe
string. Opcional. Use quando signingOption = auto.
Obrigató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 que executa a compilação por meio de um cabo ou conexão de rede. 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 do 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 os simuladores instalados no agente de visualização 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.
argumentos args -
string.
Opcional. Especifica argumentos de linha de comando adicionais com os quais construir. Essa entrada é útil para especificar -target argumentos or -project em vez de um espaço de trabalho/projeto e esquema. Consulte o Apple: compilando a partir da linha de comando com perguntas frequentes do Xcode.
do diretório de trabalho do
Alias de entrada: cwd.
string.
Opcional. Especifica o diretório de trabalho no qual executar a compilação. Se nenhum valor for inserido, a raiz do repositório será usada.
do diretório de saída do outputPattern -
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 resultados de teste JUnit.
xcpretty deve ser instalado no computador do agente (ele é pré-instalado em agentes de compilação 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 habilitado, essa entrada especificará se os resultados do teste JUnit devem ser 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.
Observações
Use essa tarefa para criar um workspace do Xcode no macOS.
Exemplos
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 |