Proprietà di compilazione

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.

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 aapt2 link durante l'elaborazione di asset e risorse Android.

AndroidAddKeepAlives

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

Il valore predefinito è True per le build di configurazione Release.

AndroidAotAdditionalArguments

Proprietà di tipo stringa che consente di passare le opzioni al compilatore Mono durante l'attività Aot per i progetti che hanno $(AndroidEnableProfiledAot) o $(AotAssemblies) impostati 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

Il file che aprofutil dovrebbe creare per contenere i dati del profiler.

AndroidAotProfiles

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

AndroidAotProfilerPort

La porta a cui connettere aprofutil per ottenere i dati di profilatura.

AndroidAotEnableLazyLoad

Abilitare il caricamento 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à di stringa che consente allo sviluppatore di fornire argomenti allo strumento apksigner.

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 System.Reflection.Emit ha un impatto notevole sulle prestazioni di avvio su 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 ottenere un servizio da un contenitore per l'iniezione delle dipendenze, viene generato del codice 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 di 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 è.

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

• System: il tipo di eccezione Java originale viene intercettato e avvolto 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 System.IO.IOException contenente un Java.IO.IOException come valore di Exception.InnerException.

  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.

InterfacceVincolateAndroidContenentiMetodiDiInterfacciaStaticiEDiDefault

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

Una proprietà di stringa che controlla la modalità di analisi dei file .jar. 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.

• JavaInterop1: valore sperimentale, attualmente il valore predefinito per il runtime NativeAOT.

Il valore predefinito è XAJavaInterop1.

AndroidCreatePackagePerAbi

Proprietà booleana che determina se è necessario creare un set di file, uno per ogni ABI specificato in $(AndroidSupportedAbis), anziché avere il supporto per tutti gli ABI in un singolo .apk.

Vedere anche la guida alla creazione di pacchetti APK specifici per 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 i file .apk, AndroidProguardMappingFile sarà necessario caricarli manualmente.

