Compartilhar via


tarefa XamariniOS@1 - Xamarin.iOS v1

Use essa tarefa em um pipeline para criar um aplicativo iOS com o Xamarin no macOS. Para obter mais informações, consulte as diretrizes do Xamarin e Assinar seu aplicativo 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órios. Valor padrão: **/*.sln.

Especifica o caminho relativo da raiz do repositório da Xamarin.iOS solução para o build. Pode conter curingas.


configuration - Configuração
string. Obrigatórios. Valor padrão: Release.

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


clean - Limpo
boolean. Valor padrão: false.

Opcional. Executa um build limpo (/t:clean) antes do build.


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

Se definido como true, gera um IPA como parte do build.


buildForSimulator - Compilar para o Simulador do iOS
Alias de entrada: forSimulator. boolean. Valor padrão: false.

Opcional. Compila para o Simulador do iOS em vez de dispositivos iOS físicos.


runNugetRestore - Executar a restauração do NuGet
boolean. Valor padrão: true.

É executado nuget restore na solução Xamarin iOS para instalar todos os pacotes referenciados antes do build. A nuget ferramenta no PATH do computador do agente de build é usada. Para usar uma versão diferente do NuGet ou definir argumentos adicionais, use a Tarefa do Instalador do NuGet.


args - Argumentos
string.

Opcional. Especifica argumentos de linha de comando adicionais que são usados para o build.


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

Opcional. Especifica o diretório de trabalho no qual os builds serão executados. Se o valor estiver vazio, a raiz do repositório será usada.


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

Especifica as ferramentas de build que a tarefa usará.


mdtoolFile - Caminho da ferramenta de build
Alias de entrada: mdtoolLocation. string.

Opcional. Fornece o caminho para xbuild (a ferramenta de build mono do Xamarin Studio) ou MSBuild (a ferramenta de build Visual Studio para Mac). Se o valor estiver vazio, o caminho padrão xbuild ou MSBuild será usado.


signingOption - Substituir usando
Alias de entrada: signMethod. string. Valores permitidos: file (Conteúdo do Arquivo) id (Identificadores). Valor padrão: file.

Use essa entrada se o build usar um método de assinatura ou provisionamento diferente do padrão. Escolha file usar um certificado P12 e um perfil de provisionamento. Escolha id recuperar as configurações de assinatura do conjunto de chaves padrão e dos perfis pré-instalados. Deixe os campos correspondentes em branco se você não quiser substituir as configurações de build padrão.


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

Substitui a identidade de assinatura que será usada para assinar o build. Se o valor estiver vazio, a configuração no projeto Xcode será usada. Talvez seja necessário selecionar signingUnlockDefaultKeychain se você usar essa opção.


signingUnlockDefaultKeychain - Desbloquear conjunto de chaves padrão
Alias de entrada: unlockDefaultKeychain. boolean. Opcional. Use quando signMethod = id. Valor padrão: false.

Resolve erros de "Interação do usuário não é permitida" desbloqueando o conjunto de chaves padrão.


signingDefaultKeychainPassword - Senha de conjunto de chaves padrão
Alias de entrada: defaultKeychainPassword. string. Opcional. Use quando signMethod = id.

Especifica a senha para desbloquear o conjunto de chaves padrão quando signingUnlockDefaultKeychain é definido.


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

Especifica a UUID de um perfil de provisionamento instalado a ser usado para esse build.


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

Especifica o caminho relativo para um arquivo de certificado P12 formatado em PKCS12 que contém um certificado de autenticação a ser usado para este build.


signingP12Password - Senha P12
Alias de entrada: p12pwd. string. Opcional. Use quando signMethod = file.

Especifica a senha para o arquivo de certificado P12. Use uma variável de build para criptografar esse valor.


signingProvisioningProfileFile - Arquivo de perfil de provisionamento
Alias de entrada: provProfile. string. Opcional. Use quando signMethod = file.

Especifica a UUID de uma substituição de perfil de provisionamento instalada a ser usada para esse build.


signingRemoveProfile - Remover perfil após o build
Alias de entrada: removeProfile. boolean. Opcional. Use quando signMethod = file. Valor padrão: false.

Especifica que o conteúdo do arquivo de perfil de provisionamento deve ser removido do agente de build após a conclusão do build. Habilite isso somente se você estiver executando um agente por usuário..


Opções de controle de tarefa

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

Variáveis de saída

Nenhum.

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico
É executado em Agent, DeploymentGroup
Demandas Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas para executar trabalhos que usam esta tarefa: Xamarin.iOS
Funcionalidades Essa tarefa não atende a nenhuma demanda por tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente Todas as versões do agente com suporte.
Categoria da tarefa Build