Condividi tramite

Proprietà di compilazione

  • Articolo

Le proprietà di MSBuild controllano il comportamento delle destinazioni.

Vengono specificati all'interno del file di progetto, ad esempio MyApp.csproj, all'interno di un gruppo di proprietà MSBuild.

Nota

In .NET per Android non esiste tecnicamente alcuna distinzione tra un'applicazione e un progetto di binding, quindi le proprietà funzioneranno in entrambi. In pratica, è consigliabile creare progetti di applicazioni e associazioni separati. Le proprietà usate principalmente nei progetti di binding sono documentate nella guida di riferimento alle proprietà del progetto di associazioni MSBuild.

AdbTarget

La $(AdbTarget) proprietà specifica il dispositivo di destinazione Android da cui può essere installato o rimosso il pacchetto Android. Il valore di questa proprietà corrisponde all'opzione adbDispositivo di destinazione.

AfterGenerateAndroidManifest

Le destinazioni MSBuild elencate in questa proprietà verranno eseguite direttamente dopo la destinazione interna _GenerateJavaStubs , che è la posizione in cui il AndroidManifest.xml file viene generato in $(IntermediateOutputPath). Se si desidera apportare modifiche al file generato AndroidManifest.xml , è possibile farlo usando questo punto di estensione.

AndroidAapt2CompileExtraArgs

Specifica le opzioni della riga di comando da passare al comando di compilazione aapt2 durante l'elaborazione di risorse e asset Android.

AndroidAapt2LinkExtraArgs

Specifica le opzioni della riga di comando da passare al comando di collegamento aapt2 durante l'elaborazione di risorse e asset Android.

AndroidAddKeepAlives

Proprietà booleana che controlla se il linker inserisce GC.KeepAlive() chiamate all'interno dei progetti di associazione per impedire la raccolta di oggetti prematuri.

Il valore predefinito è True per le build di configurazione della versione.

AndroidAotAdditionalArguments

Proprietà stringa che consente di passare le opzioni al compilatore Mono durante l'attività Aot per i progetti con $(AndroidEnableProfiledAot) o $(AotAssemblies) impostato su true. Il valore stringa della proprietà viene aggiunto al file di risposta quando si chiama il compilatore incrociato Mono.

In generale, questa proprietà deve essere lasciata vuota, ma in alcuni scenari speciali potrebbe offrire una flessibilità utile.

La $(AndroidAotAdditionalArguments) proprietà è diversa dalla proprietà correlata $(AndroidExtraAotOptions) . $(AndroidAotAdditionalArguments) Passa opzioni separate da spazio autonomo complete come --verbose o --debug al compilatore AOT, mentre $(AndroidExtraAotOptions) contiene argomenti delimitati da virgole che fanno parte dell'opzione --aot del compilatore AOT.

AndroidAotCustomProfilePath

File che aprofutil deve essere creato per contenere i dati del profiler.

AndroidAotProfiles

Proprietà stringa che consente allo sviluppatore di aggiungere profili AOT dalla riga di comando. Si tratta di un elenco delimitato da punto e virgola o da virgole di percorsi assoluti.

AndroidAotProfilerPort

Porta a cui aprofutil connettersi quando si ottengono i dati di profilatura.

AndroidAotEnableLazyLoad

Abilitare il caricamento differita (ritardato) degli assembly AOT-d, anziché precaricarli all'avvio. Il valore predefinito è True per le build release con qualsiasi forma di AOT abilitata.

Introdotto in .NET 6.

AndroidApkDigestAlgorithm

Valore stringa che specifica l'algoritmo digest da usare con jarsigner -digestalg.

Il valore predefinito è SHA-256.

AndroidApkSignerAdditionalArguments

Proprietà stringa che consente allo sviluppatore di fornire argomenti allo apksigner strumento.

AndroidApkSigningAlgorithm

Valore stringa che specifica l'algoritmo di firma da usare con jarsigner -sigalg.

Il valore predefinito è SHA256withRSA.

AndroidApplication

Valore booleano che indica se il progetto è per un'applicazione Android (True) o per un progetto di libreria Android (False o non presente).

In un pacchetto Android può essere presente un solo progetto con <AndroidApplication>True</AndroidApplication>. Purtroppo questo requisito non viene verificato, che può causare errori sottili e bizzarri relativi alle risorse Android.

AndroidApplicationJavaClass

Nome completo della classe Java da usare al posto di android.app.Application quando una classe eredita da Android.App.Application.

La $(AndroidApplicationJavaClass) proprietà viene in genere impostata da altre proprietà, ad esempio la $(AndroidEnableMultiDex) proprietà MSBuild.

AndroidAvoidEmitForPerformance

Proprietà booleana che determina se è "evitato" o meno System.Reflection.Emit per migliorare le prestazioni di avvio. Per impostazione predefinita, il valore della proprietà è True.

L'utilizzo di ha un impatto notevole sulle prestazioni di System.Reflection.Emit avvio in Android. Questo comportamento è disabilitato per impostazione predefinita per le opzioni di funzionalità seguenti:

  • Switch.System.Reflection.ForceInterpretedInvoke: dopo la seconda chiamata a MethodInfo.Invoke() o ConstructorInfo.Invoke(), il codice viene generato per migliorare le prestazioni delle chiamate ripetute.

  • Microsoft.Extensions.DependencyInjection.DisableDynamicEngine: dopo la seconda chiamata per recuperare un servizio da un contenitore di inserimento delle dipendenze, il codice viene generato per migliorare le prestazioni delle chiamate ripetute.

È consigliabile nella maggior parte delle applicazioni Android disabilitare questo comportamento.

Per informazioni dettagliate sui commutatori di funzionalità disponibili, vedere la documentazione relativa alle opzioni delle funzionalità delle librerie di classi di base.

Aggiunta in .NET 8.

AndroidBinUtilsPath

Percorso di una directory contenente i binutils android, ad ldesempio , il linker nativo e as, l'assembler nativo. Questi strumenti sono inclusi nel carico di lavoro .NET per Android.

Il valore predefinito è $(MonoAndroidBinDirectory)\binutils\bin\.

AndroidBoundExceptionType

Valore stringa che specifica come propagare le eccezioni quando un tipo fornito da .NET per Android implementa un tipo o un'interfaccia .NET in termini di tipi Java, ad esempio Android.Runtime.InputStreamInvoker e System.IO.Streamo Android.Runtime.JavaDictionary e System.Collections.IDictionary.

  • Java: il tipo di eccezione Java originale viene propagato così come è.

    Javasignifica che, ad esempio, InputStreamInvoker non implementa correttamente l'API System.IO.Stream perché Java.IO.IOException può essere generata da anziché System.IO.IOExceptionda Stream.Read() .

  • System: il tipo di eccezione Java originale viene intercettato e sottoposto a wrapping in un tipo di eccezione .NET appropriato.

    System significa che, ad esempio, InputStreamInvoker implementa System.IO.Streamcorrettamente e Stream.Read() non genera Java.IO.IOException istanze. Può invece generare un oggetto contenente un System.IO.IOException Java.IO.IOException oggetto come Exception.InnerException valore.

    System è il valore predefinito.

