Xcode@4 - Tarefa Xcode v4
Utilize esta tarefa para criar, testar ou arquivar uma área de trabalho Xcode no macOS e, opcionalmente, empacotar uma aplicação.
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ório. Valor predefinido: build.
Especifica uma lista de ações delimitada por espaço. As opções válidas são build, clean, test, analyzee archive. Por exemplo,clean build executa uma compilação limpa. Consulte apple : building from the command line with Xcode FAQ (Apple: Criar a partir da linha de comandos com AS FAQ do Xcode).
configuration - Configuração
string. Valor predefinido: $(Configuration).
Especifica a configuração do projeto Xcode ou da área de trabalho a compilar. Ao utilizar uma variável, especifique um valor (por exemplo, Release) no separador Variáveis .
sdk - SDK
string. Valor predefinido: $(SDK).
Especifica um SDK a utilizar ao criar o projeto ou área de trabalho Xcode. A partir da aplicação de Terminal do macOS, execute xcodebuild -showsdks para apresentar a lista válida de SDKs. Ao utilizar uma variável, especifique um valor (por exemplo, iphonesimulator) no separador Variáveis .
xcWorkspacePath - Caminho da área de trabalho ou do projeto
string. Valor predefinido: **/*.xcodeproj/project.xcworkspace.
Opcional. Especifica um caminho relativo da raiz do repositório para a área de trabalho ou projeto Xcode. Se especificar um valor, também tem de especificar o esquema. Não especifique um valor se estiver a especificar -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. Tem de ser um esquema partilhado (caixa de verificação partilhada em Esquemas Geridos no Xcode). Se não especificar um esquema e a área de trabalho especificada tiver um único esquema partilhado, será utilizado o esquema de área de trabalho.
xcodeVersion - Versão do Xcode
string. Valores permitidos: 8 (Xcode 8), 9 (Xcode 9), default, specifyPath (Especificar caminho). Valor predefinido: default.
Especifica a versão de destino do Xcode. Selecione Default para utilizar a versão predefinida do Xcode no computador do agente. Especificar um número de versão (por exemplo, Xcode 9) depende da localização da versão a ser definida pelas 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 de programador Xcode.
xcodeDeveloperDir - Caminho do programador Xcode
string. Opcional. Utilize quando xcodeVersion == specifyPath.
Especifica um caminho para um diretório de programador Xcode específico (por exemplo, /Applications/Xcode_9.0.0.app/Contents/Developer). Esta entrada é útil quando várias versões do Xcode são instaladas no computador do agente.
packageApp - Criar pacote de aplicações
boolean. Valor predefinido: false.
Especifica se um ficheiro de pacote de aplicação IPA deve ser gerado como parte da compilação.
archivePath - Caminho de arquivo
string. Opcional. Utilize quando packageApp == true.
Especifica um diretório onde os arquivos criados são colocados.
exportPath - Caminho de exportação
string. Opcional. Utilize quando packageApp == true. Valor predefinido: output/$(SDK)/$(Configuration).
Especifica o destino do produto exportado do arquivo.
exportOptions - Opções de exportação
string. Opcional. Utilize quando packageApp == true. Valores permitidos: auto (Automático), plist, specify. Valor predefinido: auto.
Especifica opções para exportar o arquivo. Quando o valor predefinido de Automatic é selecionado, o método de exportação é automaticamente detetado a partir do arquivo. Selecione Plist para especificar um ficheiro plist que contenha opções de exportação. Selecione Specify para fornecer um método de Exportação específico e um ID de Equipa.
exportMethod - Método de exportação
string. Necessário quando exportOptions == specify. Valor predefinido: development.
Especifica o método que o Xcode utiliza para exportar o arquivo. Por exemplo: app-store, package, ad-hoc, enterpriseou development.
exportTeamId - ID da Equipa
string. Opcional. Utilize quando exportOptions == specify.
Especifica o ID de equipa de 10 carateres do Apple Developer Portal a utilizar durante a exportação.
exportOptionsPlist - Lista de opções de exportação
string. Necessário quando exportOptions == plist.
Especifica o caminho para o ficheiro plist que contém opções a utilizar durante a exportação.
exportArgs - Exportar argumentos
string. Opcional. Utilize quando packageApp == true.
Especifica argumentos adicionais da linha de comandos utilizados durante a exportação.
signingOption - Estilo de assinatura
string. Valores permitidos: nosign (Não assinar código), default (Predefinições do projeto), manual (Assinatura manual) auto (Assinatura automática). Valor predefinido: nosign.
Especifica o método de assinatura da compilação. Selecione Do not code sign para desativar a assinatura. Selecione Project defaults para utilizar 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 aprovisionamento. Selecione Automatic signing para forçar a assinatura automática e, opcionalmente, especifique um ID da equipa de desenvolvimento. Se o seu projeto necessitar de assinatura, utilize as tarefas Instalar Apple... para instalar certificados e perfis de aprovisionamento antes da compilação Xcode.
signingIdentity - Identidade de assinatura
string. Opcional. Utilize quando signingOption = manual.
Especifica uma substituição de identidade de assinatura com a qual pretende assinar a compilação. Pode ser necessário desbloquear a keychain predefinida no computador do agente. Se não for introduzido nenhum valor, é utilizada a definição do projeto Xcode.
provisioningProfileUuid - UUID do perfil de aprovisionamento
string. Opcional. Utilize quando signingOption = manual.
Especifica o UUID de um perfil de aprovisionamento instalado utilizado para a compilação. Utilize tarefas de compilação separadas com diferentes esquemas ou destinos para especificar perfis de aprovisionamento por destino numa única área de trabalho (iOS, tvOS, watchOS).
teamId - ID da Equipa
string. Opcional. Utilize quando signingOption = auto.
Necessário se for membro de várias equipas de desenvolvimento. Especifica o ID da equipa de desenvolvimento de 10 carateres.
destinationPlatformOption - Plataforma de destino
string. Valores permitidos: default, iOS (iOS e watchOS), tvOS, macOS, custom. Valor predefinido: default.
Especifica a plataforma do dispositivo de destino utilizada para testes de IU quando o dispositivo de compilação genérico não é válido. Opte por Custom especificar uma plataforma não incluída na lista. Quando Default estiver selecionado, não são visados simuladores ou dispositivos.
destinationPlatform - Plataforma de destino personalizada
string. Opcional. Utilize quando destinationPlatformOption == custom.
Especifica a plataforma de um dispositivo de destino utilizada para testes de IU quando o dispositivo de compilação genérico não é válido.
destinationTypeOption - Tipo de destino
string. Opcional. Utilize quando destinationPlatformOption != default && destinationPlatformOption != macOS. Valores permitidos: simulators (Simulador), devices (Dispositivo Ligado). Valor predefinido: simulators.
Especifica o tipo de destino utilizado para testes de IU. Os dispositivos têm de estar ligados ao Mac efetuando a compilação através de uma ligação de cabo ou de rede. Consulte Dispositivos e Simuladores no Xcode para obter mais informações.
destinationSimulators - Simulador
string. Opcional. Utilize quando destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Valor predefinido: iPhone 7.
Especifica um nome de simulador Xcode utilizado para testes de IU. Por exemplo, iPhone X (iOS e watchOS) ou Apple TV 4K (tvOS). Uma versão opcional do SO de destino pode ser especificada no formato OS=<versionNumber>, como iPhone X,OS=11.1. Saiba mais sobre os simuladores instalados no agente de Pré-visualização do macOS alojado.
destinationDevices - Dispositivo
string. Opcional. Utilize quando destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices.
Especifica o nome do dispositivo utilizado para testes de IU, como Raisa's iPad.
args - Argumentos
string.
Opcional. Especifica argumentos adicionais da linha de comandos com os quais criar. Esta entrada é útil para especificar -target ou -project argumentos em vez de uma área de trabalho/projeto e esquema. Consulte apple : building from the command line with Xcode FAQ (Apple: Criar a partir da linha de comandos com AS FAQ do Xcode).
workingDirectory - Diretório de trabalho
Alias de entrada: cwd. string.
Opcional. Especifica o diretório de trabalho no qual executar a compilação. Se não for introduzido nenhum valor, será utilizada a raiz do repositório.
outputPattern - Diretório de saída
string.
Opcional. Especifica um caminho relativo para o diretório de trabalho onde a saída da compilação (binários) é colocada. Por exemplo: output/$(SDK)/$(Configuration) ou output/$(TestSDK)/$(TestConfiguration). Os caminhos de arquivo e exportação são configurados separadamente. Especifique valores no separador Variáveis.
useXcpretty - Utilizar xcpretty
boolean. Valor predefinido: false.
Especifica se pretende utilizar xcpretty para formatar xcodebuild a saída e gera os resultados do teste JUnit. xcpretty tem de ser instalado no computador do agente (está pré-instalado em agentes de compilação alojados no VSTS). Consulte xcpretty para obter mais informações.
publishJUnitResults - Publicar resultados de teste no VSTS/TFS
boolean. Valor predefinido: false.
Se xcpretty estiver ativada, esta entrada especifica se pretende publicar os resultados do teste JUnit no VSTS/TFS.
Opções de controlo de tarefas
Todas as tarefas têm opções de controlo para além das respetivas entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.
Variáveis de saída
Nenhum.
Observações
Utilize esta tarefa para criar uma área de trabalho Xcode no macOS.
Exemplos
Requisitos
| Requisito | Description |
|---|---|
| Tipos de pipeline | YAML, Compilação clássica |
| É executado em | Agent, DeploymentGroup |
| Exigências | Os agentes autoalojados têm de ter capacidades que correspondam às seguintes exigências para executar tarefas que utilizem esta tarefa: xcode |
| Capacidades | Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa. |
| Restrições de comandos | Qualquer |
| Variáveis de definição | Qualquer |
| Versão do agente | Todas as versões de agente suportadas. |
| Categoria da tarefa | Compilar |