Il valore predefinito è True quando si utilizza $(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 * 36530 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

Una proprietà di tipo enum 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 .

AndroidAbilitaControlliGooglePlayStore

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 per l'avvio delle app che usa punti di ingresso nativi per la registrazione dei metodi Javanative.

Questa proprietà è False per impostazione predefinita.

Aggiunta in .NET 8.

AndroidEnableMultiDex

Proprietà booleana che determina se il supporto multi-dex verrà utilizzato o meno nel file finale .apk.

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

AndroidEnableProfiler

Sinonimo della $(EnableDiagnostics) proprietà .

Obbligatorio per l'uso dotnet-trace o dotnet-gcdump nelle applicazioni Android. Se impostato su true, include il componente di diagnostica Mono nell'applicazione. Questo componente è la libmono-component-diagnostics_tracing.so libreria nativa.

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.

Quando impostato 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 sovrascritto rimuovendo quelli 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.RestrictToJava 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 che hanno l'annotazione @RestrictTo o che si trovano in pacchetti Java non esportati, è possibile usare i File Transform oltre a questa proprietà per impedire che questi tipi siano vincolati:

<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 il collettore GC concorrente 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 il compito Aot per i progetti in cui $(AndroidEnableProfiledAot) o $(AotAssemblies) sono impostati 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 complete separate da spazi autonomi, come --verbose o --debug.

TipoDiDistribuzioneRapidaAndroid

Elenco : di valori delimitato da due punti per controllare quali tipi possono essere distribuiti alla directory di Fast Deployment sul 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. Più velocemente viene effettuata la distribuzione, meno frequentemente è necessario ricompilare .apk, e il processo di installazione può essere più rapido. I valori validi includono:

• Assemblies: distribuisce gli assembly dell'applicazione.
• Dexes: distribuisci .dex file, librerie native e tipimappe. 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 l'uso di API deprecate per funzionare.

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

Sperimentale.

AndroidFragmentType

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

AndroidGenerateJniMarshalMethods

Proprietà booleana che abilita la generazione dei metodi di marshalling JNI nell'ambito 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 utilizzare la nuova funzionalità di metodi 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.

AndroidGeneraMetodiDiMarshalingJniArgomentiAggiuntivi

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 layout code-behind se impostato su true, o la disabilita completamente se impostato 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 oppure 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 procedura guidata per la creazione di nuovi progetti seleziona questa opzione quando la Versione minima di Android è impostata su Android 4.4.87 o versioni precedenti in Visual Studio, oppure quando le Piattaforme di destinazione sono impostate su Sviluppo moderno o Compatibilità massima in Visual Studio per Mac.

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

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

AndroidIgnoreAllJniPreload

Valore booleano che, se impostato su true, esenta tutte le librerie JNI native dall'essere precaricate all'avvio dell'applicazione. Per impostazione predefinita, tutte queste librerie verranno caricate dal runtime all'inizio dell'avvio dell'applicazione per garantire la corretta inizializzazione. Tuttavia, in alcuni casi potrebbe non essere il comportamento desiderato e questa proprietà consente di disabilitarla in modo efficace.

Alcune librerie framework che devono essere caricate all'avvio dell'applicazione non saranno interessate da questa proprietà.

Vedi anche @(AndroidNativeLibraryNoJniPreload) per un metodo più dettagliato per esentare le librerie dal meccanismo di precaricamento.

AndroidIncludeWrapSh

Valore booleano che indica se lo script wrapper Android (wrap.sh) deve essere confezionato 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 hai un'unica wrap.sh per 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 i pacchetti di risorse che si compilano automaticamente vengono inclusi automaticamente nel file finale .aab. Sarà impostato su predefinito 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 dell'SDK di Java quando si esegue il <InstallAndroidDependencies/> target.

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:

• intellisense: genera solo i commenti XML: <exception/>, <param/>, <returns/>, <summary/>.
• full: emettere intellisense elementi, nonché <remarks/>, <seealso/> e qualsiasi altro elemento supportabile.

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

  Quando si utilizza un valore AndroidLinkMode di Full, spesso le app smettono di funzionare, soprattutto quando viene usata la Reflection. Evita a meno che tu non sia davvero certo di quello che stai facendo.

<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 come

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 riduttore di codice viene utilizzato per 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 packaging.

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

• $(AndroidLintEnabledIssues):
• $(AndroidLintDisabledIssues):
• $(AndroidLintCheckIssues):

È anche possibile usare le azioni di compilazione seguenti:

• @(AndroidLintConfig):

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

ProblemiAbilitatiInAndroidLint

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

Utilizzato solo quando $(AndroidLintEnabled)=True.

AndroidLintDisabledIssues

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

Utilizzato solo quando $(AndroidLintEnabled)=True.

AndroidLintCheckIssues

Una proprietà stringa che rappresenta un elenco di problemi di lint delimitato da virgole 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à assemblyName=$(AssemblyName) definisce 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 al com.android.multidex.MainDexListBuilder durante la generazione del file multidex.keep.

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 Android App Bundle. 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:

• $(AndroidUseAapt2) è True.
• $(AndroidUseApkSigner) è False.
• $(AndroidCreatePackagePerAbi) è False.

Questa proprietà verrà considerata obsoleta 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 desidera confezionare l'applicazione Android come file APK o Android App Bundle. 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 un aab che un apk per la distribuzione in vari archivi.

L'impostazione di AndroidPackageFormats a 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 per le compilazioni Release solo. È consigliabile continuare a usare solo apk per il debug.

AndroidPackageNamingPolicy

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

L'unico valore supportato è LowercaseCrc64.

PreparazioneAndroidPerLaBuildDipendeDa

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 False per applicare un comportamento più rigoroso. Per informazioni dettagliate, vedere il codice sorgente D8 e R8.

Aggiunta in .NET 8.

AndroidR8IgnoreWarnings

Specifica la 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 False per imporre 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 relativo all'installazione del workload .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 build .NET per Android fornisce un valore predefinito in Xamarin.Android.Common.targets, e il valore predefinito può essere sottoposto a override all'interno del file di progetto per scegliere una versione alternativa degli strumenti di build, se (ad esempio) la versione più recente di aapt si blocca mentre è noto che una versione di aapt precedente funziona correttamente.

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 anche i prefissi env: 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>

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 anche i prefissi env: 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>

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 dei metodi compilati da AOT verranno rimossi.

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

Quando è impostato a true, $(AndroidEnableProfiledAot) è impostato su false per 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 sperimentale per questa proprietà è stato aggiunto in .NET 8, rimosso in .NET 10.

AndroidStripNativeLibraries

Proprietà booleana che indica al processo di creazione del pacchetto di rimuovere i simboli di debug dai file delle librerie condivise native (.so).

Il valore predefinito è false e i simboli di debug, se presenti, verranno mantenuti durante la creazione del pacchetto.

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

Si tratta di una proprietà Xamarin.Android che non ha alcun effetto in .NET per Android. aapt2 viene sempre usato e non può essere disabilitato.

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à booleana che controlla se il sistema di compilazione genererà un _Microsoft.Android.Resource.Designer.dll anziché 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 siano state deprecate 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 il .apk contenga il mono interprete e non il normale JIT.

Sperimentale.

UtilizzoVecchioCodiceVersioneAndroid

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 a /manifest/@android:versionCode nel file AndroidManifest.xml. Per acconsentire a questa funzionalità, è necessario abilitare anche <GenerateApplicationManifest>true</GenerateApplicationManifest>. 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 ulteriori dettagli sui requisiti per /manifest/@android:versionCode, consultare la documentazione Android.

AndroidVersionCodePattern

Proprietà stringa che consente allo sviluppatore di personalizzare il versionCode nel manifesto. Per informazioni su come creare il Codice di Versione per l'APK e aiutarvi a decidere su versionCode, vedere .

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.

Includendo una stringa di formato con riempimento a sinistra {abi}{versionCode:0000}, questo produce 50044 poiché stiamo riempiendo a sinistra versionCode 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) Sono nella forma di una 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 a /manifest/@package nel file AndroidManifest.xml. Per acconsentire a questa funzionalità, è necessario abilitare anche <GenerateApplicationManifest>true</GenerateApplicationManifest>. Questa sarà l'impostazione predefinita in futuro in .NET 6.