AndroidBoundInterfacesContainConstants

Proprietà booleana che determina se le costanti di associazione sulle interfacce saranno supportate o se verrà utilizzata la soluzione alternativa alla creazione di una IMyInterfaceConsts classe.

Il valore predefinito è True.

AndroidBoundInterfacesContainStaticAndDefaultInterfaceMethods

Proprietà booleana che indica se i membri predefiniti e statici nelle interfacce saranno supportati o una soluzione alternativa precedente per la creazione di una classe di pari livello contenente membri statici come abstract class MyInterface.

Il valore predefinito è True in .NET 6 e False per legacy.

AndroidBoundInterfacesContainTypes

Proprietà booleana che indica se i tipi annidati nelle interfacce saranno supportati o la soluzione alternativa alla creazione di un tipo non annidato, ad IMyInterfaceMyNestedClassesempio .

Il valore predefinito è True in .NET 6 e False per legacy.

AndroidBuildApplicationPackage

Valore booleano che indica se creare e firmare il pacchetto (.apk). L'impostazione di questo valore su True equivale all'uso di SignAndroidPackage destinazione di compilazione.

Per impostazione predefinita, il valore della proprietà è False.

AndroidBundleConfigurationFile

Specifica un nome file da usare come file di configurazione per bundletool durante la compilazione di un bundle di app Android. Questo file controlla alcuni aspetti del modo in cui gli API vengono generati dal bundle, ad esempio in quali dimensioni il bundle viene suddiviso per produrre API. .NET per Android configura automaticamente alcune di queste impostazioni, incluso l'elenco delle estensioni di file da non comprimere.

Questa proprietà è rilevante solo se $(AndroidPackageFormat) è impostata su aab.

AndroidBundleToolExtraArgs

Specifica le opzioni della riga di comando da passare al comando bundletool quando si compilano bundle di app.

AndroidClassParser

Proprietà stringa che controlla la modalità .jar di analisi dei file. I valori possibili includono:

  • class-parse: usa class-parse.exe per analizzare direttamente il bytecode Java senza ricorrere a JVM.

  • jar2xml: questo valore è obsoleto e non è più supportato.

AndroidCodegenTarget

Proprietà stringa che controlla l'ABI di destinazione della generazione del codice. I valori possibili includono:

  • XamarinAndroid: questo valore è obsoleto e non è più supportato.

  • XAJavaInterop1: usa Java.Interop per le chiamate JNI. Gli assembly di binding che usano XAJavaInterop1 possono solo essere compilati ed eseguiti con Xamarin.Android 6.1 o versioni successive. Xamarin.Android 6.1 e versioni successive eseguono il binding di Mono.Android.dll con questo valore.

Il valore predefinito è XAJavaInterop1.

AndroidCreatePackagePerAbi

Proprietà booleana che determina se è necessario creare un set di file, uno per ogni ABI specificato in $(AndroidSupportedAbis), anziché disporre del supporto per tutte le istanze abi in un singolo .apkoggetto .

Vedere anche la guida alla creazione di API specifiche di ABI.

AndroidCreateProguardMappingFile

Proprietà booleana che controlla se un file di mapping proguard viene generato come parte del processo di compilazione.

L'aggiunta del codice seguente al file csproj causerà la generazione del file e userà la AndroidProguardMappingFile proprietà per controllare il percorso del file di mapping finale.

<AndroidCreateProguardMappingFile>True</AndroidCreateProguardMappingFile>

Quando si producono .aab file, il file di mapping viene incluso automaticamente nel pacchetto. Non è necessario caricarlo manualmente in Google Play Store. Quando si usano .apk i file, sarà AndroidProguardMappingFile necessario caricarlo manualmente.

Il valore predefinito è quando si True usa $(AndroidLinkTool)=r8.

AndroidDebugKeyAlgorithm

Specifica l'algoritmo predefinito da utilizzare per .debug.keystore Il valore predefinito è RSA.

AndroidDebugKeyValidity

Specifica la validità predefinita da utilizzare per .debug.keystore Il valore predefinito è 10950 o 30 * 365 30 years.

AndroidDebugStoreType

Specifica il formato di file dell'archivio chiavi da utilizzare per .debug.keystore Il valore predefinito è pkcs12.

AndroidDeviceUserId

Consente la distribuzione e il debug dell'applicazione in account guest o aziendali. Il valore è il uid valore ottenuto dal comando adb seguente:

adb shell pm list users

Il comando precedente restituirà i dati seguenti:

Users:
	UserInfo{0:Owner:c13} running
	UserInfo{10:Guest:404}

uid è il primo valore intero. Nell'output precedente sono 0 e 10.

AndroidDexTool

Proprietà di tipo enumerazione con un valore valido di d8. In precedenza, un valore di dx è supportato in Xamarin.Android.

Indica quale compilatore dex Android viene usato durante il processo di compilazione .NET per Android. Il valore predefinito è d8. Vedere la documentazione su D8 e R8.

AndroidEnableDesugar

Proprietà booleana che determina se desugar è abilitata. Android attualmente non supporta tutte le funzionalità java 8 e la toolchain predefinita implementa le nuove funzionalità del linguaggio eseguendo trasformazioni bytecode, denominate desugar, nell'output del javac compilatore. Il valore predefinito è False se si usa $(AndroidDexTool)=dx e True se si usa=$(AndroidDexTool)d8 .

AndroidEnableGooglePlayStoreChecks

Proprietà bool che consente agli sviluppatori di disabilitare i controlli seguenti di Google Play Store: XA1004, XA1005 e XA1006. La disabilitazione di questi controlli è utile per gli sviluppatori che non hanno come destinazione Google Play Store e non vogliono eseguire tali controlli.

AndroidEnableMarshalMethods

Proprietà bool che determina se i metodi di marshalling LLVM sono abilitati o meno. I metodi di marshalling LLVM sono un'ottimizzazione dell'avvio dell'app che usa punti di ingresso nativi per la registrazione del metodo Java native .

Questa proprietà è False per impostazione predefinita.

Aggiunta in .NET 8.

AndroidEnableMultiDex

Proprietà booleana che determina se il supporto multidex verrà utilizzato o meno nell'oggetto finale .apk.

Per impostazione predefinita, il valore della proprietà è False.

AndroidEnableObsoleteOverrideInheritance

Proprietà booleana che determina se i metodi associati ereditano [Obsolete] automaticamente gli attributi dai metodi di cui eseguono l'override.

Il supporto per questa proprietà è stato aggiunto in .NET 8.

Per impostazione predefinita, il valore della proprietà è True.

AndroidEnablePreloadAssemblies

Proprietà booleana che controlla se tutti gli assembly gestiti raggruppati all'interno del pacchetto dell'applicazione vengono caricati o meno durante l'avvio del processo.

Se impostata su True, tutti gli assembly inclusi nel pacchetto dell'applicazione verranno caricati durante l'avvio del processo, prima che venga richiamato il codice dell'applicazione.

