Partilhar via

Xcode@2 - Tarefa de Compilação Xcode v2

  • Artigo

Utilize esta tarefa para criar uma área de trabalho Xcode no macOS.

Syntax

# Xcode Build v2
# Build an Xcode workspace on Mac OS.
- task: Xcode@2
  inputs:
    actions: 'build' # string. Required. Actions. Default: build.
    #configuration: '$(Configuration)' # string. Configuration. Default: $(Configuration).
    #sdk: '$(SDK)' # string. SDK. Default: $(SDK).
    #xcWorkspacePath: '**/*.xcodeproj/*.xcworkspace' # string. Workspace/Project Path. Default: **/*.xcodeproj/*.xcworkspace.
    #scheme: # string. Scheme. 
    #packageApp: true # boolean. Create App Package. Default: true.
  # Package Options
    packageTool: 'xcodebuild' # 'xcrun' | 'xcodebuild'. Required. Create Package (IPA) using. Default: xcodebuild.
    #archivePath: # string. Optional. Use when packageTool == xcodebuild. Archive Path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Optional. Use when packageTool == xcodebuild. Export Path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. Optional. Use when packageTool == xcodebuild. 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. 
  # Signing & Provisioning
    #xcode8AutomaticSigning: false # boolean. Automatic Signing. Default: false.
    #teamId: # string. Optional. Use when xcode8AutomaticSigning = true. Team ID. 
    #signMethod: 'file' # 'file' | 'id'. Override Using. Default: file.
    #iosSigningIdentity: # string. Optional. Use when signMethod = id. Signing Identity. 
    #unlockDefaultKeychain: false # boolean. Optional. Use when signMethod = id. Unlock Default Keychain. Default: false.
    #defaultKeychainPassword: # string. Optional. Use when signMethod = id. Default Keychain Password. 
    #provProfileUuid: # string. Optional. Use when signMethod = id. Provisioning Profile UUID. 
    #p12: # string. Optional. Use when signMethod = file. P12 Certificate File. 
    #p12pwd: # string. Optional. Use when signMethod = file. P12 Password. 
    #provProfile: # string. Optional. Use when signMethod = file. Provisioning Profile File. 
    #removeProfile: false # boolean. Optional. Use when signMethod = file. Remove Profile After Build. Default: false.
  # Advanced
    #args: # string. Arguments. 
    #cwd: # string. Working Directory. 
    outputPattern: 'output/$(SDK)/$(Configuration)' # string. Required. Output Directory. Default: output/$(SDK)/$(Configuration).
    #xcodeDeveloperDir: # string. Xcode Developer Path. 
    #useXcpretty: false # boolean. Use xcpretty. Default: false.
    #publishJUnitResults: false # boolean. Publish to VSTS/TFS. Default: false.
  # xctool (deprecated)
    #useXctool: # boolean. Use xctool. 
    #xctoolReporter: # string. xctool Test Reporter Format.

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, build clean executa uma compilação limpa. Consulte o artigo Apple: Building from the command line with Xcode FAQ (Apple: Building from the command line with Xcode FAQ( Criar a partir da linha de comandos com FAQ do Xcode).


configuration - Configuração
string. Valor predefinido: $(Configuration).

Especifica o projeto Xcode ou a configuração 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).

Cria um projeto ou área de trabalho Xcode no SDK especificado. Execute xcodebuild -showsdks para ver uma lista válida de SDKs.


