Partilhar via


Xcode@3 - Tarefa Xcode Build v3

Use esta tarefa para criar um espaço de trabalho Xcode no macOS.

Sintaxe

# Xcode Build v3
# Build an Xcode workspace on macOS.
- task: Xcode@3
  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
    #archivePath: # string. Archive Path. 
    #exportPath: 'output/$(SDK)/$(Configuration)' # string. Export Path. Default: output/$(SDK)/$(Configuration).
    #exportOptions: 'auto' # 'auto' | 'plist' | 'specify'. 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. Export Arguments. 
  # 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.

Insumos

actions - Ações
string. Obrigatório. Valor padrão: 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 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).

Cria um projeto ou espaço de trabalho Xcode em relação ao SDK especificado. Execute xcodebuild -showsdks para ver uma lista válida de SDKs.


xcWorkspacePath - do espaço de trabalho/caminho do projeto
string. Valor padrão: **/*.xcodeproj/*.xcworkspace.

Opcional. Especifica o caminho relativo da raiz do repositório para o espaço de trabalho ou projeto Xcode. Por exemplo: MyApp/MyApp.xcworkspace ou MyApp/MyApp.xcworkspace/MyApp.xcodeproj. Deixe em branco se você pretende usar -target flag em Argumentos Avançados.


scheme - Esquema
string.

Opcional. Especifica o nome do esquema Xcode. Deve ser um esquema compartilhado (caixa de seleção compartilhada em Managed Schemes no Xcode). Obrigatório se o espaço de trabalho for especificado.


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

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


archivePath - de caminho de arquivo
string.

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


exportPath - Caminho de exportação
string. Valor padrão: output/$(SDK)/$(Configuration).

Opcional. Especifica o destino do produto exportado do arquivo.


exportOptions - Opções de exportação
string. Valores permitidos: auto, plist, specify. Valor padrão: auto.

Especifica uma maneira de passar Opções de Exportação ao exportar o arquivo.


Método de exportação exportMethod -
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, enterpriseou development.


exportTeamId - ID da Equipa
string. Opcional. Use quando exportOptions == specify.

Especifica o ID de equipe de 10 dígitos do Apple Developer Portal a ser usado para a exportação.


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

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


exportArgs - Argumentos de exportação
string.

Especifica argumentos de linha de comando adicionais usados para exportar.


xcode8AutomaticSigning - de assinatura automática
boolean. Valor padrão: false.

Use esta entrada se você tiver um projeto Xcode 8 ou Xcode 9 configurado para assinatura automática.


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

Especifica o ID da equipe de desenvolvedores de 10 dígitos. Isso é necessário se você for membro de várias equipes de desenvolvimento.


signMethod - Substituir usando
string. Valores permitidos: file (Conteúdo do arquivo), id (Identificadores). Valor padrão: file.

Use essa entrada se a compilação usar um método de assinatura ou provisionamento diferente do padrão. Escolha File Contents usar um certificado P12 e um perfil de provisionamento. Escolha Identifiers para recuperar as configurações de assinatura das chaves padrão e dos perfis pré-instalados. Deixe os campos correspondentes em branco se não desejar substituir as configurações de compilação padrão.


iosSigningIdentity - de identidade de assinatura
string. Opcional. Use quando signMethod = id.

Especifica a substituição de identidade de assinatura usada para assinar a compilação. O padrão é a configuração do projeto Xcode. Desbloquear Porta-chaves Padrão pode precisar ser selecionada.


unlockDefaultKeychain - Desbloquear Porta-chaves Padrão
boolean. Opcional. Use quando signMethod = id. Valor padrão: false.

Resolve a interação do usuário não é permitida erros desbloqueando as chaves padrão.


defaultKeychainPassword - Palavra-passe predefinida do porta-chaves
string. Opcional. Use quando signMethod = id.

Especifica a senha para desbloquear as chaves padrão.


provProfileUuid - Perfil de provisionamento UUID
string. Opcional. Use quando signMethod = id.

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


p12 - de arquivo de certificado P12
string. Opcional. Use quando signMethod = file.

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


p12pwd - Senha P12
string. Opcional. Use quando signMethod = file.

Especifica a senha para um arquivo de certificado P12. Use uma variável de compilação para criptografar.


provProfile - arquivo de perfil de provisionamento
string. Opcional. Use quando signMethod = file.

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


removeProfile - Remover perfil após a compilação
boolean. Opcional. Use quando signMethod = file. Valor padrão: false.

Remove o conteúdo do arquivo de perfil de provisionamento do agente de compilação após a conclusão da compilação. Verifique apenas se você está executando um agente por usuário.


args - Argumentos
string.

Especifica argumentos de linha de comando adicionais usados para compilar. Essa entrada é útil se você quiser usar -target ou -project em vez de especificar um espaço de trabalho e um esquema.


cwd - Diretório de Trabalho
string.

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


outputPattern - Diretório de saída
string. Obrigatório. Valor padrão: output/$(SDK)/$(Configuration).

Especifica o caminho relativo onde a saída de compilação (binários) é colocada.


xcodeDeveloperDir - do caminho do desenvolvedor do Xcode
string.

Opcional. Especifica o caminho para a pasta Xcode Developer se não for o padrão do sistema. Para uso quando várias versões do Xcode são instaladas em um sistema. Por exemplo: /Applications/Xcode 7.app/Contents/Developer.


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

Formata xcodebuild saída e gera um relatório de resultados de teste JUnit. Deve ser instalado em hosts de agente. Saiba mais sobre xcpretty.


publishJUnitResults - Publicar no VSTS/TFS
boolean. Valor padrão: false.

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


Opções de controlo de tarefas

Todas as tarefas têm opções de controle, além de suas entradas de tarefas. Para obter mais informações, consulte Opções de controle de e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Requerimentos

Requisito Descrição
Tipos de pipeline YAML, construção clássica
Funciona em Agente, DeploymentGroup
Exigências Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas executar trabalhos que usam essa tarefa: xcode
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente Todas as versões de agente suportadas.
Categoria de tarefa Construir