Per ulteriori dettagli sui requisiti per /manifest/@package, consultare la documentazione Android.

TitoloApplicazione

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

Per ulteriori dettagli sui requisiti per /manifest/application/@android:label, consultare la documentazione Android.

VersioneApplicazione

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

Per ulteriori dettagli sui requisiti per /manifest/@android:versionName, consultare la documentazione Android.

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 (non più supportato) in .NET 7. Migra alla proprietà MSBuild $(RunAOTCompilation) nuova, poiché il supporto per $(AotAssemblies) verrà rimosso in una versione futura.

AProfUtilExtraOptions

Opzioni aggiuntive da passare a aprofutil.

BeforeBuildAndroidAssetPacks

Le Target di MSBuild elencate in questa proprietà verranno eseguite immediatamente prima della compilazione degli AssetPack elementi.

Aggiunta in .NET 9

BeforeGenerateAndroidManifest

I target MSBuild elencati in questa proprietà saranno eseguiti immediatamente 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 è debuggabile, in combinazione con la proprietà $(DebugType). Un pacchetto di debug contiene simboli di debug, imposta l'attributo //application/@android:debuggable su truee aggiunge automaticamente INTERNET autorizzazione in modo che un debugger possa connettersi al processo. Un'applicazione è debugbile se DebugSymbols è TrueeDebugType è 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 è sottoponibile a debug.

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

Dispositivo

Specifica il dispositivo o l'emulatore Android di destinazione quando si usano dotnet run --device <Device> o destinazioni MSBuild che interagiscono con i dispositivi ( ad esempio Run, Installo Uninstall).

Il valore deve essere il numero di serie completo del dispositivo o l'identificatore restituito da adb devices. Ad esempio, se il dispositivo seriale è emulator-5554, è necessario usare -p:Device=emulator-5554.

Se impostata, questa proprietà viene utilizzata per inizializzare la AdbTarget proprietà con il valore -s "<Device>".

Per altre informazioni sulla selezione dei dispositivi, vedere la specifica di selezione dei dispositivi .NET SDK.

Indirizzo Diagnostico

Valore fornito da dotnet-dsrouter , ad esempio 127.0.0.1, il componente dell'indirizzo IP di $(DiagnosticConfiguration) o $DOTNET_DiagnosticPorts.

Abilita in modo implicito il componente di diagnostica Mono, ovvero $(EnableDiagnostics)/$(AndroidEnableProfiler) è impostato su .true

Il valore predefinito è 127.0.0.1.

Configurazione diagnostica

Valore fornito da dotnet-dsrouter per $DOTNET_DiagnosticPorts , ad esempio:

• 127.0.0.1:9000,suspend,connect
• 127.0.0.1:9000,nosuspend,connect

Si noti che il , carattere deve essere preceduto da un carattere di escape con %2c se passato nella riga di comando a dotnet build:

dotnet build -c Release -p:DiagnosticConfiguration=127.0.0.1:9000%2csuspend%2cconnect

Verrà impostata automaticamente la $DOTNET_DiagnosticPorts variabile di ambiente in pacchetto all'interno dell'applicazione.

