Xcode@5 - Tarefa Xcode v5

Use esta tarefa para criar, testar ou arquivar um espaço de trabalho Xcode no macOS e, opcionalmente, empacotar um aplicativo.

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

actions - Ações
string. Obrigatório. Valor padrão: 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: Construindo a partir da linha de comando com o Xcode FAQ.

configuration - de configuração
string. Valor padrão: $(Configuration).

Especifica o projeto Xcode ou a configuração do espaço de trabalho a ser compilado. 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 espaço de trabalho 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 espaço de trabalho ou projeto Xcode. Por exemplo, MyApp/MyApp.xcworkspace ou MyApp/MyApp.xcodeproj. É possível utilizar curingas. Saiba mais sobre padrões de correspondência de arquivos.

scheme - Esquema
string.

Opcional. Especifica um nome de esquema Xcode. Deve ser um esquema compartilhado (caixa de seleção compartilhada em Managed Schemes no Xcode). Se você não especificar um esquema e o espaço de trabalho especificado tiver um único esquema compartilhado, o esquema de espaço de trabalho será usado.

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), defaultspecifyPath (Especificar caminho). Valor padrão: default.

Especifica a versão de destino do Xcode. Selecione Default usar a versão padrão do Xcode na máquina do agente. A especificação de um número de versão (por exemplo, Xcode 9) depende do local da versão a ser definido 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 do desenvolvedor do Xcode.

xcodeDeveloperDir - caminho do desenvolvedor 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 na máquina do agente.

packageApp - Criar pacote de aplicativo
boolean. Valor padrão: false.

Especifica se um arquivo de pacote de aplicativo IPA é gerado como parte da compilação.

archivePath - Caminho do arquivo
string. Opcional. Use quando packageApp == true.

Especifica um diretório onde 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.

exportOptions - Opções de exportação
string. Opcional. Use quando packageApp == true. Valores permitidos: auto (Automático), plistspecify. Valor padrão: auto.

Especifica opções para exportar o arquivo. Quando o valor padrão de Automatic é selecionado, o método de exportação é detetado automaticamente a partir do arquivo. Selecione Plist para especificar um arquivo plist contendo opções de exportação. Selecione Specify para fornecer um método Export específico e ID de 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 Equipa
string. Opcional. Use quando exportOptions == specify.

Especifica o ID da equipe de 10 caracteres do Apple Developer Portal a ser usado 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 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 da compilação. Selecione Do not code sign para desativar a assinatura. Selecione Project defaults 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 um ID da equipe de desenvolvimento. Se o seu projeto requer assinatura, use o Instalar Apple... tarefas para instalar certificados e perfis de provisionamento antes da compilação do Xcode.

signingIdentity - Assinatura de identidade
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 as chaves padrão na máquina do agente. Se nenhum valor for inserido, a configuração do projeto Xcode será usada.

provisioningProfileUuid - Perfil de provisionamento UUID
string. Opcional. Use quando signingOption = manual.

Especifica o UUID de um perfil de provisionamento instalado usado para a compilação. Use tarefas de compilação separadas com esquemas ou destinos diferentes para especificar perfis de provisionamento por destino em um único espaço de trabalho (iOS, tvOS, watchOS).

provisioningProfileName - Nome do perfil de provisionamento
string. Opcional. Use quando signingOption = manual.

Especifica o nome de um perfil de provisionamento instalado usado para a compilação. Se especificado, isso tem precedência sobre o UUID do perfil de provisionamento. Use tarefas de compilação separadas com esquemas ou destinos diferentes para especificar perfis de provisionamento por destino em um único espaço de trabalho (iOS, tvOS, watchOS).

teamId - ID da Equipa
string. Opcional. Use quando signingOption = auto.

Obrigatório se você for membro de várias equipes de desenvolvimento. Especifica o 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 testes de interface do usuário quando o dispositivo de compilação genérico não é válido. Escolha Custom para especificar uma plataforma não incluída nesta 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 testes de interface do usuário quando o dispositivo de compilação genérico não é válido. Escolha Custom para especificar uma plataforma não incluída na lista. Quando Default é selecionado, nenhum simulador ou dispositivo é direcionado.

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 a ser usado para o teste da interface do usuário. Os dispositivos devem estar conectados ao Mac executando a compilação através de um cabo ou conexão de rede. Consulte Devices and Simulators no Xcode para obter mais informações.

destinationSimulators - Simulador
string. Opcional. Use quando destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == simulators.

Especifica um nome de simulador Xcode usado para testes 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. Consulte esta lista de simuladores instalados no Hosted macOS agent para obter mais informações.

destinationDevices - Dispositivo
string. Opcional. Use quando destinationPlatformOption != default && destinationPlatformOption != macOS && destinationTypeOption == devices.

Especifica o nome do dispositivo usado para o teste da interface do usuário, como Raisa's iPad. Atualmente, apenas um dispositivo é suportado. Note que a Apple não permite apóstrofos (') nos nomes dos dispositivos. Em vez disso, aspas simples direitas (') podem ser usadas.

args - Argumentos
string.

Opcional. Especifica argumentos de linha de comando adicionais com os quais compilar. Esta entrada é útil para especificar -target ou -project argumentos em vez de um espaço de trabalho/projeto e esquema. Consulte Apple: Construindo a partir da linha de comando com o Xcode FAQ.

workingDirectory - Diretório de trabalho
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.

useXcpretty - Use xcpretty
boolean. Valor padrão: true.

Especifica se o xcpretty deve ser usado para formatar xcodebuild saída. xcpretty deve ser instalado na máquina do agente (ele é pré-instalado em agentes de compilação hospedados do Azure Pipelines). Se xcpretty não estiver instalado, a saída xcodebuild bruta será mostrada. Consulte xcpretty para obter mais informações.

xcprettyArgs - argumentos Xcpretty
string. Opcional. Use quando useXcpretty == true.

Se xcpretty estiver habilitado, essa entrada especifica argumentos para xcpretty. Veja uma lista de argumentos xcpretty no GitHub.

publishJUnitResults - Publicar resultados de teste no Azure Pipelines
boolean. Valor padrão: false.

Especifica se os resultados do teste JUnit devem ser publicados no Azure Pipelines. Isso requer que xcpretty esteja habilitado para gerar resultados de teste JUnit.

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

Se xcpretty e publishJUnitResults estiverem habilitados, você poderá especificar o título da execução de teste.

Nenhum.