Compartilhar via

XamariniOS@2 – tarefa Xamarin.iOS v2

  • Artigo

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 v2
# Build an iOS app with Xamarin on macOS.
- task: XamariniOS@2
  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: false # boolean. Run NuGet restore. Default: false.
    #args: # string. Arguments. 
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #mdtoolFile: # string. Alias: buildToolLocation | mdtoolLocation. Build tool path. 
  # Signing & Provisioning
    #signingIdentity: # string. Alias: iosSigningIdentity. Signing identity. 
    #signingProvisioningProfileID: # string. Alias: provProfileUuid. Provisioning profile UUID.

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 ou do projeto csproj para o build. Pode conter caracteres curinga.


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 do aplicativo
boolean. Valor padrão: true.

Se definido truecomo , gerará 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 restauração do NuGet
boolean. Valor padrão: false.

É 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 compilar.


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.


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

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


signingIdentity - Identidade de assinatura
Alias de entrada: iosSigningIdentity. string.

Opcional. 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ê usa essa opção.


signingProvisioningProfileID - UUID do perfil de provisionamento
Alias de entrada: provProfileUuid. string.

Opcional. Especifica a UUID de uma substituição de perfil de provisionamento instalada a ser usada para esta compilação.


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.

Comentários

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.

Novidades nesta versão da tarefa

  • A configuração de inscrição do iOS foi removida da tarefa. Use Secure Files com tarefas Install Apple Certificate de suporte e Install Apple Provisioning Profile para configurar a assinatura. Opções atualizadas para funcionar melhor com Visual Studio for Mac.

Exemplos

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico
Executa em Agent, DeploymentGroup
Demandas Os agentes auto-hospedados devem ter recursos que correspondam às seguintes demandas para executar trabalhos que usam essa tarefa: Xamarin.iOS
Funcionalidades Essa tarefa não atende a nenhuma demanda para 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