Abilita in modo implicito il componente di diagnostica Mono, ovvero $(EnableDiagnostics)/$(AndroidEnableProfiler) è impostato su .true

DiagnosticListenMode

Valore fornito da dotnet-dsrouter , ad esempio connect, il componente della modalità di ascolto di $(DiagnosticConfiguration) o $DOTNET_DiagnosticPorts.

Abilita in modo implicito il componente di diagnostica Mono, ovvero $(EnableDiagnostics)/$(AndroidEnableProfiler) è impostato su .true

Il valore predefinito è connect.

DiagnosticPort

Valore fornito da dotnet-dsrouter , ad esempio 9000, il componente della porta di $(DiagnosticConfiguration) o $DOTNET_DiagnosticPorts.

Abilita in modo implicito il componente di diagnostica Mono, ovvero $(EnableDiagnostics)/$(AndroidEnableProfiler) è impostato su .true

Il valore predefinito è 9000.

DiagnosticSuspend

Valore booleano fornito da dotnet-dsrouter , ad esempio true/suspend o false/nosuspend, un componente di $(DiagnosticConfiguration) o $DOTNET_DiagnosticPorts.

Abilita in modo implicito il componente di diagnostica Mono, ovvero $(EnableDiagnostics)/$(AndroidEnableProfiler) è impostato su .true

Il valore predefinito è false.

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.

AbilitaDiagnostica

Sinonimo della $(AndroidEnableProfiler) proprietà .

Obbligatorio per l'uso dotnet-trace o dotnet-gcdump nelle applicazioni Android. Se impostato su true, include il componente di diagnostica Mono nell'applicazione. Questo componente è la libmono-component-diagnostics_tracing.so libreria nativa.

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

AbilitaLLVM

Proprietà booleana che determina se verrà utilizzato o meno LLVM durante la compilazione ahead-of-time 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.

EventSourceSupport

Se impostato su false, disabilita il supporto di EventSource di .NET dalle applicazioni Android ridotte. La disabilitazione di questa funzionalità impedisce il funzionamento degli strumenti dotnet-counters di diagnostica .NET, ma a vantaggio di una riduzione delle dimensioni dell'applicazione.

Impostare su false per impostazione predefinita nella modalità Release, a meno che $(EnableDiagnostics) o $(AndroidEnableProfiler) siano abilitati.

ManifestoApplicazioneGenera

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

• $(AndroidVersionCode)
• $(ApplicationId)
• $(ApplicationTitle)
• $(ApplicationVersion)

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.

È necessario specificare questa proprietà se la _CompileDex destinazione 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 marcatura temporale. Può essere usato per assicurarsi che la .apk firma includa un timestamp. Per altri dettagli, vedere la documentazione relativa al supporto per la firma con timestamp di Java.

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

LinkerDumpDependencies

Una proprietà boolean che abilita 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.

MetricheSupporto

Quando impostato su false, disabilita il supporto di .NET alle Metriche per le applicazioni Android ridotte. La disabilitazione di questa funzionalità impedisce il funzionamento delle API System.Diagnostics.Metrics , ma a vantaggio di una riduzione delle dimensioni dell'applicazione.

Impostare su false per impostazione predefinita nella modalità Release, a meno che $(EnableDiagnostics) o $(AndroidEnableProfiler) non siano abilitati.

MonoAndroidAssetPrefix

Specifica un prefisso del percorso che viene rimosso dall'inizio dei nomi file con un'azione di compilazione di AndroidAsset. per poter modificare la posizione delle risorse.

Il valore predefinito è Assets. Impostarlo su assets per la struttura del progetto Java.

MonoAndroidResourcePrefix

Specifica un prefisso del 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 vengono creati gli artefatti 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 Release.

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

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 nelle compilazioni Debug e True in quelle Release.

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

WaitForExit

Proprietà booleana che controlla il comportamento di dotnet run quando si avviano applicazioni Android.

Se $(WaitForExit) non false è (impostazione predefinita), dotnet run eseguirà le seguenti attività:

• Avviare l'applicazione Android
• Output logcat del flusso filtrato per il processo dell'applicazione
• Attendere che l'applicazione si chiuda o che l'utente prema Ctrl+C
• Forzare l'interruzione dell'applicazione quando si preme Ctrl+C

Quando $(WaitForExit) è false, dotnet run avvierà semplicemente l'applicazione usando adb shell am start e restituirà immediatamente senza attendere che l'applicazione esca o trasmettendo alcun output.

Introdotto in .NET 11.