XamarinAndroid@1 - Attività Xamarin.Android v1

Articolo
07/02/2024

Usare questa attività per creare un'app Android con Xamarin.

Sintassi

# Xamarin.Android v1
# Build an Android app with Xamarin.
- task: XamarinAndroid@1
  inputs:
    projectFile: '**/*.csproj' # string. Alias: project. Required. Project. Default: **/*.csproj.
    #target: # string. Target. 
    #outputDirectory: # string. Alias: outputDir. Output directory. 
    #configuration: # string. Configuration. 
    #createAppPackage: true # boolean. Create app package. Default: true.
    #clean: false # boolean. Clean. Default: false.
  # MSBuild Options
    #msbuildLocationOption: 'version' # 'version' | 'location'. Alias: msbuildLocationMethod. MSBuild. Default: version.
    #msbuildVersionOption: '15.0' # 'latest' | '17.0' | '16.0' | '15.0' | '14.0' | '12.0' | '4.0'. Alias: msbuildVersion. Optional. Use when msbuildLocationMethod = version. MSBuild version. Default: 15.0.
    #msbuildFile: # string. Alias: msbuildLocation. Required when msbuildLocationMethod = location. MSBuild location. 
    #msbuildArchitectureOption: 'x86' # 'x86' | 'x64'. Alias: msbuildArchitecture. Optional. Use when msbuildLocationMethod = version. MSBuild architecture. Default: x86.
    #msbuildArguments: # string. Additional arguments. 
  # JDK Options
    jdkOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: jdkSelection. Required. Select JDK to use for the build. Default: JDKVersion.
    #jdkVersionOption: 'default' # 'default' | '1.11' | '1.10' | '1.9' | '1.8' | '1.7' | '1.6'. Alias: jdkVersion. Optional. Use when jdkSelection = JDKVersion. JDK version. Default: default.
    #jdkDirectory: # string. Alias: jdkUserInputPath. Required when jdkSelection = Path. JDK path. 
    #jdkArchitectureOption: 'x64' # 'x86' | 'x64'. Alias: jdkArchitecture. Optional. Use when jdkVersion != default. JDK architecture. Default: x64.

# Xamarin.Android v1
# Build an Android app with Xamarin.
- task: XamarinAndroid@1
  inputs:
    projectFile: '**/*.csproj' # string. Alias: project. Required. Project. Default: **/*.csproj.
    #target: # string. Target. 
    #outputDirectory: # string. Alias: outputDir. Output directory. 
    #configuration: # string. Configuration. 
    #createAppPackage: true # boolean. Create app package. Default: true.
    #clean: false # boolean. Clean. Default: false.
  # MSBuild Options
    #msbuildLocationOption: 'version' # 'version' | 'location'. Alias: msbuildLocationMethod. MSBuild. Default: version.
    #msbuildVersionOption: '15.0' # 'latest' | '15.0' | '14.0' | '12.0' | '4.0'. Alias: msbuildVersion. Optional. Use when msbuildLocationMethod = version. MSBuild version. Default: 15.0.
    #msbuildFile: # string. Alias: msbuildLocation. Required when msbuildLocationMethod = location. MSBuild location. 
    #msbuildArchitectureOption: 'x86' # 'x86' | 'x64'. Alias: msbuildArchitecture. Optional. Use when msbuildLocationMethod = version. MSBuild architecture. Default: x86.
    #msbuildArguments: # string. Additional arguments. 
  # JDK Options
    jdkOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: jdkSelection. Required. Select JDK to use for the build. Default: JDKVersion.
    #jdkVersionOption: 'default' # 'default' | '1.11' | '1.10' | '1.9' | '1.8' | '1.7' | '1.6'. Alias: jdkVersion. Optional. Use when jdkSelection = JDKVersion. JDK version. Default: default.
    #jdkDirectory: # string. Alias: jdkUserInputPath. Required when jdkSelection = Path. JDK path. 
    #jdkArchitectureOption: 'x64' # 'x86' | 'x64'. Alias: jdkArchitecture. Optional. Use when jdkVersion != default. JDK architecture. Default: x64.

Input

projectFile - Progetto
Alias di input: project. string. Obbligatorio. Valore predefinito: **/*.csproj.

Specifica il percorso relativo dalla radice del repository di Xamarin.Android progetti alla compilazione. È possibile usare caratteri jolly. Per altre informazioni, vedere riferimento ai modelli di corrispondenza dei file. Ad esempio, **/*.csproj per tutti i file csproj in tutte le sottocartelle. Il progetto deve avere una PackageForAndroid destinazione se Create App Package selezionata.

target - Bersaglio
string.

Specifica quali destinazioni compilare in questo progetto. Usare un punto e virgola per separare più destinazioni.

outputDirectory - Directory di output
Alias di input: outputDir. string.

facoltativo. Fornisce la directory di output per la compilazione. Esempio: $(build.binariesDirectory)/bin/Release.

