Partilhar via


XamariniOS@1 - Tarefa Xamarin.iOS v1

Utilize esta tarefa num pipeline para criar uma aplicação iOS com Xamarin no macOS. Para obter mais informações, veja a documentação de orientação Xamarin e Assinar a aplicação durante a CI.

Syntax

# Xamarin.iOS v1
# Build an iOS app with Xamarin on macOS.
- task: XamariniOS@1
  inputs:
    solutionFile: '**/*.sln' # string. Alias: solution. Required. Solution. Default: **/*.sln.
    configuration: 'Release' # string. Required. Configuration. Default: Release.
    #clean: false # boolean. Clean. Default: false.
    #packageApp: true # boolean. Create app package. Default: true.
    #buildForSimulator: false # boolean. Alias: forSimulator. Build for iOS Simulator. Default: false.
  # Advanced
    #runNugetRestore: true # boolean. Run NuGet restore. Default: true.
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #buildToolOption: 'xbuild' # 'xbuild' | 'msbuild'. Alias: buildTool. Build tool. Default: xbuild.
    #mdtoolFile: # string. Alias: mdtoolLocation. Build tool path. 
  # Signing & Provisioning
    #signingOption: 'file' # 'file' | 'id'. Alias: signMethod. Override using. Default: file.
    #signingIdentity: # string. Alias: iosSigningIdentity. Optional. Use when signMethod = id. Signing identity. 
    #signingUnlockDefaultKeychain: false # boolean. Alias: unlockDefaultKeychain. Optional. Use when signMethod = id. Unlock default keychain. Default: false.
    #signingDefaultKeychainPassword: # string. Alias: defaultKeychainPassword. Optional. Use when signMethod = id. Default keychain password. 
    #signingProvisioningProfileID: # string. Alias: provProfileUuid. Optional. Use when signMethod = id. Provisioning profile UUID. 
    #signingP12File: # string. Alias: p12. Optional. Use when signMethod = file. P12 certificate file. 
    #signingP12Password: # string. Alias: p12pwd. Optional. Use when signMethod = file. P12 password. 
    #signingProvisioningProfileFile: # string. Alias: provProfile. Optional. Use when signMethod = file. Provisioning profile file. 
    #signingRemoveProfile: false # boolean. Alias: removeProfile. Optional. Use when signMethod = file. Remove profile after build. Default: false.

Entradas

solutionFile - Solução
Alias de entrada: solution. string. Obrigatório. Valor predefinido: **/*.sln.

Especifica o caminho relativo da raiz do repositório da Xamarin.iOS solução para a compilação. Pode conter carateres universais.


configuration - Configuração
string. Obrigatório. Valor predefinido: Release.

Especifica a configuração. As configurações padrão são Ad-Hoc, AppStore, Debug e Release.


clean - Limpar
boolean. Valor predefinido: false.

Opcional. Executa uma compilação limpa (/t:clean) antes da compilação.


packageApp - Criar pacote de aplicações
boolean. Valor predefinido: true.

Se definido como true, gera um IPA como parte da compilação.


buildForSimulator - Criar para o Simulador iOS
Alias de entrada: forSimulator. boolean. Valor predefinido: false.

Opcional. Compilações para o Simulador iOS em vez de dispositivos iOS físicos.


runNugetRestore - Executar o restauro do NuGet
boolean. Valor predefinido: true.

É executado nuget restore na solução Xamarin iOS para instalar todos os pacotes referenciados antes da compilação. É nuget utilizada a ferramenta no PATH do computador do agente de compilação. Para utilizar uma versão diferente do NuGet ou definir argumentos adicionais, utilize a Tarefa do Instalador NuGet.


args - Argumentos
string.

Opcional. Especifica argumentos de linha de comandos adicionais que são utilizados na compilação.


workingDirectory - Diretório de trabalho
Alias de entrada: cwd. string.

Opcional. Especifica o diretório de trabalho no qual as compilações serão executadas. Se o valor estiver vazio, será utilizada a raiz do repositório.


buildToolOption - Ferramenta de compilação
Alias de entrada: buildTool. string. Valores permitidos: xbuild (xbuild (Xamarin Studio)), msbuild (MSBuild (Visual Studio para Mac)). Valor predefinido: xbuild.

Especifica as ferramentas de compilação que a tarefa irá utilizar.


mdtoolFile - Caminho da ferramenta de compilação
Alias de entrada: mdtoolLocation. string.

Opcional. Fornece o caminho para xbuild (a ferramenta de criação mono do Xamarin Studio) ou MSBuild (a ferramenta de compilação Visual Studio para Mac). Se o valor estiver vazio, será utilizado o caminho predefinido xbuild ou MSBuild.


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

Utilize esta entrada se a compilação utilizar um método de assinatura ou de aprovisionamento diferente da predefinição. Opte por file utilizar um certificado P12 e um perfil de aprovisionamento. Opte por id 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.


signingIdentity - Identidade de assinatura
Alias de entrada: iosSigningIdentity. string. Opcional. Utilize quando signMethod = id.

Substitui a identidade de assinatura que será utilizada para assinar a compilação. Se o valor estiver vazio, será utilizada a definição no projeto Xcode. Poderá ter de selecionar signingUnlockDefaultKeychain se utilizar esta opção.


signingUnlockDefaultKeychain - Desbloquear porta-chaves predefinida
Alias de entrada: unlockDefaultKeychain. boolean. Opcional. Utilize quando signMethod = id. Valor predefinido: false.

Resolve os erros "A interação do utilizador não é permitida" ao desbloquear o keychain predefinido.


signingDefaultKeychainPassword - Palavra-passe de porta-chaves predefinida
Alias de entrada: defaultKeychainPassword. string. Opcional. Utilize quando signMethod = id.

Especifica a palavra-passe para desbloquear o keychain predefinido quando signingUnlockDefaultKeychain está definido.


signingProvisioningProfileID - UUID do perfil de aprovisionamento
Alias de entrada: provProfileUuid. string. Opcional. Utilize quando signMethod = id.

Especifica o UUID de um perfil de aprovisionamento instalado a ser utilizado para esta compilação.


signingP12File - Ficheiro de certificado P12
Alias de entrada: p12. string. Opcional. Utilize quando signMethod = file.

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


signingP12Password - Palavra-passe P12
Alias de entrada: p12pwd. string. Opcional. Utilize quando signMethod = file.

Especifica a palavra-passe para o ficheiro de certificado P12. Utilize uma variável de compilação para encriptar este valor.


signingProvisioningProfileFile - Ficheiro de perfil de aprovisionamento
Alias de entrada: provProfile. string. Opcional. Utilize quando signMethod = file.

Especifica o UUID de uma substituição de perfil de aprovisionamento instalada a ser utilizada para esta compilação.


signingRemoveProfile - Remover perfil após compilação
Alias de entrada: removeProfile. boolean. Opcional. Utilize quando signMethod = file. Valor predefinido: false.

Especifica que o conteúdo do ficheiro de perfil de aprovisionamento deve ser removido do agente de compilação após a conclusão da compilação. Ative esta opção apenas se estiver a executar um agente por utilizador.


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.

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