XamariniOS@2 - Tarefa Xamarin.iOS v2

Artigo
07/02/2024

Utilize esta tarefa num pipeline para criar uma aplicação iOS com Xamarin no macOS. Para obter mais informações, consulte a documentação de orientação Xamarin e Assinar a sua aplicação 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ório. Valor predefinido: **/*.sln.

Especifica o caminho relativo da raiz do repositório da Xamarin.iOS solução ou do projeto csproj 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 - Compilar 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 restauro NuGet
boolean. Valor predefinido: false.

É executada 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 adicionais da linha de comandos que são utilizados para compilar.

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, é utilizada a raiz do repositório.

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

Opcional. Fornece o caminho para xbuild (a ferramenta de compilaçã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.

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

Opcional. 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.

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

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

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.

Observações

Novidades nesta versão de tarefa

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

Exemplos

Criar a sua aplicação Xamarin

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

Partilhar via