xcWorkspacePath - Área de Trabalho/Caminho do Projeto
string. Valor predefinido: **/*.xcodeproj/*.xcworkspace.

Opcional. Especifica o caminho relativo da raiz do repositório para a área de trabalho ou projeto Xcode. Por exemplo: MyApp/MyApp.xcworkspace ou MyApp/MyApp.xcworkspace/MyApp.xcodeproj.
Deixe em branco se pretender utilizar -target flag em Argumentos Avançados.


scheme - Esquema
string.

Opcional. Especifica o nome do esquema Xcode. Tem de ser um esquema partilhado (caixa de verificação partilhada em Esquemas Geridos no Xcode). Necessário se a Área de Trabalho for especificada.


packageApp - Criar Pacote de Aplicações
boolean. Valor predefinido: true.

Especifica se um IPA é gerado como parte da compilação. Para exportar arquivos com xcode 7 e Xcode 8, veja entradas adicionais na secção Opções do Pacote .


packageTool - Criar Pacote (IPA) com
string. Obrigatório. Valores permitidos: xcrun (xcrun (preterido pela Apple)), xcodebuild (arquivo xcodebuild e exportação). Valor predefinido: xcodebuild.

Especifica a ferramenta a utilizar para gerar o IPA.


archivePath - Caminho de Arquivo
string. Opcional. Utilize quando packageTool == xcodebuild.

Especifica um diretório onde os arquivos criados são colocados.


exportPath - Caminho de Exportação
string. Opcional. Utilize quando packageTool == xcodebuild. Valor predefinido: output/$(SDK)/$(Configuration).

Especifica o destino do produto exportado do arquivo.


exportOptions - Opções de Exportação
string. Opcional. Utilize quando packageTool == xcodebuild. Valores permitidos: auto, , plistspecify. Valor predefinido: auto.

Especifica uma forma de transmitir as Opções de Exportação ao exportar o arquivo.


exportMethod - Método de Exportação
string. Necessário quando exportOptions == specify. Valor predefinido: development.

Especifica o método utilizado pelo Xcode 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 dígitos do Portal do Programador da Apple a utilizar para a exportação.


exportOptionsPlist - Exportar Opções Plist
string. Necessário quando exportOptions == plist.

Especifica o caminho para um ficheiro plist que configura a exportação de arquivo.


xcode8AutomaticSigning - Assinatura Automática
boolean. Valor predefinido: false.

Utilize esta entrada se tiver um projeto Xcode 8 ou Xcode 9 configurado para Assinatura Automática.


teamId - ID da Equipa
string. Opcional. Utilize quando xcode8AutomaticSigning = true.

Especifica o ID da equipa de programador de 10 dígitos. Isto é necessário se for membro de várias equipas de desenvolvimento.


signMethod - Substituir Com
string. Valores permitidos: file (Conteúdo de Ficheiro), id (Identificadores). Valor predefinido: file.

Utilize esta entrada se a compilação utilizar um método de assinatura ou aprovisionamento diferente da predefinição. Opte por File Contents utilizar um certificado P12 e um perfil de aprovisionamento. Opte por Identifiers obter as definições de assinatura a partir do keychain predefinido e dos perfis pré-instalados. Deixe os campos correspondentes em branco se não quiser substituir as predefinições de compilação.


iosSigningIdentity - Identidade de Assinatura
string. Opcional. Utilize quando signMethod = id.

Especifica a substituição da identidade de assinatura que é utilizada para assinar a compilação. Predefinição para a definição do projeto Xcode. Pode ter de selecionar Desbloquear o Keychain Predefinido.


unlockDefaultKeychain - Desbloquear o Keychain Predefinido
boolean. Opcional. Utilize quando signMethod = id. Valor predefinido: false.

Resolve Os erros de interação do utilizador não são permitidos ao desbloquear o keychain predefinido.


defaultKeychainPassword - Palavra-passe de Keychain Predefinida
string. Opcional. Utilize quando signMethod = id.

Especifica a palavra-passe para desbloquear o keychain predefinido.


provProfileUuid - UUID do Perfil de Aprovisionamento
string. Opcional. Utilize quando signMethod = id.

Especifica o UUID de um perfil de aprovisionamento instalado a utilizar 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, WatchKit, tvOS).


p12 - Ficheiro de Certificado P12
string. Opcional. Utilize quando signMethod = file.

Especifica o caminho relativo para um ficheiro de certificado P12 formatado PKCS12 que contém um certificado de assinatura a ser utilizado para a compilação.


p12pwd - Palavra-passe P12
string. Opcional. Utilize quando signMethod = file.

Especifica a palavra-passe para um ficheiro de certificado P12, se especificado. Utilize uma variável de compilação para encriptar.


provProfile - Ficheiro de Perfil de Aprovisionamento
string. Opcional. Utilize quando signMethod = file.

Especifica o caminho relativo para um ficheiro que contém uma substituição de perfil de aprovisionamento a ser utilizada 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, WatchKit, tvOS).


removeProfile - Remover Perfil Após Compilação
boolean. Opcional. Utilize quando signMethod = file. Valor predefinido: false.

Remove o conteúdo do ficheiro de perfil de aprovisionamento do agente de compilação após a conclusão da compilação. Verifique apenas se está a executar um agente por utilizador.


args - Argumentos
string.

Especifica argumentos adicionais da linha de comandos utilizados para compilar. Esta entrada é útil se quiser utilizar -target ou -project em vez de especificar uma área de trabalho e um esquema.


cwd - Diretório de Trabalho
string.

Especifica o diretório de trabalho para execuções de compilação. A predefinição é a raiz do repositório.


outputPattern - Diretório de Saída
string. Obrigatório. Valor predefinido: output/$(SDK)/$(Configuration).

Especifica o caminho relativo onde são colocados os resultados da compilação (binários).


xcodeDeveloperDir - Caminho do Programador Xcode
string.

Opcional. Especifica o caminho para a pasta Programador Xcode se não for a predefinição do sistema. Para utilização quando são instaladas várias versões do Xcode num sistema. Por exemplo: /Applications/Xcode 7.app/Contents/Developer.


useXcpretty - Utilizar xcpretty
boolean. Valor predefinido: false.

xcodebuild Formatar a saída e gerar um relatório de resultados de teste JUnit. Tem de ser instalado em anfitriões de agentes. Saiba mais sobre xcpretty.


publishJUnitResults - Publicar no VSTS/TFS
boolean. Valor predefinido: false.

Os resultados do teste JUnit que foram produzidos com xctool são publicados no VSTS/TFS.


useXctool - Utilizar xctool
boolean.

Utiliza xctool em vez de xcodebuild. Tem de ser instalado em anfitriões de agentes. Saiba mais sobre o xctool.
Nota:xctool foi preterido e não funciona com o Xcode 8.


xctoolReporter - Formato xctool Test Reporter
string.

Testa o formato do repórter a utilizar quando a ação de teste é especificada e a opção Utilizar xctool é verificada. Especifique junit:output-file-path-here.xml para gerar um formato de ficheiro compatível com a tarefa Publicar Resultados de Teste. Quando especificado, simples é adicionado automaticamente. xctool tem de ser instalado em anfitriões de agentes. Saiba mais sobre o xctool.
Nota:xctool foi preterido e não funciona com o Xcode 8.


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.

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 Compilação