Se impostata su False, gli assembly verranno caricati solo all'occorrenza. Il caricamento di assembly in base alle esigenze consente alle applicazioni di avviare più velocemente e è anche più coerente con la semantica desktop .NET. Per visualizzare il tempo risparmiato, impostare la proprietà di sistema debug.mono.log in modo da includere timing e cercare il messaggio Finished loading assemblies: preloaded all'interno di adb logcat.

Le applicazioni o le librerie, che usano l'inserimento delle dipendenze, possono richiedere che questa proprietà sia True se a loro volta richiedano la AppDomain.CurrentDomain.GetAssemblies() restituzione di tutti gli assembly all'interno del bundle dell'applicazione, anche se l'assembly non sarebbe altrimenti necessario.

Per impostazione predefinita, questo valore è False.

AndroidEnableProfiledAot

Proprietà booleana che determina se i profili AOT vengono utilizzati durante la compilazione in anticipo.

I profili sono elencati in @(AndroidAotProfile) gruppo di elementi. Questo ItemGroup contiene i profili predefiniti. Può essere sottoposto a override rimuovendo uno o più profili AOT esistenti e aggiungendo i propri profili AOT.

Per impostazione predefinita, il valore della proprietà è False.

AndroidEnableRestrictToAttributes

Proprietà di tipo enumerazione con valori validi di obsolete e disable.

Se impostato su obsolete, i tipi e i membri contrassegnati con l'annotazione androidx.annotation.RestrictTo Java o che si trovano in pacchetti Java non esportati verranno contrassegnati con un [Obsolete] attributo nell'associazione C#.

Questo [Obsolete] attributo ha un messaggio descrittivo che spiega che il proprietario del pacchetto Java considera l'API "interna" e ne avvisa l'uso.

Questo attributo include anche un codice XAOBS001 di avviso personalizzato in modo che possa essere eliminato indipendentemente dall'API obsoleta "normale".

Se impostato su disable, l'API verrà generata come di consueto senza attributi aggiuntivi. Si tratta dello stesso comportamento di prima di .NET 8.

L'aggiunta [Obsolete] di attributi anziché la rimozione automatica dell'API è stata eseguita per mantenere la compatibilità dell'API con i pacchetti esistenti. Se invece si preferisce rimuovere i membri con l'annotazione o che si trovano in pacchetti Java non esportati, è possibile usare i file Transform oltre a questa proprietà per impedire l'associazione @RestrictTo di questi tipi:

<remove-node path="//*[@annotated-visibility]" />

Il supporto per questa proprietà è stato aggiunto in .NET 8.

Questa proprietà è impostata su obsolete per impostazione predefinita.

AndroidEnableSGenConcurrent

Proprietà booleana che determina se verrà utilizzato o meno l'agente di raccolta GC simultaneo di Mono.

Per impostazione predefinita, il valore della proprietà è False.

AndroidErrorOnCustomJavaObject

Proprietà booleana che determina se i tipi possono essere implementati Android.Runtime.IJavaObjectsenza ereditare anche da Java.Lang.Object o Java.Lang.Throwable:

class BadType : IJavaObject {
    public IntPtr Handle {
        get {return IntPtr.Zero;}
    }

    public void Dispose()
    {
    }
}

Se True, tali tipi genereranno un errore XA4212. In caso contrario, verrà generato un avviso XA4212.

Per impostazione predefinita, il valore della proprietà è True.

AndroidExplicitCrunch

Questa proprietà non è più supportata.

AndroidExtraAotOptions

Proprietà stringa che consente di passare le opzioni al compilatore Mono durante l'attività Aot per i progetti con $(AndroidEnableProfiledAot) o $(AotAssemblies) impostato su true. Il valore stringa della proprietà viene aggiunto al file di risposta quando si chiama il compilatore incrociato Mono.

In generale, questa proprietà deve essere lasciata vuota, ma in alcuni scenari speciali potrebbe offrire una flessibilità utile.

La $(AndroidExtraAotOptions) proprietà è diversa dalla proprietà correlata $(AndroidAotAdditionalArguments) . $(AndroidAotAdditionalArguments) Inserisce gli argomenti delimitati da virgole nell'opzione --aot del compilatore Mono. $(AndroidExtraAotOptions) passa invece al compilatore le opzioni separate da spazio autonomo complete, ad --verbose esempio o --debug al compilatore.

AndroidFastDeploymentType

Elenco : di valori delimitato da due punti per controllare quali tipi possono essere distribuiti nella directory Fast Deployment nel dispositivo di destinazione quando la $(EmbedAssembliesIntoApk) proprietà MSBuild è False. Se una risorsa viene distribuita con Fast Deployment, non viene incorporata nel file .apk generato, con la possibilità di accelerare i tempi di distribuzione. Maggiore è la distribuzione rapida, meno spesso .apk è necessario ricompilare e il processo di installazione può essere più veloce. I valori validi includono:

  • Assemblies: distribuisce gli assembly dell'applicazione.
  • Dexes: distribuire .dex file, librerie native e mapping dei tipi. Il Dexes valore può essere usato solo nei dispositivi che eseguono Android 4.4 o versione successiva (API-19).

Il valore predefinito è Assemblies.

Supporto per la distribuzione rapida di risorse e asset tramite tale sistema è stato rimosso nel commit f0d565fe. Questo perché richiedeva il funzionamento dell'API deprecata.

**Il supporto per questa funzionalità è stato rimosso in .NET 9

Sperimentale.

AndroidFragmentType

Specifica il tipo predefinito completo da usare per tutti gli elementi <fragment> del layout quando viene generato il codice dei binding di layout. Il valore predefinito è il tipo Android Android.App.Fragment standard.

AndroidGenerateJniMarshalMethods

Proprietà bool che consente la generazione di metodi di marshalling JNI come parte del processo di compilazione. In questo modo si riduce notevolmente l'utilizzo System.Reflection nel codice helper di associazione.

Il valore predefinito è False. Se gli sviluppatori vogliono usare la nuova funzionalità di marshalling JNI, possono impostare

<AndroidGenerateJniMarshalMethods>True</AndroidGenerateJniMarshalMethods>

nel relativo .csprojoggetto . In alternativa, specificare la proprietà sulla riga di comando usando

-p:AndroidGenerateJniMarshalMethods=True

Sperimentale. Il valore predefinito è False.

AndroidGenerateJniMarshalMethodsAdditionalArguments

Proprietà stringa che può essere usata per aggiungere parametri alla jnimarshalmethod-gen.exe chiamata ed è utile per il debug, in modo che sia possibile usare opzioni come -v, -do --keeptemp .

Il valore predefinito è una stringa vuota. Può essere impostato nel .csproj file o nella riga di comando. Ad esempio:

<AndroidGenerateJniMarshalMethodsAdditionalArguments>-v -d --keeptemp</AndroidGenerateJniMarshalMethodsAdditionalArguments>

oppure:

-p:AndroidGenerateJniMarshalMethodsAdditionalArguments="-v -d --keeptemp"

AndroidGenerateLayoutBindings

Abilita la generazione del code-behind del layout se impostata su o la disabilita completamente se impostata true su false.

Il valore predefinito è false.

AndroidGenerateResourceDesigner

Il valore predefinito è true. Se impostato su false, disabilita la generazione di Resource.designer.cs.

AndroidHttpClientHandlerType