configuration - Configurazione
string.

Specifica la configurazione da compilare. Ad esempio, debug o release.

Suggerimento

Dichiarare una variabile di compilazione, ad BuildConfiguration esempio nella scheda variabili (selezionando Allow in fase di coda) e fare riferimento qui come $(BuildConfiguration). È quindi possibile modificare la piattaforma quando si accoda la compilazione e abilitare la compilazione di più configurazioni.

createAppPackage - Creare il pacchetto dell'app
boolean. Valore predefinito: true.

Passa la destinazione, , (/t:PackageForAndroid)durante la compilazione per generare un APK.

clean - Pulito
boolean. Valore predefinito: false.

Passa la destinazione pulita, , (/t:clean)durante la compilazione.

msbuildLocationOption - Msbuild
Alias di input: msbuildLocationMethod. string. Valori consentiti: version, location (Specifica percorso). Valore predefinito: version.

Specifica il percorso di MSBuild (in Windows) o xbuild (in macOS). Il comportamento predefinito consiste nel cercare la versione più recente.

msbuildVersionOption - Versione di MSBuild
Alias di input: msbuildVersion. string. facoltativo. Usare quando msbuildLocationMethod = version. Valori consentiti: latest, 17.0 (MSBuild 17.0), (MSBuild 16.0), 15.0 (MSBuild 15.0 14.0 ), 16.0 (MSBuild 14.0 12.0 ), (MSBuild 12.0 4.0 ), (MSBuild 4.0). Valore predefinito: 15.0.

Specifica l'uso della versione più recente se non è possibile trovare la versione preferita. In macOS, verrà usato xbuild (Mono) o MSBuild (Visual Studio per Mac).

msbuildVersionOption - Versione di MSBuild
Alias di input: msbuildVersion. string. facoltativo. Usare quando msbuildLocationMethod = version. Valori consentiti: latest, 15.0 (MSBuild 15.0), (MSBuild 14.0), (MSBuild 12.0), 14.012.04.0 (MSBuild 4.0). Valore predefinito: 15.0.

Specifica l'uso della versione più recente se non è possibile trovare la versione preferita. In macOS, verrà usato xbuild (Mono) o MSBuild (Visual Studio per Mac).

msbuildFile - Posizione di MSBuild
Alias di input: msbuildLocation. string. Obbligatorio quando msbuildLocationMethod = location.

facoltativo. Specifica il percorso di MSBuild (in Windows) o xbuild (in macOS).

msbuildArchitectureOption - Architettura di MSBuild
Alias di input: msbuildArchitecture. string. facoltativo. Usare quando msbuildLocationMethod = version. Valori consentiti: x86 (MSBuild x86), x64 (MSBuild x64). Valore predefinito: x86.

Fornisce l'architettura (x86, x64) di MSBuild da eseguire.

msbuildArguments - Argomenti aggiuntivi
string.

Specifica argomenti aggiuntivi passati a MSBuild (in Windows) o xbuild (in macOS).

jdkOption - Selezionare JDK da usare per la compilazione
Alias di input: jdkSelection. string. Obbligatorio. Valori consentiti: JDKVersion (versione JDK), Path. Valore predefinito: JDKVersion.

Specifica la versione JDK usata dall'attività durante il processo di compilazione. Il JDKVersion valore specifica una versione JDK individuata dall'attività durante le compilazioni. Il Path valore specifica un percorso di file per una versione JDK.

jdkVersionOption - Versione JDK
Alias di input: jdkVersion. string. facoltativo. Usare quando jdkSelection = JDKVersion. Valori consentiti: default, 1.11 (JDK 11), (JDK 10 (fuori supporto) 1.9 ), (JDK 9 (fuori supporto)), (JDK 8 1.7 ), 1.10 (JDK 7 1.6 ), (JDK 6 (fuori supporto 1.8 )). Valore predefinito: default.

Specifica la versione JDK da usare durante la compilazione.

jdkDirectory - Percorso JDK
Alias di input: jdkUserInputPath. string. Obbligatorio quando jdkSelection = Path.

Specifica la versione JDK da usare durante la compilazione nel jdkSelection percorso.

jdkArchitectureOption - Architettura JDK
Alias di input: jdkArchitecture. string. facoltativo. Usare quando jdkVersion != default. Valori consentiti: x86, x64. Valore predefinito: x64.

Fornisce l'architettura (x86, x64) di JDK.

Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni

Usare questa attività per compilare un'app Android con Xamarin.

Esempio

Compilare l'app Xamarin

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica
Viene eseguito in	Agente, DeploymentGroup
Richieste	Gli agenti self-hosted devono avere funzionalità che soddisfano le richieste seguenti per eseguire processi che usano questa attività: MSBuild, Xamarin.Android
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	1.83.0 o versione successiva
Categoria attività	Compilazione

Condividi tramite