Xcode@5 - Tarefa Xcode v5

Utilize esta tarefa para criar, testar ou arquivar uma área de trabalho Xcode no macOS e, opcionalmente, empacotar uma aplicação.

Syntax

# Xcode v5
# Build, test, or archive an Xcode workspace on macOS. Optionally package an app.
- task: Xcode@5
  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' | '10' | '11' | '12' | '13' | '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. 
    #provisioningProfileName: # string. Optional. Use when signingOption = manual. Provisioning profile name. 
    #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: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators. Simulator. 
    #destinationDevices: # string. Optional. Use when destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices. Device. 
  # Advanced
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #useXcpretty: true # boolean. Use xcpretty. Default: true.
    #xcprettyArgs: # string. Optional. Use when useXcpretty == true. Xcpretty arguments. 
    #publishJUnitResults: false # boolean. Publish test results to Azure Pipelines. Default: false.
    #testRunTitle: # string. Optional. Use when publishJUnitResults == true. Test run title.

Entradas

actions - Ações
string. Obrigatório. Valor predefinido: build.

Especifica uma lista de ações delimitada por espaço. Algumas opções válidas são build, clean, test, analyzee archive. Por exemplo,clean build executa uma compilação limpa. Consulte 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. Por exemplo, MyApp/MyApp.xcworkspace ou MyApp/MyApp.xcodeproj. Podem ser utilizados carateres universais. Saiba mais sobre os padrões de correspondência de ficheiros.

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), 10 (Xcode 10), 11 (Xcode 11), 12 (Xcode 12), 13 (Xcode 13), 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 é 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).

provisioningProfileName - Nome do perfil de aprovisionamento
string. Opcional. Utilize quando signingOption = manual.

Especifica o nome de um perfil de aprovisionamento instalado utilizado para a compilação. Se for especificado, tem precedência sobre o UUID do perfil de aprovisionamento. 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 nesta 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. Opte por Custom especificar uma plataforma não incluída na lista. Quando Default estiver selecionado, não são visados simuladores nem dispositivos.

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 a utilizar para testes de IU. Os dispositivos têm de estar ligados ao Mac efetuando a compilação através de um cabo ou ligação 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.

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. Veja esta lista de simuladores instalados no agente macOS alojado para obter mais informações.

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. Atualmente, só é suportado um dispositivo. Tenha em atenção que a Apple não permite apóstrofos (') em nomes de dispositivos. Em vez disso, podem ser utilizadas aspas simples (') direitas.

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: 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.

useXcpretty - Utilizar xcpretty
boolean. Valor predefinido: true.

Especifica se pretende utilizar xcpretty para formatar xcodebuild a saída. xcpretty tem de ser instalado no computador do agente (está pré-instalado nos agentes de compilação alojados nos Pipelines do Azure). Se xcpretty não estiver instalado, é apresentada a saída não xcodebuild processada. Consulte xcpretty para obter mais informações.

xcprettyArgs - Argumentos Xcpretty
string. Opcional. Utilize quando useXcpretty == true.

Se xcpretty estiver ativada, esta entrada especifica argumentos para xcpretty. Veja uma lista de argumentos xcpretty no GitHub.

publishJUnitResults - Publicar resultados de teste no Azure Pipelines
boolean. Valor predefinido: false.

Especifica se pretende publicar os resultados do teste JUnit nos Pipelines do Azure. É necessário ativar xcpretty esta opção para gerar resultados de teste JUnit.

testRunTitle - Título da execução de teste
string. Opcional. Utilize quando publishJUnitResults == true.

Se xcpretty e publishJUnitResults estiver ativado, pode especificar o título da execução de teste.

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das 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, testar ou arquivar uma área de trabalho Xcode no macOS e, opcionalmente, empacotar uma aplicação.

Utilizar vários perfis de aprovisionamento

Atualmente, não existe suporte para vários perfis de aprovisionamento para a tarefa Xcode (por exemplo, para a Extensão de Aplicação iOS).

Exemplos

Criar a sua aplicação Xcode

Requisitos

Requisito	Description
Tipos de pipeline	YAML, Compilação clássica
É executado em	Agente, DeploymentGroup
Exigências	Os agentes autoalojados têm de ter capacidades que correspondam às seguintes exigências para executar tarefas que utilizam 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 tabelas definidas	Qualquer
Versão do agente	Todas as versões de agente suportadas.
Categoria da tarefa	Compilar