Controlla l'implementazione predefinita System.Net.Http.HttpMessageHandler che verrà utilizzata dal System.Net.Http.HttpClient costruttore predefinito. Il valore è un nome di tipo qualificato dall'assembly di una sottoclasse HttpMessageHandler, adatta per l'uso con System.Type.GetType(string).

In .NET 6 e versioni successive questa proprietà ha effetto solo se usata insieme a $(UseNativeHttpHandler)=true. I valori più comuni per questa proprietà sono:

  • Xamarin.Android.Net.AndroidMessageHandler: usare le API Java Android per eseguire richieste HTTP. È simile alla legacy Xamarin.Android.Net.AndroidClientHandler con diversi miglioramenti. Supporta HTTP 1.1 e TLS 1.2. È il gestore di messaggi HTTP predefinito.

  • System.Net.Http.SocketsHttpHandler, System.Net.Http: gestore di messaggi predefinito in .NET. Supporta HTTP/2, TLS 1.2 ed è il gestore di messaggi HTTP consigliato da usare con Grpc.Net.Client. Questo valore equivale a $(UseNativeHttpHandler)=false.

  • Unset/la stringa vuota, che equivale a System.Net.Http.HttpClientHandler, System.Net.Http

    Corrisponde all'opzione Default nelle pagine delle proprietà di Visual Studio.

    La Creazione guidata nuovo progetto seleziona questa opzione per i nuovi progetti quando l'opzione Versione minima di Android viene impostata su Android 4.4.87 o versioni precedenti in Visual Studio o quando l'opzione Piattaforme di destinazione viene impostata su Sviluppo moderno o Compatibilità massima in Visual Studio per Mac.

  • System.Net.Http.HttpClientHandler, System.Net.Http: usare l'oggetto gestito HttpMessageHandler.

    Corrisponde all'opzione Gestita nelle pagine delle proprietà di Visual Studio.

Nota

In .NET 6 il tipo specificato non deve essere Xamarin.Android.Net.AndroidClientHandler o System.Net.Http.HttpClientHandler ereditare da una di queste classi. Se si esegue la migrazione da Xamarin.Android "classico", usare AndroidMessageHandler o derivare il gestore personalizzato da esso.

Nota

Il supporto per la $(AndroidHttpClientHandlerType) proprietà funziona impostando la XA_HTTP_CLIENT_HANDLER_TYPE variabile di ambiente. Valore $XA_HTTP_CLIENT_HANDLER_TYPE trovato in un file con un'azione Di compilazione di @(AndroidEnvironment) avrà la precedenza.

AndroidIncludeWrapSh

Valore booleano che indica se lo script wrapper Android (wrap.sh) deve essere inserito nel pacchetto nell'APK. Il valore predefinito è false poiché lo script wrapper può influire significativamente sulla modalità di avvio e funzionamento dell'applicazione e lo script deve essere incluso solo quando necessario, ad esempio quando si esegue il debug o si modifica il comportamento di avvio/runtime dell'applicazione.

Lo script viene aggiunto al progetto usando @(AndroidNativeLibrary) azione di compilazione, perché viene inserita nella stessa directory delle librerie native specifiche dell'architettura e deve essere denominata wrap.sh.

Il modo più semplice per specificare il percorso dello script consiste nell'inserirlo wrap.sh in una directory denominata dopo l'architettura di destinazione. Questo approccio funzionerà se si dispone di una wrap.sh sola architettura:

<AndroidNativeLibrary Include="path/to/arm64-v8a/wrap.sh" />

Tuttavia, se il progetto richiede più di un'architettura wrap.sh , per scopi diversi, questo approccio non funzionerà. In questi casi, invece, è possibile specificare il nome usando i Link metadati di AndroidNativeLibrary:

<AndroidNativeLibrary Include="/path/to/my/arm64-wrap.sh">
  <Link>lib\arm64-v8a\wrap.sh</Link>
</AndroidNativeLibrary>

Se vengono usati i Link metadati, il percorso specificato nel relativo valore deve essere un percorso di libreria specifico dell'architettura nativa valido, relativo alla directory radice APK. Il formato del percorso è lib\ARCH\wrap.sh dove ARCH può essere uno dei seguenti:

  • arm64-v8a
  • armeabi-v7a
  • x86_64
  • x86

AndroidIncludeAssetPacksInPackage

Questa proprietà controlla se una compilazione di Asset Pack viene inclusa automaticamente nel file finale .aab . Per impostazione predefinita, verrà impostato su true.

In alcuni casi l'utente potrebbe voler rilasciare una versione provvisoria. In questi casi l'utente non deve aggiornare il pacchetto di asset. Soprattutto se il contenuto del pacchetto di asset non è stato modificato. Questa proprietà consente all'utente di ignorare i pacchetti di asset, se non sono necessari.

Aggiunta in .NET 9

AndroidInstallJavaDependencies

Il valore predefinito è true per le compilazioni della riga di comando. Se impostato su true, abilita l'installazione di Java SDK quando si esegue la <InstallAndroidDependencies/> destinazione.

Il supporto per questa proprietà è stato aggiunto in .NET 9.

AndroidJavadocVerbosity

Specifica il modo in cui devono essere "verbose" i commenti della documentazione XML C# durante l'importazione della documentazione Javadoc all'interno dei progetti di associazione.

Richiede l'uso di @(JavaSourceJar) azione di compilazione.

La $(AndroidJavadocVerbosity) proprietà è simile a enumerazione, con valori possibili di full o intellisense:

Il valore predefinito è intellisense.

AndroidKeyStore

Valore booleano che indica se devono essere utilizzate informazioni di firma personalizzate. Il valore predefinito è False, indicante che per la firma dei pacchetti verrà usata la chiave di firma di debug.

AndroidLaunchActivity

Attività Android da avviare.

AndroidLinkMode

Specifica il tipo di collegamento da eseguire sugli assembly contenuti nel pacchetto Android. Usato solo nei progetti Applicazione Android. Il valore predefinito è SdkOnly. I valori validi sono:

  • None: non verranno tentati collegamenti.

  • SdkOnly: il collegamento verrà eseguito solo nelle librerie di classi base e non negli assembly dell'utente.

  • Full: il collegamento verrà eseguito nelle librerie di classi base e negli assembly dell'utente.

    Nota

    se si usa Full come valore di AndroidLinkMode, spesso le app vengono interrotte, soprattutto quando viene usata la reflection. Evitarlo a meno che non se ne sia davvero certi.

<AndroidLinkMode>SdkOnly</AndroidLinkMode>

AndroidLinkResources

Quando true, il sistema di compilazione collega i tipi annidati della classe Resource.Designer.cs Resource in tutti gli assembly. Il codice IL che usa tali tipi verrà aggiornato per usare i valori direttamente anziché accedere ai campi.

Il collegamento dei tipi annidati può avere un impatto ridotto sulla riduzione delle dimensioni dell'apk e può anche contribuire alle prestazioni di avvio. Sono collegate solo le build "Release".

Sperimentale. Progettato solo per funzionare con codice, ad esempio

var view = FindViewById(Resources.Ids.foo);

Gli altri scenari (ad esempio reflection) non saranno supportati.

AndroidLinkSkip

Specifica un elenco delimitato da punto e virgola (;) di nomi di assembly, senza estensioni di file, di assembly che non devono essere collegati. Usato solo nei progetti Applicazione Android.

<AndroidLinkSkip>Assembly1;Assembly2</AndroidLinkSkip>

AndroidLinkTool

Proprietà di tipo enumerazione con valori validi di proguard o r8. Indica quale strumento viene usato per compattare il codice Java. Il valore predefinito è una stringa vuota o proguard se $(AndroidEnableProguard) è True. Vedere la documentazione su D8 e R8.

AndroidLintEnabled

Proprietà bool che consente allo sviluppatore di eseguire lo strumento Android lint come parte del processo di creazione del pacchetto.

Quando $(AndroidLintEnabled)=True, vengono usate le proprietà seguenti:

È anche possibile usare le azioni di compilazione seguenti:

Vedere la guida di Lint per maggiori dettagli sullo strumento lint di Android.

AndroidLintEnabledIssues

Proprietà stringa che rappresenta un elenco delimitato da virgole di problemi lint da abilitare.

Utilizzato solo quando $(AndroidLintEnabled)=True.

AndroidLintDisabledIssues

Proprietà stringa che rappresenta un elenco delimitato da virgole di problemi di lint da disabilitare.

Utilizzato solo quando $(AndroidLintEnabled)=True.

AndroidLintCheckIssues

Proprietà stringa che rappresenta un elenco delimitato da virgole di problemi lint da controllare.

Utilizzato solo quando $(AndroidLintEnabled)=True.

Nota: verranno controllati solo questi problemi.

AndroidManagedSymbols

Proprietà booleana che controlla se i punti di sequenza vengono generati in modo che le informazioni sul nome file e sul numero di riga possano essere estratte dalle Release tracce dello stack.

AndroidManifest

Specifica un nome file da usare come modello per l'app AndroidManifest.xml. Durante la compilazione, verranno uniti gli altri valori necessari per generare il file AndroidManifest.xml effettivo. $(AndroidManifest) deve contenere il nome del pacchetto nell'attributo /manifest/@package.

AndroidManifestMerger

Specifica l'implementazione per l'unione di file AndroidManifest.xml . Si tratta di una proprietà di tipo enumerazione in cui legacy seleziona l'implementazione C# originale e manifestmerger.jar seleziona l'implementazione Java di Google.

Il valore predefinito è attualmente manifestmerger.jar. Se si vuole usare la versione precedente, aggiungere quanto segue al file csproj

<AndroidManifestMerger>legacy</AndroidManifestMerger>

La fusione di Google consente il supporto per xmlns:tools="http://schemas.android.com/tools" come descritto nella documentazione di Android.

AndroidManifestMergerExtraArgs

Proprietà stringa per fornire argomenti allo strumento di documentazione di Android.

Se si vuole ottenere un output dettagliato dallo strumento, è possibile aggiungere quanto segue a .csproj.

<AndroidManifestMergerExtraArgs>--log VERBOSE</AndroidManifestMergerExtraArgs>

AndroidManifestType

Proprietà di tipo enumerazione con valori validi di Xamarin o GoogleV2. Questo controlla quale repository viene usato da InstallAndroidDependencies destinazione per determinare quali pacchetti Android e versioni dei pacchetti sono disponibili e possono essere installati.

Xamarin è il repository Elenco approvato (consigliato) in Visual Studio SDK Manager.

GoogleV2 è il repository Elenco completo (non supportato) all'interno di Visual Studio SDK Manager.

Se $(AndroidManifestType) non è impostato, Xamarin viene usato .

AndroidManifestPlaceholders

Elenco delimitato da punto e virgola di coppie di sostituzione chiave-valore per AndroidManifest.xml, in cui ogni coppia ha il formato key=value.

Ad esempio, un valore della proprietà definisce assemblyName=$(AssemblyName) un ${assemblyName} segnaposto che può essere visualizzato in AndroidManifest.xml:

<application android:label="${assemblyName}"

In questo modo è possibile inserire variabili dal processo di compilazione nel file AndroidManifest.xml .

AndroidMultiDexClassListExtraArgs

Proprietà stringa che consente agli sviluppatori di passare argomenti a durante com.android.multidex.MainDexListBuilder la generazione del multidex.keep file.

Un caso specifico è se si riceve l'errore seguente durante la compilazione di dx.

com.android.dex.DexException: Too many classes in --main-dex-list, main dex capacity exceeded

Se viene visualizzato questo errore, è possibile aggiungere quanto segue a .csproj.

<DxExtraArguments>--force-jumbo </DxExtraArguments>
<AndroidMultiDexClassListExtraArgs>--disable-annotation-resolution-workaround</AndroidMultiDexClassListExtraArgs>

che consentirà al dx passaggio di avere esito positivo.

AndroidPackageFormat

Proprietà di tipo enumerazione con valori validi di apk o aab. Indica se si vuole creare un pacchetto dell'applicazione Android come file APK o bundle di app Android. I bundle di app sono un nuovo formato per le compilazioni Release destinate all'invio in Google Play. Il valore predefinito è apk.

Quando $(AndroidPackageFormat) è impostato su aab, vengono impostate altre proprietà di MSBuild, necessarie per i bundle di app Android:

Questa proprietà verrà deprecata per .net 6. Gli utenti devono passare alla versione più recente AndroidPackageFormats.

AndroidPackageFormats

Proprietà delimitata da punti e virgola con valori validi di apk e aab. Indica se si vuole creare un pacchetto dell'applicazione Android come file APK o bundle di app Android. I bundle di app sono un nuovo formato per le compilazioni Release destinate all'invio in Google Play.

Quando si compila una build di rilascio, è possibile generare sia che aab una apk per la distribuzione in vari archivi.

L'impostazione su AndroidPackageFormats aab;apk comporterà la generazione di entrambi. Se si imposta AndroidPackageFormats su aab o apk verrà generato un solo file.

Il valore predefinito è aab;apk solo per Release le compilazioni. È consigliabile continuare a usare solo apk per il debug.

AndroidPackageNamingPolicy

Proprietà di tipo enumerazione per specificare i nomi dei pacchetti Java del codice sorgente Java generato.

L'unico valore supportato è LowercaseCrc64.

AndroidPrepareForBuildDependsOn

Proprietà delimitata da punti e virgola che può essere usata per estendere il processo di compilazione Android. Le destinazioni MSBuild aggiunte a questa proprietà verranno eseguite all'inizio della compilazione per i tipi di progetto Application e Library. Questa proprietà è vuota per impostazione predefinita.

Esempio:

<PropertyGroup>
  <AndroidPrepareForBuildDependsOn>MyCustomTarget</AndroidPrepareForBuildDependsOn>
</PropertyGroup>

<Target Name="MyCustomTarget" >
  <Message Text="Running target: 'MyCustomTarget'" Importance="high"  />
</Target>

AndroidProguardMappingFile

Specifica la -printmapping regola proguard per r8. Ciò significa che il mapping.txt file verrà prodotto nella $(OutputPath) cartella . Questo file può quindi essere usato durante il caricamento di pacchetti in Google Play Store.

Per impostazione predefinita, questo file viene generato automaticamente quando si usa AndroidLinkTool=r8 e genera il file $(OutputPath)mapping.txtseguente.

Se non si vuole generare questo file di mapping, è possibile utilizzare la proprietà per interrompere la AndroidCreateProguardMappingFile creazione. Aggiungere quanto segue nel progetto

<AndroidCreateProguardMappingFile>False</AndroidCreateProguardMappingFile>

oppure usare -p:AndroidCreateProguardMappingFile=False nella riga di comando.

AndroidD8IgnoreWarnings

Specifica --map-diagnostics warning info che deve essere passato a d8. Il valore predefinito è True, ma può essere impostato su per False applicare un comportamento più rigoroso. Per informazioni dettagliate, vedere il codice sorgente D8 e R8.

Aggiunta in .NET 8.

AndroidR8IgnoreWarnings

Specifica la -ignorewarnings regola proguard per r8. Ciò consente di r8 continuare con la compilazione dex anche se vengono rilevati determinati avvisi. Il valore predefinito è True, ma può essere impostato su per False applicare un comportamento più rigoroso. Per informazioni dettagliate, vedere il manuale di ProGuard.

A partire da .NET 8, specifica --map-diagnostics warning info. Per informazioni dettagliate, vedere il codice sorgente D8 e R8.

AndroidR8JarPath

Percorso da r8.jar usare con il compilatore dex e il compattatore r8. Il valore predefinito è un percorso nell'installazione del carico di lavoro .NET per Android. Per altre informazioni, vedere la documentazione su D8 e R8.

AndroidResgenExtraArgs

Specifica le opzioni della riga di comando da passare al comando aapt durante l'elaborazione di risorse e asset Android.

AndroidResgenFile

Specifica il nome del file di risorse da generare. Il modello predefinito lo imposta su Resource.designer.cs.

AndroidResourceDesignerClassModifier

Specifica il modificatore di classe per la classe intermedia Resource generata. I valori validi sono public e internal.

Per impostazione predefinita, sarà public.

Aggiunta in .NET 9.

AndroidSdkBuildToolsVersion

Il pacchetto di strumenti di compilazione di Android SDK fornisce gli strumenti aapt e zipalign , tra gli altri. Più versioni diverse del pacchetto di strumenti di compilazione possono essere installate contemporaneamente. Il pacchetto di strumenti di compilazione scelto per la creazione di pacchetti viene creato cercando e usando una versione "preferita" degli strumenti di compilazione, se presente. Se la versione "preferita" non è presente, viene usato il pacchetto di strumenti di compilazione installato con la versione superiore.

La proprietà MSBuild $(AndroidSdkBuildToolsVersion) contiene la versione preferita degli strumenti di compilazione. Il sistema di compilazione .NET per Android fornisce un valore predefinito in Xamarin.Android.Common.targetse il valore predefinito può essere sottoposto a override all'interno del file di progetto per scegliere una versione alternativa degli strumenti di compilazione, se (ad esempio) l'aapt più recente si arresta in modo anomalo mentre è nota la versione precedente di aapt.

AndroidSigningKeyAlias

Specifica l'alias per la chiave nell'archivio chiavi. Si tratta del valore keytool -alias usato durante la creazione dell'archivio chiavi.

AndroidSigningKeyPass

Specifica la password della chiave all'interno del file dell'archivio chiavi. Si tratta del valore immesso quando keytool chiede di immettere la password della chiave per $(AndroidSigningKeyAlias).

Questa proprietà supporta env: anche i prefissi e file: che possono essere usati per specificare una variabile di ambiente o un file che contiene la password. Queste opzioni consentono di impedire la visualizzazione della password nei log di compilazione.

Ad esempio, per usare una variabile di ambiente denominata AndroidSigningPassword:

<PropertyGroup>
  <AndroidSigningKeyPass>env:AndroidSigningPassword</AndroidSigningKeyPass>
</PropertyGroup>

Per usare un file che si trova in C:\Users\user1\AndroidSigningPassword.txt:

<PropertyGroup>
  <AndroidSigningKeyPass>file:C:\Users\user1\AndroidSigningPassword.txt</AndroidSigningKeyPass>
</PropertyGroup>

Nota

Il env: prefisso non è supportato quando $(AndroidPackageFormat) è impostato su aab.

AndroidSigningKeyStore

Specifica il nome del file dell'archivio chiavi creato da keytool. Corrisponde al valore fornito all'opzione keytool -keystore.

AndroidSigningStorePass

Specifica la password di $(AndroidSigningKeyStore). Si tratta del valore fornito a keytool quando si è creato il file dell'archivio chiavi ed è stato chiesto di immettere la password dell'archivio chiavi.

Questa proprietà supporta env: anche i prefissi e file: che possono essere usati per specificare una variabile di ambiente o un file che contiene la password. Queste opzioni consentono di impedire la visualizzazione della password nei log di compilazione.

Ad esempio, per usare una variabile di ambiente denominata AndroidSigningPassword:

<PropertyGroup>
  <AndroidSigningStorePass>env:AndroidSigningPassword</AndroidSigningStorePass>
</PropertyGroup>

Per usare un file che si trova in C:\Users\user1\AndroidSigningPassword.txt:

<PropertyGroup>
  <AndroidSigningStorePass>file:C:\Users\user1\AndroidSigningPassword.txt</AndroidSigningStorePass>
</PropertyGroup>

Nota

Il env: prefisso non è supportato quando $(AndroidPackageFormat) è impostato su aab.

AndroidSigningPlatformKey

Specifica il file di chiave da usare per firmare l'apk. Questa operazione viene usata solo durante la compilazione di system applicazioni.

AndroidSigningPlatformCert

Specifica il file di certificato da usare per firmare l'apk. Questa operazione viene usata solo durante la compilazione di system applicazioni.

AndroidStripILAfterAOT

Proprietà bool che specifica se i corpi del metodo dei metodi compilati da AOT verranno rimossi.

Il valore predefinito è falsee i corpi del metodo dei metodi compilati AOT non verranno rimossi.

Se impostato su , $(AndroidEnableProfiledAot) è impostato truesu per false impostazione predefinita. Ciò significa che nelle build di configurazione del rilascio, in cui $(RunAOTCompilation) è true per impostazione predefinita, AOT è abilitato per tutti gli elementi. Ciò può comportare un aumento delle dimensioni dell'app. Questo comportamento può essere sottoposto a override impostando $(AndroidEnableProfiledAot) in modo esplicito su true all'interno del file di progetto.

Il supporto per questa proprietà è stato aggiunto in .NET 8.

AndroidSupportedAbis

Proprietà stringa che contiene un elenco delimitato da punto e virgola (;) di ABI che deve essere incluso in .apk.

I valori supportati includono:

  • armeabi-v7a
  • x86
  • arm64-v8a
  • x86_64

AndroidTlsProvider

Questa proprietà è obsoleta e non deve essere utilizzata.

AndroidUseAapt2

Proprietà booleana che consente allo sviluppatore di controllare l'uso dello strumento per la aapt2 creazione di pacchetti. Per impostazione predefinita, questa opzione sarà True.

Questa proprietà non può essere impostata su false.

AndroidUseApkSigner

Proprietà bool che consente allo sviluppatore di usare lo apksigner strumento anziché jarsigner.

AndroidUseDefaultAotProfile

Proprietà bool che consente allo sviluppatore di eliminare l'utilizzo dei profili AOT predefiniti.

Per eliminare i profili AOT predefiniti, impostare la proprietà su false.

AndroidUseDesignerAssembly

Proprietà bool che controlla se il sistema di compilazione genererà un oggetto _Microsoft.Android.Resource.Designer.dll come apposed a un Resource.Designer.cs file. I vantaggi di questo sono applicazioni più piccole e tempi di avvio più veloci.

Il valore predefinito è true in .NET 8.

Come autore nuget, è consigliabile spedire tre versioni dell'assembly se si vuole mantenere la compatibilità con le versioni precedenti. Uno per MonoAndroid, uno per net6.0-android e uno per net8.0-android. A tale scopo, è possibile usare Xamarin.Legacy.Sdk. Questa operazione è necessaria solo se il progetto della libreria Nuget usa AndroidResource elementi nel progetto o tramite una dipendenza.

<TargetFrameworks>monoandroid90;net6.0-android;net8.0-android</TargetFrameworks>

In alternativa, disattivare questa impostazione fino a quando non è stata deprecata sia la versione classica che net7.0-android.

I progetti .NET 8 che scelgono di disattivare questa impostazione non potranno utilizzare riferimenti che lo usano. Se si tenta di usare un assembly in cui questa funzionalità è abilitata in un progetto che non lo fa, verrà visualizzato un XA1034 errore di compilazione.

Aggiunta in .NET 8.

AndroidUseInterpreter

Proprietà booleana che fa sì che l'oggetto .apk contenga l'interprete mono e non il normale JIT.

Sperimentale.

AndroidUseLegacyVersionCode

Proprietà booleana che consente allo sviluppatore di ripristinare il comportamento precedente di Xamarin.Android 8.2 del calcolo versionCode. Deve essere usata SOLO dagli sviluppatori con applicazioni esistenti in Google Play Store. È consigliabile usare la nuova proprietà $(AndroidVersionCodePattern).

AndroidUseManagedDesignTimeResourceGenerator

Proprietà booleana che passerà alla compilazione in fase di progettazione per usare il parser delle risorse gestite anziché aapt.

AndroidUseNegotiateAuthentication

Proprietà booleana che abilita il supporto per l'autenticazione NTLMv2/Negotiate in AndroidMessageHandler. Il valore predefinito è Falso.

Aggiunta in .NET 7.

AndroidUseSharedRuntime

Questa proprietà è obsoleta e non deve essere utilizzata.

AndroidVersionCode

Proprietà MSBuild che può essere usata come alternativa al /manifest/@android:versionCode AndroidManifest.xml file. Per acconsentire esplicitamente a questa funzionalità, è necessario abilitare <GenerateApplicationManifest>true</GenerateApplicationManifest>anche . Questa sarà l'impostazione predefinita in futuro in .NET 6.

Questa proprietà viene ignorata se $(AndroidCreatePackagePerAbi) e $(AndroidVersionCodePattern) vengono utilizzati.

@android:versionCode è un valore intero che deve essere incrementato per ogni versione di Google Play. Per altri dettagli sui requisiti per , vedere la documentazione di Android./manifest/@android:versionCode

AndroidVersionCodePattern

Proprietà stringa che consente allo sviluppatore di personalizzare nel versionCode manifesto. Per informazioni utili per decidere riguardo a versionCode, vedere Creazione del codice della versione per l'APK.

Alcuni esempi: se abi è armeabi e versionCode nel manifesto è 123, {abi}{versionCode} genererà un elemento versionCode 1123 quando $(AndroidCreatePackagePerAbi) è True. In caso contrario genererà il valore 123. Se abi è x86_64 e versionCode nel manifesto è 44, verrà generato 544 quando $(AndroidCreatePackagePerAbi) è True. In caso contrario, genererà il valore 44.

Se viene inclusa una stringa di formato con riempimento a sinistra {abi}{versionCode:0000}, genererà 50044 perché si riempie versionCode a sinistra con 0. In alternativa, è possibile usare il riempimento decimale, ad esempio {abi}{versionCode:D4} che equivale all'esempio precedente.

Sono supportate solo le stringhe in formato con riempimento "0" e "Dx" perché il valore DEVE essere un intero.

Elementi chiave predefiniti

  • abi: inserisce l'abi di destinazione per l'app

    • 2 – armeabi-v7a
    • 3 – x86
    • 4 – arm64-v8a
    • 5 – x86_64

  • minSDK : inserisce il valore sdk minimo supportato da AndroidManifest.xml o 11 se non è definito nessuno.

  • versionCode : usa il codice della versione direttamente da Properties\AndroidManifest.xml.

È possibile definire gli elementi personalizzati usando la proprietà $(AndroidVersionCodeProperties) (definita successivamente).

Per impostazione predefinita, il valore verrà impostato su {abi}{versionCode:D6}. Se uno sviluppatore vuole mantenere il comportamento precedente può ignorare l'impostazione predefinita impostando la proprietà $(AndroidUseLegacyVersionCode) su true

AndroidVersionCodeProperties

Proprietà stringa che consente allo sviluppatore di definire elementi personalizzati da usare con .$(AndroidVersionCodePattern) sotto forma di coppia key=value. Tutti gli elementi in value devono essere valori interi. Ad esempio: screen=23;target=$(_AndroidApiLevel). Come si può osservare, è possibile usare nella stringa proprietà MSBuild esistenti o personalizzate.

ApplicationId

Proprietà MSBuild che può essere usata come alternativa al /manifest/@package AndroidManifest.xml file. Per acconsentire esplicitamente a questa funzionalità, è necessario abilitare <GenerateApplicationManifest>true</GenerateApplicationManifest>anche . Questa sarà l'impostazione predefinita in futuro in .NET 6.

Per altri dettagli sui requisiti per , vedere la documentazione di Android./manifest/@package

ApplicationTitle

Proprietà MSBuild che può essere usata come alternativa al /manifest/application/@android:label AndroidManifest.xml file. Per acconsentire esplicitamente a questa funzionalità, è necessario abilitare <GenerateApplicationManifest>true</GenerateApplicationManifest>anche . Questa sarà l'impostazione predefinita in futuro in .NET 6.

Per altri dettagli sui requisiti per , vedere la documentazione di Android./manifest/application/@android:label

ApplicationVersion

Proprietà MSBuild che può essere usata come alternativa al /manifest/@android:versionName AndroidManifest.xml file. Per acconsentire esplicitamente a questa funzionalità, è necessario abilitare <GenerateApplicationManifest>true</GenerateApplicationManifest>anche . Questa sarà l'impostazione predefinita in futuro in .NET 6.

Per altri dettagli sui requisiti per , vedere la documentazione di Android./manifest/@android:versionName

AotAssemblies

Proprietà booleana che determina se gli assembly verranno compilati in anticipo nel codice nativo e inclusi nelle applicazioni. Per impostazione predefinita, il valore della proprietà è False.

Deprecato in .NET 7. Eseguire invece la migrazione alla nuova $(RunAOTCompilation) proprietà MSBuild, perché il supporto per $(AotAssemblies) verrà rimosso in una versione futura.

AProfUtilExtraOptions

Opzioni aggiuntive da passare a aprofutil.

BeforeBuildAndroidAssetPacks

Le destinazioni MSBuild elencate in questa proprietà verranno eseguite direttamente prima della compilazione degli AssetPack elementi.

Aggiunta in .NET 9

BeforeGenerateAndroidManifest

Le destinazioni MSBuild elencate in questa proprietà verranno eseguite direttamente prima di _GenerateJavaStubs.

Impostazione

Specifica la configurazione di compilazione da usare, ad esempio "Debug" o "Release". La proprietà Configuration viene usata per determinare i valori predefiniti per le altre proprietà che determinano il comportamento delle destinazioni. Configurazioni aggiuntive possono essere create nell'IDE.

Per impostazione predefinita, la Debug configurazione genererà Install e SignAndroidPackage è destinato a creare un pacchetto Android più piccolo che richiede la presenza di altri file e pacchetti per funzionare.

La configurazione predefinita Release comporterà la Install e SignAndroidPackage è destinato alla creazione di un pacchetto Android autonomo e può essere usato senza installare altri pacchetti o file.

DebugSymbols

Valore booleano che determina se il pacchetto Android è di cui è possibile eseguire il debug, in combinazione con la $(DebugType) proprietà . Un pacchetto di debug contiene simboli di debug, imposta l'attributo //application/@android:debuggable su truee aggiunge automaticamenteINTERNET autorizzazione in modo che un debugger possa connettersi al processo. Un'applicazione è debugbile se DebugSymbols è True e DebugType è la stringa vuota o Full.

DebugType

Specifica il tipo di simboli di debug da generare come parte della compilazione, che influisce anche sull'eventuale debug dell'applicazione. I valori possibili includono:

  • Full: vengono generati simboli completi. Se l'oggetto DebugSymbols La proprietà MSBuild è anche True, quindi il pacchetto dell'applicazione è debugabile.

  • PdbOnly: vengono generati simboli "PDB". Il pacchetto dell'applicazione non è possibile eseguire il debug.

Se DebugType non è impostato o è una stringa vuota, la proprietà DebugSymbols controlla se l'applicazione può essere sottoposta o meno a debug.

EmbedAssembliesIntoApk

Proprietà booleana che determina se gli assembly dell'app devono essere incorporati nel pacchetto dell'applicazione.

Questa proprietà deve essere True per le build di rilascio e False per le build di debug. Potrebbe dover essere True nelle build di debug se Fast Deployment non supporta il dispositivo di destinazione.

Quando questa proprietà è False, allora il $(AndroidFastDeploymentType) La proprietà MSBuild controlla anche cosa verrà incorporato in .apk, che può influire sui tempi di distribuzione e ricompilazione.

EnableLLVM

Proprietà booleana che determina se verrà utilizzata o meno LLVM durante la compilazione degli assembly in codice nativo.

Per compilare un progetto con questa proprietà abilitata, è necessario installare Android NDK.

Per impostazione predefinita, il valore della proprietà è False.

Questa proprietà viene ignorata a meno che la proprietà MSBuild $(AotAssemblies) non sia True.

EnableProguard

Proprietà booleana che determina se proguard viene eseguito come parte del processo di creazione del pacchetto per collegare il codice Java.

Per impostazione predefinita, il valore della proprietà è False.

Quando True, i file @(ProguardConfiguration) verranno usati per controllare proguard l'esecuzione.

GenerateApplicationManifest

Abilita o disabilita le proprietà MSBuild seguenti che generano valori nel file finale AndroidManifest.xml :

Il valore $(GenerateApplicationManifest) predefinito è true.

JavaMaximumHeapSize

Specifica il valore del valore del parametro Java-Xmx da usare durante la compilazione del .dex file come parte del processo di creazione dei pacchetti. Se il valore non è specificato, l'opzione -Xmx specifica per java il valore 1G. Questi valori sono richiesti più comunemente in Windows rispetto ad altre piattaforme.

Specificare questa proprietà è necessario se la _CompileDexdestinazione genera java.lang.OutOfMemoryError.

Personalizzare il valore modificando quanto segue:

<JavaMaximumHeapSize>1G</JavaMaximumHeapSize>

JavaOptions

Specifica le opzioni della riga di comando da passare a Java durante la compilazione del .dex file.

JarsignerTimestampAuthorityCertificateAlias

Questa proprietà consente di specificare un alias nell'archivio chiavi per un'autorità di timestamp. Per altri dettagli, vedere la documentazione relativa al supporto del timestamp della firma Java.

<PropertyGroup>
    <JarsignerTimestampAuthorityCertificateAlias>Alias</JarsignerTimestampAuthorityCertificateAlias>
</PropertyGroup>

JarsignerTimestampAuthorityUrl

Questa proprietà consente di specificare un URL per un servizio di autorità di timestamp. Può essere usato per assicurarsi che la .apk firma includa un timestamp. Per altri dettagli, vedere la documentazione relativa al supporto del timestamp della firma Java.

<PropertyGroup>
    <JarsignerTimestampAuthorityUrl>http://example.tsa.url</JarsignerTimestampAuthorityUrl>
</PropertyGroup>

LinkerDumpDependencies

Proprietà bool che consente la generazione di un file di dipendenze del linker. Questo file può essere usato come input per lo strumento illinkanalyzer.

Il file di dipendenze denominato linker-dependencies.xml.gz viene scritto nella directory del progetto. Su. NET5/6 viene scritto accanto agli assembly collegati nella obj/<Configuration>/android<ABI>/linked directory.

Il valore predefinito è Falso.

MandroidI18n

Questa proprietà MSBuild è obsoleta e non è più supportata.

MonoAndroidResourcePrefix

Specifica un prefisso di percorso rimosso dall'inizio dei nomi file con un'azione Di compilazione di AndroidResource. per poter modificare la posizione delle risorse.

Il valore predefinito è Resources. Impostarlo su res per la struttura del progetto Java.

MonoSymbolArchive

Proprietà booleana che controlla se .mSYM gli artefatti vengono creati per un uso successivo con mono-symbolicate, per estrarre le informazioni sul nome file e sul numero di riga reali dalle tracce dello stack di rilascio.

Questo è True per impostazione predefinita per le app "Release" con simboli di debug abilitati: $(EmbedAssembliesIntoApk) è True, $(DebugSymbols) è True e $(Optimize) è True.

RunAOTCompilation

Proprietà booleana che determina se gli assembly verranno compilati in anticipo nel codice nativo e inclusi nelle applicazioni. Questa proprietà è False per impostazione predefinita per Debug le compilazioni e True per impostazione predefinita per le Release compilazioni.

Questa proprietà MSBuild sostituisce la $(AotAssemblies) proprietà MSBuild da Xamarin.Android. Questa è la stessa proprietà usata per Blazor WASM.