Build-Eigenschaften

MSBuild-Eigenschaften steuern das Verhalten der Ziele.

Sie werden in der Projektdatei angegeben, z . B. "MyApp.csproj", innerhalb einer MSBuild PropertyGroup.

AdbTarget

Die $(AdbTarget)-Eigenschaft gibt das Android-Zielgerät an, auf dem das Android-Paket installiert oder entfernt werden soll. Der Wert dieser Eigenschaft ist identisch mit der Zielgerätoption adb.

AfterGenerateAndroidManifest

Die in dieser Eigenschaft aufgelisteten MSBuild-Ziele werden direkt nach dem internen _GenerateJavaStubs-Ziel ausgeführt. Dabei wird die Datei AndroidManifest.xml im $(IntermediateOutputPath) generiert. Wenn Sie Änderungen an der generierten Datei AndroidManifest.xml vornehmen möchten, können Sie dies über diesen Erweiterungspunkt tun.

AndroidAapt2CompileExtraArgs

Gibt Befehlszeilenoptionen an, die beim Verarbeiten von Android-Bestandteilen und -Ressourcen an den aapt2 compile-Befehl übergeben werden sollen.

AndroidAapt2LinkExtraArgs

Gibt Befehlszeilenoptionen an, die beim Verarbeiten von Android-Assets und -Ressourcen an den aapt2 Link-Befehl übergeben werden sollen.

AndroidAddKeepAlives

Es handelt sich um eine boolesche Eigenschaft, die steuert, ob der Linker GC.KeepAlive()-Aufrufe in Bindungsprojekte einfügt, um einer vorzeitigen Sammlung von Objekten vorzubeugen.

Der Standardwert ist True für Release-Konfigurations-Builds.

AndroidAotAdditionalArguments

Eine Zeichenfolgeneigenschaft, die das Übergeben von Optionen an den Mono-Compiler während des Aot-Tasks für Projekte ermöglicht, bei denen entweder $(AndroidEnableProfiledAot) gesetzt ist oder $(AotAssemblies) auf true festgelegt ist. Der Zeichenfolgenwert der Eigenschaft wird zur Response-Datei hinzugefügt, wenn der Mono-Cross-Compiler aufgerufen wird.

Diese Eigenschaft sollte im Allgemeinen leer bleiben, bietet aber in bestimmten speziellen Szenarios möglicherweise eine nützliche Flexibilität.

Die $(AndroidAotAdditionalArguments) Eigenschaft unterscheidet sich von der zugehörigen $(AndroidExtraAotOptions) Eigenschaft. $(AndroidAotAdditionalArguments) Übergibt vollständige eigenständige, durch Leerzeichen getrennte Optionen wie --verbose oder --debug an den AOT-Compiler, enthält jedoch $(AndroidExtraAotOptions) kommagetrennte Argumente, die Teil der --aot Option des AOT-Compilers sind.

AndroidAotCustomProfilePath

Die Datei, die von aprofutil erstellt werden soll, um Profilerdaten zu speichern.

AndroidAotProfiles

Eine Zeichenfolgeneigenschaft, die es Entwicklern ermöglicht, AOT-Profile über die Befehlszeile hinzuzufügen. Es ist eine durch Semikolons oder kommagetrennte Liste absoluter Pfade.

AndroidAotProfilerPort

Der Port, über den aprofutil beim Abrufen von Profilerstellungsdaten eine Verbindung herstellen soll.

AndroidAotEnableLazyLoad

Aktivieren Sie das faule (verzögerte) Laden von AOT-d-Assemblys, anstatt sie beim Start vorab zu laden. Der Standardwert ist True für Release-Builds mit jeder Form von AOT aktiviert.

In .NET 6 eingeführt.

AndroidApkDigestAlgorithm

Ein Zeichenfolgenwert, der den für jarsigner -digestalg zu verwendenden Digestalgorithmus angibt.

Der Standardwert ist SHA-256.

AndroidApkSignerZusätzlicheArgumente

Eine Eigenschaftenzeichenfolge, die dem Entwickler ermöglicht, Argumente für das apksigner-Tool bereitzustellen.

AndroidApkSigningAlgorithm

Ein Zeichenfolgenwert, der den zu verwendenden jarsigner -sigalg Signierungsalgorithmus angibt.

Der Standardwert ist SHA256withRSA.

AndroidApplication

Ein boolescher Wert, der angibt, ob das Projekt für eine Android-Anwendung (True) oder für ein Android-Bibliotheksprojekt (False oder nicht vorhanden) vorgesehen ist.

Es darf nur ein Projekt mit <AndroidApplication>True</AndroidApplication> in einem Android-Paket vorhanden sein. (Leider wird diese Anforderung nicht überprüft, was zu subtilen und bizarren Fehlern in Bezug auf Android-Ressourcen führen kann.)

AndroidApplicationJavaClass

Der vollständige Java-Klassenname, der anstelle von android.app.Application verwendet werden soll, wenn eine Klasse von Android.App.Application erbt.

Die $(AndroidApplicationJavaClass) Eigenschaft wird in der Regel durch andere Eigenschaften festgelegt, z. B. die $(AndroidEnableMultiDex) MSBuild-Eigenschaft.

AndroidAvoidEmitForPerformance

Eine boolesche Eigenschaft, die bestimmt, ob System.Reflection.Emit "vermieden" wird, um die Startleistung zu verbessern. Standardmäßig ist diese Eigenschaft True.

Die Nutzung von System.Reflection.Emit hat eine spürbare Auswirkung auf die Startleistung auf Android. Dieses Verhalten ist für die folgenden Featureoptionen standardmäßig deaktiviert:

• Switch.System.Reflection.ForceInterpretedInvoke: nach dem zweiten Aufruf von MethodInfo.Invoke() oder ConstructorInfo.Invoke() wird Code generiert, um die Leistung wiederholter Aufrufe zu verbessern.

• Microsoft.Extensions.DependencyInjection.DisableDynamicEngine: Nach dem zweiten Aufruf zum Abrufen eines Diensts aus einem Abhängigkeitseinfügungscontainer wird Code ausgegeben, um die Leistung wiederholter Aufrufe zu verbessern.

Es ist in den meisten Android-Anwendungen wünschenswert, dieses Verhalten zu deaktivieren.

Ausführliche Informationen zu verfügbaren Feature-Schaltern finden Sie in der Dokumentation zu den Feature-Schaltern der Basis-Klassenbibliotheken.

In .NET 8 hinzugefügt.

AndroidBinUtilsPath

Ein Pfad zu einem Verzeichnis, das die binutils von Android enthält, z. B. den nativen Linker ld und den nativen Assembler as. Diese Tools sind in .NET für Android-Workload enthalten.

Der Standardwert ist $(MonoAndroidBinDirectory)\binutils\bin\.

AndroidBoundExceptionType

Ein Zeichenfolgenwert, der angibt, wie Ausnahmen weitergegeben werden sollen, wenn ein .NET für Android bereitgestellter Typ einen .NET-Typ oder eine Schnittstelle im Kontext von Java-Typen implementiert, zum Beispiel Android.Runtime.InputStreamInvoker und System.IO.Stream, oder Android.Runtime.JavaDictionary und System.Collections.IDictionary.

• Java: Der ursprüngliche Java-Ausnahmetyp wird wie folgt verteilt.

  Java bedeutet, dass InputStreamInvoker beispielsweise die System.IO.Stream-API nicht ordnungsgemäß implementiert, da Java.IO.IOException aus Stream.Read() anstelle von System.IO.IOException ausgelöst werden kann.

• System: Der ursprüngliche Java-Ausnahmetyp wird abgefangen und in einen entsprechenden .NET-Ausnahmetyp eingeschlossen.

  System bedeutet, dass beispielsweise InputStreamInvoker ordnungsgemäß System.IO.Stream implementiert wird und Stream.Read() keine Java.IO.IOException-Instanzen werfen wirdnicht. (Es kann stattdessen ein System.IO.IOException, das ein Java.IO.IOException enthält, als Exception.InnerException-Wert werfen.)

  Der Standardwert lautet System.

Android-gebundene Schnittstellen enthalten Konstanten

Eine boolesche Eigenschaft, die festlegt, ob Bindungskonstanten für Schnittstellen unterstützt werden oder ob alternativ die Problemumgehung des Erstellens einer IMyInterfaceConsts Klasse verwendet wird.

Der Standardwert ist True.

Android-gebundene Schnittstellen enthalten statische und Standard-Schnittstellenmethoden

Eine boolesche Eigenschaft, die angibt, ob Standard- und statische Member auf Schnittstellen unterstützt werden, oder eine alte Problemumgehung zum Erstellen einer gleichgeordneten Klasse mit statischen Elementen wie abstract class MyInterface.

Der Standardwert ist True in .NET 6 und False für legacy.

AndroidGebundeneSchnittstellenEnthaltenTypen

Eine boolesche Eigenschaft, die bestimmt, ob Typen, die in Schnittstellen geschachtelt sind, unterstützt werden oder die Problemumgehung zum Erstellen eines nicht geschachtelten Typs wie IMyInterfaceMyNestedClass.

Der Standardwert ist True in .NET 6 und False für legacy.

Android-Build-Anwendungspaket

Ein boolescher Wert, der angibt, ob das Paket erstellt und signiert werden soll (APK-Datei). Das Einstellen dieses Werts auf True ist gleichbedeutend mit der Verwendung von SignAndroidPackage Buildziel.

Standardmäßig ist diese Eigenschaft False.

Android-Bundle-Konfigurationsdatei

Gibt einen Dateinamen an, der als Konfigurationsdatei für bundletool verwendet werden soll, wenn ein Android App Bundle erstellt wird. Diese Datei steuert einige Aspekte für die Generierung von APKs aus dem Bundle, z. B. in welche Dimensionen das Bundle aufgeteilt wird, um APKs zu erzeugen. .NET für Android konfiguriert einige dieser Einstellungen automatisch, einschließlich der Liste der Dateierweiterungen, die nicht komprimiert werden sollen.

Diese Eigenschaft ist nur relevant, wenn $(AndroidPackageFormat) auf aab festgelegt ist.

AndroidBundleToolExtraArgs

Gibt Befehlszeilenoptionen an, die beim Erstellen von App-Bündeln an den Bundletool-Befehl übergeben werden sollen.

AndroidClassParser

Eine Zeichenfolgeneigenschaft, die steuert, wie .jar Dateien analysiert werden. Mögliche Werte sind:

• class-parse: Verwendet class-parse.exe, um Java-Bytecode direkt (ohne Unterstützung durch eine JVM) zu analysieren.

• jar2xml: Dieser Wert ist veraltet und wird nicht mehr unterstützt.

AndroidCodegenTarget

Eine Zeichenfolgeneigenschaft, die das ABI-Ziel der Codegenerierung steuert. Mögliche Werte sind:

• XamarinAndroid: Dieser Wert ist veraltet und wird nicht mehr unterstützt.

• XAJavaInterop1: Verwendet Java.Interop für JNI-Aufrufe. Bindungsassemblys, die XAJavaInterop1 verwenden, können nur mit Xamarin.Android 6.1 oder höher erstellt und ausgeführt werden. Xamarin.Android 6.1 oder höher bindet Mono.Android.dll mit diesem Wert.

• JavaInterop1: experimenteller Wert, derzeit der Standardwert für die NativeAOT-Laufzeit.

Der Standardwert ist XAJavaInterop1.

AndroidCreatePackagePerAbi

Eine boolesche Eigenschaft, die bestimmt, ob ein Satz von Dateien erstellt werden soll – je eine Datei pro in $(AndroidSupportedAbis) angegebenem ABI –, anstatt Unterstützung für alle ABIs in einem einzigen .apk.

Weitere Informationen finden Sie auch im Leitfaden zum Erstellen von ABI-spezifischen APKs.

AndroidErstelleProguardMappingDatei

Eine boolesche Eigenschaft, die steuert, ob eine Proguard-Zuordnungsdatei als Teil des Buildprozesses generiert wird.

Wenn Sie Folgendes zu Ihrem csproj hinzufügen, wird die Datei generiert, und die AndroidProguardMappingFile Eigenschaft wird verwendet, um den Speicherort der endgültigen Zuordnungsdatei zu steuern.

<AndroidCreateProguardMappingFile>True</AndroidCreateProguardMappingFile>

Beim Erstellen von .aab Dateien wird die Zuordnungsdatei automatisch in Ihr Paket eingeschlossen. Es ist nicht erforderlich, es manuell in den Google Play Store hochzuladen. Bei der Verwendung von .apk Dateien muss die AndroidProguardMappingFile Datei manuell hochgeladen werden.

Der Standardwert ist True bei Verwendung von $(AndroidLinkTool)=r8.

AndroidDebugKeyAlgorithm

Gibt den Standardalgorithmus an, der für das debug.keystore verwendet werden soll. Der Standardwert ist RSA.

Gültigkeit des Android-Debug-Schlüssels

Gibt den Standardwert für die Gültigkeit für das debug.keystore an. Der Standardwert ist 10950 oder 30 * 365 oder 30 years.

AndroidDebugStoreType

Gibt das Dateiformat für den Schlüsselspeicher an, das für debug.keystore verwendet werden soll. Der Standardwert ist pkcs12.

AndroidDeviceUserId

Diese Eigenschaft ermöglicht das Bereitstellen und Debuggen der Anwendung mit Gast- oder Geschäftskonten. Der Wert ist der uid-Wert, den Sie über den folgenden adb-Befehl erhalten:

adb shell pm list users

Der obige Befehl gibt die folgenden Daten zurück:

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

Der uid-Wert ist der erste ganzzahlige Wert. In der obigen Ausgabe sind 0 und 10.

AndroidDexTool

Eine Enum-artige Eigenschaft mit einem gültigen Wert von d8. Zuvor wurde ein Wert von dx in Xamarin.Android unterstützt.

Gibt an, welcher Android dex Compiler während des .NET für Android-Buildprozesses verwendet wird. Der Standardwert ist d8. Lesen Sie unsere Dokumentation zu D8 und R8.

AndroidEnableDesugar

Eine boolesche Eigenschaft, die bestimmt, ob desugar aktiviert ist. Android unterstützt derzeit nicht alle Funktionen von Java 8, und die Standardtoolkette implementiert die neuen Sprachfeatures durch Durchführung von Bytecode-Transformationen, die "desugar" genannt werden, auf den Ausgaben des "javac" Compilers. Der Standardwert ist False bei Verwendung $(AndroidDexTool)=dx und True bei Verwendung von $(AndroidDexTool)=d8.

AndroidAktiviereGooglePlayStoreÜberprüfungen

Eine bool-Eigenschaft, mit der Entwickler die folgenden Google Play Store-Prüfungen deaktivieren können: XA1004, XA1005 und XA1006. Das Deaktivieren dieser Prüfungen ist für Entwickler nützlich, die nicht auf den Google Play Store abzielen und diese Prüfungen nicht ausführen möchten.

AndroidEnableMarshalMethods

Eine bool-Eigenschaft, die bestimmt, ob LLVM-Marshallmethoden aktiviert sind. LLVM Marshal-Methoden sind eine App-Startoptimierung, die systemeigene Einstiegspunkte für die Registrierung von Java-Methoden native verwendet.

Diese Eigenschaft ist standardmäßig false.

In .NET 8 hinzugefügt.

AndroidEnableMultiDex

Eine boolesche Eigenschaft, die bestimmt, ob Multi-Dex-Unterstützung in der endgültigen .apk-Datei verwendet wird.

Standardmäßig ist diese Eigenschaft False.

AndroidEnableProfiler

Synonym für die $(EnableDiagnostics) Eigenschaft.

Erforderlich für die Verwendung dotnet-trace oder dotnet-gcdump in Android-Anwendungen. Bei Festlegung auf true, enthält sie die Mono-Diagnosekomponente in der Anwendung. Diese Komponente ist die libmono-component-diagnostics_tracing.so systemeigene Bibliothek.

Standardmäßig ist diese Eigenschaft False.

AndroidEnableObsoleteOverrideInheritance

Eine boolesche Eigenschaft, die bestimmt, ob gebundene Methoden [Obsolete] Attribute automatisch von Methoden erben, die sie überschreiben.

Unterstützung für diese Eigenschaft wurde in .NET 8 hinzugefügt.

Standardmäßig ist diese Eigenschaft True.

AndroidEnablePreloadAssemblies

Eine boolesche Eigenschaft, die steuert, ob alle verwalteten Assemblys, die im Anwendungspaket gebündelt sind, während des Prozessstarts geladen werden oder nicht.

Bei Festlegung auf True werden alle im Anwendungspaket gebündelten Assemblys während des Prozessstarts geladen, bevor Anwendungscode aufgerufen wird.

Bei Festlegung auf False werden Assemblys nur bei Bedarf geladen. Das Laden von Assemblys nach Bedarf ermöglicht es Anwendungen, schneller zu starten und ist auch mit der Desktop-.NET-Semantik konsistent. Um die Zeitersparnis anzuzeigen, legen Sie die Systemeigenschaft debug.mono.log so fest, dass sie timing einschließt, und suchen Sie nach der Meldung Finished loading assemblies: preloaded in adb logcat.

Anwendungen oder Bibliotheken, die Abhängigkeitseinfügung verwenden, erfordern möglicherweise, dass diese Eigenschaft sein True muss, wenn sie wiederum erfordern, dass AppDomain.CurrentDomain.GetAssemblies() alle Assemblys innerhalb des Anwendungsbundles zurückgegeben werden, auch wenn die Assembly sonst nicht erforderlich wäre.

Dieser Wert ist standardmäßig "False".

AndroidEnableProfiledAot

Eine boolesche Eigenschaft, die bestimmt, ob während der Vorabkompilierung AOT-Profile verwendet werden.

Die Profile sind in der Elementgruppe aufgelistet. @(AndroidAotProfile) Elementgruppe. Diese Elementgruppe enthält Standardprofile. Sie können diese überschreiben, indem Sie die vorhandenen Profile entfernen und dann Ihre eigenen AOT-Profile hinzufügen.

Standardmäßig ist diese Eigenschaft False.

AndroidEnableRestrictToAttributes

Eine Enum-Eigenschaft mit gültigen Werten von obsolete und disable.

Bei Festlegung auf obsolete, werden Typen und Member, die mit der Java-Anmerkung androidx.annotation.RestrictTogekennzeichnet sind oder sich in nicht exportierten Java-Paketen befinden, mit einem [Obsolete] Attribut in der C#-Bindung gekennzeichnet.

Dieses [Obsolete] Attribut enthält eine beschreibende Meldung, in der erläutert wird, dass der Java-Paketbesitzer die API als "intern" betrachtet und warnt gegen die Verwendung.

Dieses Attribut verfügt auch über einen benutzerdefinierten Warnungscode XAOBS001 , sodass es unabhängig von der "normalen" veralteten API unterdrückt werden kann.

Bei Festlegung auf disable" wird die API ohne zusätzliche Attribute als normal generiert. (Dies ist das gleiche Verhalten wie vor .NET 8.)

Das Hinzufügen von [Obsolete] Attributen anstelle der automatischen Entfernung der API wurde durchgeführt, um die API-Kompatibilität mit vorhandenen Paketen beizubehalten. Wenn Sie stattdessen Elemente entfernen möchten, die über die @RestrictTo Anmerkung verfügen oder sich in nicht exportierten Java-Paketen befinden, können Sie zusätzlich zu dieser Eigenschaft Transform-Dateien verwenden, um zu verhindern, dass diese Typen gebunden werden:

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

Unterstützung für diese Eigenschaft wurde in .NET 8 hinzugefügt.

Diese Eigenschaft ist auf obsolete standardmäßig festgelegt.

AndroidEnableSGenConcurrent

Eine Boolesche Eigenschaft, die bestimmt, ob der konkurrierende Garbage Collector von Mono verwendet wird.

Standardmäßig ist diese Eigenschaft False.

AndroidErrorOnCustomJavaObject

Eine boolesche Eigenschaft, die bestimmt, ob Typen Android.Runtime.IJavaObjectohne gleichzeitiges Erben von Java.Lang.Object oder Java.Lang.Throwable implementieren können:

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

    public void Dispose()
    {
    }
}

Wenn diese Eigenschaft TRUE ist, generieren solche Typen einen XA4212-Fehler. Andernfalls wird eine XA4212-Warnung generiert.

Standardmäßig ist diese Eigenschaft True.

AndroidExplicitCrunch

Diese Eigenschaft wird nicht mehr unterstützt.

AndroidExtraAotOptions

Eine Zeichenfolgeneigenschaft, die das Übergeben von Optionen an den Mono-Compiler während der Aot Aufgabe für Projekte ermöglicht, die entweder $(AndroidEnableProfiledAot) oder $(AotAssemblies) auf true festgelegt haben. Der Zeichenfolgenwert der Eigenschaft wird zur Antwortdatei hinzugefügt, wenn der Mono-Cross-Compiler aufgerufen wird.

Diese Eigenschaft sollte im Allgemeinen leer bleiben, bietet aber in bestimmten speziellen Szenarios möglicherweise eine nützliche Flexibilität.

Die $(AndroidExtraAotOptions) Eigenschaft unterscheidet sich von der verwandten $(AndroidAotAdditionalArguments) Eigenschaft; $(AndroidAotAdditionalArguments) platziert kommagetrennte Argumente in die --aot Option des Mono-Compilers. $(AndroidExtraAotOptions) übergibt stattdessen vollkommen eigenständige, durch Leerzeichen getrennte Optionen wie --verbose oder --debug an den Compiler.

Android-Schnellbereitstellungstyp

Eine durch Doppelpunkte (:) getrennte Liste von Werten zum Steuern, welche Typen im Verzeichnis für schnelle Bereitstellung auf dem Zielgerät bereitgestellt werden können, wenn die MSBuild-Eigenschaft $(EmbedAssembliesIntoApk) den Wert False aufweist. Wenn eine Ressource schnell bereitgestellt wird, ist sie nicht in die generierte .apk-Datei eingebettet, was die Bereitstellungszeiten beschleunigen kann. (Je schneller bereitgestellt wird, desto seltener müssen die .apk neu aufgebaut werden, und der Installationsprozess kann schneller sein.) Gültige Werte sind:

• Assemblies: Anwendungsassemblies bereitstellen.
• Dexes: Bereitstellen von .dex-Dateien, nativen Bibliotheken und Typzuordnungen. Der Dexes Wert kann nur auf Geräten mit Android 4.4 oder höher (API-19) verwendet werden.

Der Standardwert ist Assemblies.

Die Unterstützung für Ressourcen und Objekte mit schneller Bereitstellung über dieses System wurde in Commit f0d565fe entfernt. Der Grund hierfür war, dass die Nutzung veralteter APIs erforderlich war, um die Funktionalität zu gewährleisten.

**Unterstützung für dieses Feature wurde in .NET 9 entfernt.

Experimentell.

AndroidFragmentType

Gibt den standardmäßig vollqualifizierten Typ an, der für alle <fragment>-Layoutelemente bei der Generierung des Layoutbindungscodes verwendet wird. Der Standardwert ist der Standardmäßige Android-Typ Android.App.Fragment .

AndroidGenerateJniMarshalMethods

Eine boolesche Eigenschaft, die das Generieren von JNI-Marshallmethoden im Rahmen des Buildprozesses ermöglicht. Dies reduziert die Verwendung von System.Reflection im Hilfscode für die Bindung erheblich.

Der Standardwert ist False. Wenn Entwickler die neue Funktion der JNI-Marshal-Methoden verwenden möchten, können sie festlegen.

<AndroidGenerateJniMarshalMethods>True</AndroidGenerateJniMarshalMethods>

in ihrer .csproj-Datei festlegen. Alternativ können Sie die Eigenschaft auch auf der Befehlszeile angeben über

-p:AndroidGenerateJniMarshalMethods=True

Experimentell. Der Standardwert ist False.

AndroidGenerateJniMarshalMethodsAdditionalArguments

Eine Zeichenfolgeneigenschaft, die verwendet werden kann, um Parameter zum jnimarshalmethod-gen.exe-Aufruf hinzuzufügen und die für das Debuggen nützlich ist, sodass Optionen wie -v, -d oder --keeptemp verwendet werden können.

Der Standardwert ist eine leere Zeichenfolge. Er kann in der .csproj-Datei oder an der Befehlszeile festgelegt werden. Zum Beispiel:

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

oder:

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

AndroidGenerateLayoutBindings

Ermöglicht die Generierung von Layout-Code-Behind, wenn auf true gesetzt, oder deaktiviert sie vollständig, wenn auf false gesetzt.

Der Standardwert ist false.

AndroidGenerateResourceDesigner

Der Standardwert ist true. Bei Festlegung auf false, deaktiviert die Generierung von Resource.designer.cs.

AndroidHttpClientHandlerType

Steuert die Standardimplementierung von System.Net.Http.HttpMessageHandler, die vom System.Net.Http.HttpClient-Standardkonstruktor verwendet wird. Der Wert ist ein assembly-qualifizierter Typname einer HttpMessageHandler-Unterklasse und eignet sich für die Verwendung mit System.Type.GetType(string).

In .NET 6 und höher hat diese Eigenschaft nur Auswirkungen, wenn sie zusammen mit $(UseNativeHttpHandler)=true. Für diese Eigenschaft werden am häufigsten die folgenden Werte zurückgegeben:

• Xamarin.Android.Net.AndroidMessageHandler: Verwenden Sie die Android-Java-APIs, um HTTP-Anforderungen auszuführen. Es ähnelt der Legacyversion Xamarin.Android.Net.AndroidClientHandler mit mehreren Verbesserungen. Es unterstützt HTTP 1.1 und TLS 1.2. Dies ist der standardmäßige HTTP-Nachrichtenhandler.

• System.Net.Http.SocketsHttpHandler, System.Net.Http: Der Standardnachrichtenhandler in .NET. Er unterstützt HTTP/2, TLS 1.2 und ist der empfohlene HTTP-Nachrichtenhandler für die Verwendung mit Grpc.Net.Client. Dieser Wert entspricht $(UseNativeHttpHandler)=false.

• Nicht festgelegt/die leere Zeichenfolge, die entspricht System.Net.Http.HttpClientHandler, System.Net.Http

  Entspricht der Standardoption auf den Visual Studio-Eigenschaftenseiten.

  Der Assistent für neue Projekte wählt diese Option für neue Projekte aus, wenn die Niedrigste zulässige Android-Version auf Android 4.4.87 oder höher in Visual Studio oder für die Option Zielplattformen in Visual Studio für Mac Moderne Entwicklung oder Maximale Kompatibilität festgelegt ist.

• System.Net.Http.HttpClientHandler, System.Net.Http: Verwenden Sie die verwaltete HttpMessageHandler.

  Entspricht der Option "Verwaltet" auf den Eigenschaftenseiten von Visual Studio.

AndroidIgnoreAllJniPreload

Ein boolescher Wert, der, wenn auf true gesetzt, alle nativen JNI-Bibliotheken vom Vorabladen beim Anwendungsstart ausnimmt. Standardmäßig werden alle derartigen Bibliotheken frühzeitig während des Anwendungsstarts von der Laufzeit geladen, um ihre ordnungsgemäße Initialisierung sicherzustellen. In einigen Fällen ist dies jedoch möglicherweise nicht das gewünschte Verhalten, und diese Eigenschaft ermöglicht es Ihnen, es effektiv zu deaktivieren.

Einige Frameworkbibliotheken, die beim Starten der Anwendung geladen werden müssen, sind von dieser Eigenschaft nicht betroffen.

Siehe auch @(AndroidNativeLibraryNoJniPreload) für eine differenziertere Methode, Bibliotheken vom Preload-Mechanismus auszunehmen.

AndroidIncludeWrapSh

Ein boolescher Wert, der angibt, ob das Android-Wrapper-Skript (wrap.sh) in das APK verpackt werden soll. Der Standardwert ist false, da das Wrapperskript die Art und Weise beeinflussen kann, wie die Anwendung startet und arbeitet. Das Skript sollte nur bei Bedarf eingebunden werden, beispielsweise beim Debuggen oder bei einer Änderung des Anwendungsstart- oder Laufzeitverhaltens.

Das Skript wird dem Projekt mithilfe der Build-Aktion hinzugefügt. @(AndroidNativeLibrary) Build-Aktion, da es im selben Verzeichnis wie architekturspezifische systemeigene Bibliotheken platziert wird und wrap.sh genannt werden muss.

Die einfachste Möglichkeit, den Pfad zum wrap.sh-Skript anzugeben, besteht darin, es in einem Verzeichnis zu platzieren, das nach der Zielarchitektur benannt ist. Dieser Ansatz funktioniert, wenn Sie pro Architektur über nur eine Datei wrap.sh verfügen:

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

Wenn Ihr Projekt jedoch mehr als ein wrap.sh pro Architektur für verschiedene Zwecke benötigt, funktioniert dieser Ansatz nicht. In solchen Fällen kann stattdessen der Name mit den Link-Metadaten für AndroidNativeLibrary angegeben werden:

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

Wenn die Link-Metadaten verwendet werden, muss es sich bei dem im zugehörigen Wert angegebenen Pfad um einen gültigen nativen architekturspezifischen Bibliothekspfad relativ zum APK-Stammverzeichnis handeln. Das Format des Pfads ist lib\ARCH\wrap.sh, wobei ARCH einer der folgenden Werte sein kann:

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

AndroidIncludeAssetPacksInPackage (Android-Ermittlung von Asset-Pakete im Paket einbeziehen)

Diese Eigenschaft steuert, ob ein Asset Packs-Build automatisch in der endgültigen .aab Datei enthalten ist. Es wird standardmäßig auf true zurückgesetzt.

In bestimmten Fällen möchte der Benutzer möglicherweise eine Zwischenversion freigeben. In diesen Fällen muss der Benutzer das Asset Pack nicht aktualisieren. Insbesondere, wenn sich der Inhalt des Bestandspakets nicht geändert hat. Mit dieser Eigenschaft kann der Benutzer die Ressourcenpakete überspringen, wenn sie nicht erforderlich sind.

Hinzugefügt in .NET 9

AndroidInstallJavaDependencies

Der Standardwert ist true für Befehlszeilenbuilds. Bei Festlegung auf true aktiviert dies die Installation des Java-Entwicklungskits beim Ausführen des <InstallAndroidDependencies/>-Ziels.

Unterstützung für diese Eigenschaft wurde in .NET 9 hinzugefügt.

AndroidJavadocVerbosity

Gibt an, wie ausführlich die C# XML-Dokumentationskommentare beim Importieren der Javadoc-Dokumentation in Bindungsprojekten sein sollen.

Erfordert die Verwendung der @(JavaSourceJar) Bauaktivität.

Die $(AndroidJavadocVerbosity) Eigenschaft ist enumerationsähnlich, mit möglichen Werten von full oder intellisense:

• intellisense: Geben Sie nur die XML-Kommentare aus: <exception/>, <param/>, <returns/>, . <summary/>
• full: Geben Sie intellisense-Elemente sowie <remarks/>, <seealso/> und alles andere, was unterstützt wird, aus.

Der Standardwert ist intellisense.

AndroidKeyStore

Ein boolescher Wert, der angibt, ob benutzerdefinierte Signaturinformationen verwendet werden sollen. Der Standardwert ist False. Dies bedeutet, dass der Debugsignatur-Standardschlüssel verwendet wird, um Pakete zu signieren.

AndroidLaunchActivity

Die Android-Aktivität zum Starten.

AndroidLinkMode

Gibt an, welcher Typ von Verknüpfung für Assemblys ausgeführt werden soll, die im Android-Paket enthalten sind. Wird nur in Android-Anwendungsprojekten verwendet. Der Standardwert ist SdkOnly. Gültige Werte sind:

• Keiner: Es wird keine Verknüpfung versucht.

• SdkOnly: Verknüpfung wird nur für die Basisklassenbibliotheken ausgeführt, nicht für die Assemblys des Benutzers.

• Full: Verknüpfung wird für die Basisklassenbibliotheken und die Assemblys des Benutzers ausgeführt.

  Hinweis

  Die Verwendung des AndroidLinkMode-Werts Full führt häufig zu fehlerhaften Apps, insbesondere beim Einsatz von Reflektion. Vermeiden Sie es, es sei denn, Sie wissen wirklich, was Sie tun.

<AndroidLinkMode>SdkOnly</AndroidLinkMode>

AndroidLinkResources

Wenn true, verknüpft das Buildsystem die geschachtelten Typen der Klasse Resource.Designer.cs Resource in allen Assemblies. Der IL-Code, der diese Typen verwendet, wird aktualisiert, um die Werte direkt zu verwenden, anstatt auf Felder zuzugreifen.

Das Ausgliedern der geschachtelten Typen kann die APK-Größe in einem geringen Maß verringern und zur Verbesserung der Startleistung beitragen. Nur "Release"-Builds sind verlinkt.

Experimentell. Nur dafür konzipiert, mit Code wie beispielsweise zu arbeiten

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

Alle anderen Szenarien (z. B. Spiegelung) werden nicht unterstützt.

AndroidLinkSkip

Gibt eine durch Semikolons (;) getrennte Liste von Assemblynamen (ohne Dateierweiterungen) von Assemblys an, die nicht verknüpft werden sollen. Wird nur in Android-Anwendungsprojekten verwendet.

<AndroidLinkSkip>Assembly1;Assembly2</AndroidLinkSkip>

AndroidLinkTool

Eine Eigenschaft im Enumerationsstil mit gültigen Werten von proguard oder r8. Gibt an, welcher Code-Shrinker für Java-Code verwendet wird. Der Standardwert ist eine leere Zeichenfolge oder proguard, wenn $(AndroidEnableProguard) gleich True ist. Lesen Sie unsere Dokumentation zu D8 und R8.

AndroidLintEnabled

Eine bool-Eigenschaft, mit der der Entwickler das Android-Tool lint als Teil des Paketprozesses ausführen kann.

Wenn $(AndroidLintEnabled) den Wert TRUE hat, werden die folgenden Eigenschaften verwendet:

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

Die folgenden Buildaktionen können ebenfalls verwendet werden:

• @(AndroidLintConfig):

Weitere Details zu den Android-lint-Werkzeugen finden Sie in der Lint-Hilfe.

AndroidLintEnabledIssues

Eine Zeichenfolgeneigenschaft, die eine durch Kommas getrennte Liste der zu aktivierenden Lintprobleme ist.

Wird nur verwendet, wenn $(AndroidLintEnabled)=True.

AndroidLintDeaktivierteProbleme (AndroidLintDisabledIssues)

Eine Zeichenfolge, die eine kommagetrennte Liste von Lintproblemen darstellt, die deaktiviert werden sollen.

Wird nur verwendet, wenn $(AndroidLintEnabled)=True.

AndroidLintPrüfungsProbleme

Eine Zeichenfolgeneigenschaft, die eine durch Kommas getrennte Liste der zu überprüfenden Lint-Fehler ist.

Wird nur verwendet, wenn $(AndroidLintEnabled)=True.

Hinweis: Es werden nur diese Probleme überprüft.

AndroidManagedSymbols

Eine boolesche Eigenschaft, die steuert, ob Sequenzpunkte generiert werden, sodass Informationen zu Dateinamen und Zeilennummern aus Release-Stack-Traces extrahiert werden können.

AndroidManifest

Gibt einen Dateinamen an, der als Vorlage für die Datei AndroidManifest.xml der App verwendet werden soll. Während des Buildprozesses werden alle anderen notwendigen Werte zusammengeführt, um die eigentliche Datei AndroidManifest.xml zu generieren. $(AndroidManifest) muss den Paketnamen im /manifest/@package-Attribut enthalten.

AndroidManifestMerger

Gibt die Implementierung für die Zusammenführung von AndroidManifest.xml-Dateien an. Hierbei handelt es sich um eine Enumerationseigenschaft, bei der legacy die ursprüngliche C#-Implementierung und manifestmerger.jar die Java-Implementierung von Google auswählt.

Der derzeitige Standardwert ist manifestmerger.jar. Wenn Sie die alte Version verwenden möchten, fügen Sie Ihrem csproj Folgendes hinzu:

<AndroidManifestMerger>legacy</AndroidManifestMerger>

Der Merger von Google ermöglicht die Unterstützung für xmlns:tools="http://schemas.android.com/tools" (siehe Beschreibung in der Android-Dokumentation).

AndroidManifestMergerExtraArgs

Eine Zeichenfolgeneigenschaft, um Argumente für das Android-Dokumentationstool bereitzustellen.

Wenn Sie eine detaillierte Ausgabe des Tools benötigen, können Sie Folgendes zu der .csprojDatei hinzufügen.

<AndroidManifestMergerExtraArgs>--log VERBOSE</AndroidManifestMergerExtraArgs>

AndroidManifestType

Eine Eigenschaft im Enumerationsstil mit gültigen Werten von Xamarin oder GoogleV2. Dies steuert, welches Repository verwendet wird von InstallAndroidDependencies Ziel ist es, festzustellen, welche Android-Pakete und Paketversionen verfügbar sind und installiert werden können.

Xamarin ist das Repository für genehmigte Liste (empfohlen) im Visual Studio SDK Manager.

GoogleV2 ist das Vollständige Listen-Repository (nicht unterstützt) im Visual Studio SDK Manager.

Wenn $(AndroidManifestType) nicht festgelegt ist, wird Xamarin verwendet.

AndroidManifestPlaceholders

Eine durch Semikolons getrennte Liste der Schlüssel-Wert-Ersatzpaare für AndroidManifest.xml, wobei jedes Paar das Format key=value aufweist.

Ein Eigenschaftswert von assemblyName=$(AssemblyName) definiert beispielsweise einen ${assemblyName}-Platzhalter, der dann in AndroidManifest.xml angezeigt werden kann.

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

Dies bietet eine Möglichkeit, Variablen aus dem Buildprozess in die Datei AndroidManifest.xml einzufügen.

AndroidMultiDexClassListExtraArgs

Eine Zeichenfolgeneigenschaft, mit der die Entwickler Argumente an com.android.multidex.MainDexListBuilder beim Generieren der multidex.keep Datei übergeben können.

Ein spezieller Fall ist, wenn bei der dx-Kompilierung der folgende Fehler angezeigt wird.

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

Wenn Sie diesen Fehler erhalten, können Sie in der .csproj-Datei Folgendes hinzufügen.

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

wodurch der dx Schritt erfolgreich ausgeführt werden kann.

AndroidPackageFormat

Eine Eigenschaft im Enumerationsstil mit gültigen Werten von apk oder aab. Gibt an, ob Sie die Android-Anwendung als APK-Datei oder Android App Bundle verpacken möchten. App-Bundles sind ein neues Format für Release-Builds, die für die Übermittlung auf Google Play vorgesehen sind. Der Standardwert ist apk.

Wenn $(AndroidPackageFormat) auf aabfestgelegt ist, werden andere MSBuild-Eigenschaften festgelegt, die für Android-App-Bundles erforderlich sind:

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

Diese Eigenschaft wird für .net 6 veraltet sein. Benutzer sollten zum neueren AndroidPackageFormats wechseln.

Android-Paketformate (AndroidPackageFormats)

Eine durch Semikolons getrennte Eigenschaft mit gültigen Werten von apk und aab. Gibt an, ob Sie die Android-Anwendung als APK-Datei oder Android App Bundle verpacken möchten. App-Bundles sind ein neues Format für Release-Builds, die für die Übermittlung auf Google Play vorgesehen sind.

Beim Erstellen eines Release-Builds möchten Sie möglicherweise sowohl ein aab als auch ein apk für die Verteilung in verschiedenen Stores erstellen.

AndroidPackageFormats auf aab;apk zu setzen führt dazu, dass beide generiert werden. Durch die Einstellung von AndroidPackageFormats entweder auf aab oder apk wird nur eine Datei generiert.

Der Standardwert aab;apk gilt nur für Release-Builds. Es wird empfohlen, dass Sie weiterhin nur apk für das Debuggen verwenden.

AndroidPackageNamingPolicy

Eine Eigenschaft im Enumerationsstil zum Angeben der Java-Paketnamen des generierten Java-Quellcodes.

Der einzige unterstützte Wert lautet LowercaseCrc64.

AndroidPrepareForBuildDependsOn

Eine durch Semikolons getrennte Eigenschaft, die zum Erweitern des Android-Buildprozesses verwendet werden kann. MSBuild-Ziele, die dieser Eigenschaft hinzugefügt werden, werden frühzeitig im Build für Anwendungs- und Bibliotheksprojekttypen ausgeführt. Diese Eigenschaft ist standardmäßig leer.

Beispiel:

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

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

AndroidProguardMappingFile

Gibt die ProGuard-Regel -printmapping für r8 an. Dies bedeutet, dass die Datei mapping.txt im Ordner $(OutputPath) erstellt wird. Diese Datei kann dann verwendet werden, wenn Pakete in den Google Play Store hochgeladen werden.

Standardmäßig wird diese Datei bei Verwendung AndroidLinkTool=r8 automatisch erstellt und generiert die folgende Datei $(OutputPath)mapping.txt.

Wenn Sie diese Zuordnungsdatei nicht generieren möchten, können Sie die AndroidCreateProguardMappingFile Eigenschaft verwenden, um die Erstellung zu stoppen. Fügen Sie Folgendes in Ihrem Projekt hinzu:

<AndroidCreateProguardMappingFile>False</AndroidCreateProguardMappingFile>

oder -p:AndroidCreateProguardMappingFile=False in der Befehlszeile verwenden.

AndroidD8IgnoreWarnings

Gibt an, dass --map-diagnostics warning info an d8 übergeben werden soll. Der Standardwert ist True, kann aber auf False gesetzt werden, um ein strengeres Verhalten zu erzwingen. Ausführliche Informationen finden Sie im Quellcode von D8 und R8.

In .NET 8 hinzugefügt.

AndroidR8IgnoreWarnings

Gibt die ProGuard-Regel -ignorewarnings für r8 an. Dadurch kann r8 mit der DEX-Kompilierung fortfahren, auch wenn bestimmte Warnungen auftreten. Der Standardwert ist True, kann aber auf False festgelegt werden, um ein strengeres Verhalten zu erzwingen. Weitere Informationen finden Sie im ProGuard-Leitfaden.

Gibt ab .NET 8 an --map-diagnostics warning info. Ausführliche Informationen finden Sie im Quellcode von D8 und R8.

AndroidR8JarPath

Der Pfad zur Datei r8.jar zur Verwendung mit dem r8 dex-Compiler und -Shrinker. Der Standardwert ist ein Pfad zur .NET für Android-Workload-Installation. Weitere Informationen finden Sie in unserer Dokumentation zu D8 und R8.

AndroidResgenExtraArgs

Gibt Befehlszeilenoptionen an, die an den aapt-Befehl übergeben werden sollen, wenn Android-Assets und -Ressourcen verarbeitet werden.

AndroidResgenFile

Gibt den Namen der zu generierenden Ressourcendatei an. Die Standardvorlage legt diese Option auf Resource.designer.cs fest.

AndroidResourceDesignerClassModifier

Gibt den Klassenmodifizierer für die zwischengeschaltete Resource Klasse an, die generiert wird. Gültige Werte sind public und internal.

Standardmäßig lautet dies public.

In .NET 9 hinzugefügt.

AndroidSdkBuildToolsVersion

Das Buildtoolpaket des Android SDK enthält unter anderem die Tools aapt und zipalign. Mehrere verschiedene Versionen des build-tools-Pakets können gleichzeitig installiert werden. Das build-tools-Paket, das für die Paketerstellung ausgewählt wird, wird durch Überprüfen und Verwenden einer „bevorzugten“ build-tools-Version ermittelt, wenn diese vorhanden ist. Wenn die „bevorzugte“ Version nicht vorhanden ist, wird das Paket mit der höchsten installierten build-tools-Version verwendet.

Die MSBuild-Eigenschaft $(AndroidSdkBuildToolsVersion) enthält die bevorzugte build-tools-Version. Das .NET für Android-Buildsystem bietet einen Standardwert in Xamarin.Android.Common.targets, und der Standardwert kann in Ihrer Projektdatei außer Kraft gesetzt werden, um eine alternative Build-Tools-Version auszuwählen, wenn (z. B.) das neueste aapt abstürzt, während bekannt ist, dass eine vorherige aapt-Version funktioniert.

Android Signierungsschlüsselalias

Gibt den Alias für den Schlüssel im Keystore an. Dies ist der Wert keytool -alias, der beim Erstellen des Keystore verwendet wird.

AndroidSigningKeyPass

Gibt das Kennwort des Schlüssels in der Keystoredatei an. Dies ist der Wert, der eingegeben wird, wenn keytool die folgende Aufforderung ausgibt: Enter key password for $(AndroidSigningKeyAlias).

Diese Eigenschaft unterstützt auch die Präfixe env: und file:, die verwendet werden können, um eine Umgebungsvariable oder eine Datei anzugeben, die das Kennwort enthält. Diese Optionen bieten eine Möglichkeit, zu verhindern, dass das Kennwort in Buildprotokollen auftaucht.

So wird beispielsweise eine Umgebungsvariable mit dem Namen AndroidSigningPassword verwendet:

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

Um eine Datei unter C:\Users\user1\AndroidSigningPassword.txt zu verwenden:

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

AndroidSigningKeyStore

Gibt den Dateinamen der von keytool erstellten Keystoredatei an. Dies entspricht dem Wert, der der Option keytool -keystore zur Verfügung gestellt wird.

AndroidSigningStorePass

Gibt das Kennwort für $(AndroidSigningKeyStore) an. Dies ist der Wert, der keytool beim Erstellen der Keystoredatei zur Verfügung gestellt wird, wenn die folgende Aufforderung ausgegeben wird: Enter keystore password:.

Diese Eigenschaft unterstützt auch die Präfixe env: und file:, die verwendet werden können, um eine Umgebungsvariable oder eine Datei anzugeben, die das Kennwort enthält. Diese Optionen bieten eine Möglichkeit, zu verhindern, dass das Kennwort in Buildprotokollen auftaucht.

So wird beispielsweise eine Umgebungsvariable mit dem Namen AndroidSigningPassword verwendet:

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

So verwenden Sie eine Datei, die sich bei C:\Users\user1\AndroidSigningPassword.txt befindet:

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

AndroidSigningPlatformKey

Gibt die Schlüsseldatei an, die zum Signieren der APK verwendet werden soll. Dies wird nur beim Erstellen von system Anwendungen verwendet.

AndroidSigningPlatformCert

Gibt die Zertifikatdatei an, die zum Signieren der APK verwendet werden soll. Dies wird nur beim Erstellen von system Anwendungen verwendet.

AndroidStripILAfterAOT

Eine Boolesche Eigenschaft, die angibt, ob die Methodenkörper der kompilierten AOT-Methoden entfernt werden.

Der Standardwert ist false, und die Methodentexte der kompilierten AOT-Methoden werden nicht entfernt.

Bei Festlegung auf true wird $(AndroidEnableProfiledAot) standardmäßig auf false festgelegt. Dies bedeutet, dass in Release-Konfigurations-Builds – in denen standardmäßig ist – AOT für alles aktiviert ist. Dies kann zu erhöhten App-Größen führen. Dieses Verhalten kann überschrieben werden, indem $(AndroidEnableProfiledAot) explizit auf true in der Projektdatei festgelegt wird.

Experimentelle Unterstützung für diese Eigenschaft wurde in .NET 8 hinzugefügt, entfernt in .NET 10.

AndroidStripNativeLibraries

Eine boolesche Eigenschaft, die dem Verpackungsvorgang vorgibt, Debugsymbole aus den nativ freigegebenen Bibliotheken (.so Dateien) entfernen zu lassen.

Der Standardwert ist false , und die Debugsymbole bleiben bei der Verpackung erhalten.

AndroidSupportedAbis

Eine Zeichenfolgeneigenschaft, die eine Liste von ABIs enthält, die durch Semikolons (;) getrennt sind und in die .apk-Datei aufgenommen werden sollen.

Unterstützte Werte sind:

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

AndroidTlsProvider

Diese Eigenschaft ist veraltet und sollte nicht verwendet werden.

AndroidUseAapt2

Dies war eine Xamarin.Android-Eigenschaft, die keine Auswirkung auf .NET für Android hat. aapt2 wird immer verwendet und kann nicht deaktiviert werden.

AndroidUseApkSigner

Eine Boolean-Eigenschaft, die es dem Entwickler ermöglicht, das apksigner-Tool anstelle von jarsigner zu verwenden.

AndroidUseDefaultAotProfile

Eine boolesche Eigenschaft, die es Entwicklern ermöglicht, die Verwendung der AOT-Standardprofile zu unterdrücken.

Zum Unterdrücken der standardmäßigen AOT-Profile wird die Eigenschaft auf false festgelegt.

AndroidUseDesignerAssembly

Eine Bool-Eigenschaft, die steuert, ob das Buildsystem eine _Microsoft.Android.Resource.Designer.dll-Datei anstatt einer Resource.Designer.cs-Datei generiert. Die Vorteile sind kleinere Anwendungen und schnellere Startzeit.

Der Standardwert ist true in .NET 8.

Als Nuget Author wird empfohlen, drei Versionen der Assembly zu versenden, wenn Sie die Abwärtskompatibilität beibehalten möchten. Eine für MonoAndroid, eine für net6.0-android und eine für net8.0-android. Dazu können Sie Xamarin.Legacy.Sdk verwenden. Dies ist nur erforderlich, wenn Ihr NuGet-Bibliotheksprojekt AndroidResource Elemente im Projekt oder über eine Abhängigkeit verwendet.

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

Alternativ können Sie diese Einstellung deaktivieren, bis beispielsweise "Classic" und "net7.0-android" veraltet sind.

.NET 8 Projekte, die sich entscheiden, diese Einstellung zu deaktivieren, können keine Verweise verarbeiten, die sie verwenden. Wenn Sie versuchen, eine Assembly zu verwenden, die dieses Feature in einem Projekt aktiviert hat, das nicht funktioniert, erhalten Sie einen XA1034 Buildfehler.

In .NET 8 hinzugefügt.

AndroidUseInterpreter

Eine boolesche Eigenschaft, die bewirkt, dass .apk den Mono-Interpreter und nicht den normalen JIT enthält.

Experimentell.

AndroidUseLegacyVersionCode

Eine boolesche Eigenschaft, mit der der Entwickler die VersionCode-Berechnung wieder auf das alte Verhalten vor Xamarin.Android 8.2 zurücksetzen kann. Dies sollte NUR für Entwickler verwendet werden, die an im Google Play Store vorhandenen Anwendungen arbeiten. Es wird dringend empfohlen, die neue $(AndroidVersionCodePattern)-Eigenschaft zu verwenden.

AndroidVerwaltetesDesignZeitRessourcenGenerator

Eine boolesche Eigenschaft, die die Entwurfszeitbuilds so umschaltet, dass der verwaltete Ressourcenparser statt aapt verwendet wird.

AndroidUseNegotiateAuthentication

Eine boolesche Eigenschaft, die die Unterstützung der NTLMv2/Negotiate-Authentifizierung in AndroidMessageHandlerermöglicht. Der Standardwert ist Falsch.

In .NET 7 hinzugefügt.

AndroidUseSharedRuntime

Diese Eigenschaft ist veraltet und sollte nicht verwendet werden.

AndroidVersionCode

Eine MSBuild-Eigenschaft, die als Alternative zu /manifest/@android:versionCode der AndroidManifest.xml Datei verwendet werden kann. Um dieses Feature nutzen zu können, müssen Sie zuerst <GenerateApplicationManifest>true</GenerateApplicationManifest> aktivieren. Dies ist der Standardwert in .NET 6.

Diese Eigenschaft wird ignoriert, wenn $(AndroidCreatePackagePerAbi) und $(AndroidVersionCodePattern) verwendet werden.

@android:versionCode ist ein ganzzahliger Wert, der für jede Google Play-Version erhöht werden muss. Weitere Details zu den Anforderungen für /manifest/@android:versionCode finden Sie in der Android-Dokumentation.

AndroidVersionCodePattern

Eine Zeichenfolgeneigenschaft, mit der der Entwickler das versionCode Manifest anpassen kann. Informationen zur Erstellung des Versionscodes für die APK finden Sie unter Entscheidungshilfe für einen versionCode.

Einige Beispiele: Wenn abiarmeabi ist und versionCode im Manifest 123 ist, generiert {abi}{versionCode} einen VersionCode von 1123, wenn $(AndroidCreatePackagePerAbi) wahr ist, andernfalls einen Wert von 123. Wenn abix86_64 ist und versionCode im Manifest 44 ist. Dies generiert 544, wenn $(AndroidCreatePackagePerAbi) TRUE ist, andernfalls wird ein Wert von 44 generiert.

Wenn wir eine Formatzeichenfolge für Auffüllung links {abi}{versionCode:0000} einschließen, wird 50044 generiert, weil wir versionCode links mit 0 auffüllen. Alternativ können Sie die Dezimalauffüllung verwenden, wie z.B. , {abi}{versionCode:D4} dies entspricht dem vorherigen Beispiel.

Nur die Füllungsformatzeichenfolgen „0“ und „Dx“ werden unterstützt, da der Wert eine ganze Zahl sein MUSS.

Vordefinierte Schlüsselelemente

• abi – Fügt das zielorientierte Abi für die App ein.

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

• minSDK – Fügt den minimal unterstützten SDK-Wert aus dem AndroidManifest.xml oder 11 ein, wenn keiner definiert ist.

• versionCode – Verwendet den Versionscode direkt von Properties\AndroidManifest.xml.

Sie können mithilfe der $(AndroidVersionCodeProperties)-Eigenschaft (definiert als Nächstes) benutzerdefinierte Elemente definieren.

Standardmäßig ist der Wert auf {abi}{versionCode:D6} festgelegt. Wenn Sie das vorherige Verhalten beibehalten möchten, können Sie die Standardeinstellung überschreiben, indem Sie die $(AndroidUseLegacyVersionCode)-Eigenschaft auf true festlegen.

AndroidVersionCodeProperties

Eine Zeichenfolgeneigenschaft, mit der der Entwickler benutzerdefinierte Elemente definieren kann, die mit der $(AndroidVersionCodePattern) verwendet werden. Diese liegen in Form eines key=value-Paares vor. Alle Elemente im value sollten ganzzahlige Werte sein. Beispiel: screen=23;target=$(_AndroidApiLevel) Wie Sie sehen können, können Sie vorhandene oder benutzerdefinierte MSBuild-Eigenschaften in der Zeichenfolge verwenden.

ApplicationId

Eine MSBuild-Eigenschaft, die als Alternative zu /manifest/@package der AndroidManifest.xml Datei verwendet werden kann. Um dieses Feature nutzen zu können, müssen Sie zuerst <GenerateApplicationManifest>true</GenerateApplicationManifest> aktivieren. Dies ist der Standardwert in .NET 6.

Weitere Details zu den Anforderungen für /manifest/@package finden Sie in der Android-Dokumentation.

Anwendungstitel

Eine MSBuild-Eigenschaft, die als Alternative zu /manifest/application/@android:label der AndroidManifest.xml Datei verwendet werden kann. Um dieses Feature nutzen zu können, müssen Sie zuerst <GenerateApplicationManifest>true</GenerateApplicationManifest> aktivieren. Dies ist der Standardwert in .NET 6.

Weitere Details zu den Anforderungen für /manifest/application/@android:label finden Sie in der Android-Dokumentation.

Anwendungsversion

Eine MSBuild-Eigenschaft, die als Alternative zu /manifest/@android:versionName der AndroidManifest.xml Datei verwendet werden kann. Um dieses Feature nutzen zu können, müssen Sie zuerst <GenerateApplicationManifest>true</GenerateApplicationManifest> aktivieren. Dies ist der Standardwert in .NET 6.

Weitere Details zu den Anforderungen für /manifest/@android:versionName finden Sie in der Android-Dokumentation.

AotAssemblies

Eine boolesche Eigenschaft, die bestimmt, ob Assemblys vorab in systemeigenen Code kompiliert und in Anwendungen eingeschlossen werden. Standardmäßig ist diese Eigenschaft False.

Veraltet in .NET 7. Migrieren Sie stattdessen zur neuen $(RunAOTCompilation) MSBuild-Eigenschaft, da die Unterstützung für $(AotAssemblies) in einer zukünftigen Version entfernt wird.

AProfUtilExtraOptions

Zusätzliche Optionen für die Übergabe an aprofutil.

BeforeBuildAndroidAssetPacks

MSBuild-Ziele, die in dieser Eigenschaft aufgeführt sind, werden direkt ausgeführt, bevor die AssetPack Elemente erstellt werden.

Hinzugefügt in .NET 9

BeforeGenerateAndroidManifest

Die in dieser Eigenschaft aufgelisteten MSBuild-Ziele werden direkt vor _GenerateJavaStubs ausgeführt.

Konfiguration

Gibt die zu verwendende Buildkonfiguration an, z. B. „Debug“ oder „Release“. Die Configuration-Eigenschaft wird verwendet, um Standardwerte für andere Eigenschaften zu ermitteln, die das Zielverhalten bestimmen. In der IDE können ggf. zusätzliche Konfigurationen erstellt werden.

Standardmäßig führt die Debug Konfiguration zu der Install und SignAndroidPackage zielt darauf ab, ein kleineres Android-Paket zu erstellen, das das Vorhandensein anderer Dateien und Pakete erfordert, um zu arbeiten.

Die Standardkonfiguration Release führt zu der Install und SignAndroidPackagezielt darauf ab, ein Android-Paket zu erstellen, das eigenständig ist und verwendet werden kann, ohne andere Pakete oder Dateien zu installieren.

DebugSymbols

Ein boolescher Wert, der bestimmt, ob das Android-Paket debuggierbar ist, in Kombination mit der $(DebugType) Eigenschaft. Ein debugfähiges Paket enthält Debugsymbole, setzt das //application/@android:debuggable Attribut auf true und fügt automatisch das //application/@android:debuggable hinzu. INTERNET Berechtigung, damit ein Debugger an den Prozess anhängen kann. Eine Anwendung kann debuggt werden, wenn DebugSymbols den Wert True aufweist undDebugType entweder die leere Zeichenfolge oder Full ist.

Debug-Typ

Gibt den Typ von Debugsymbolen an, die als Teil des Builds generiert werden sollen. Dies wirkt sich ebenfalls darauf aus, ob die Anwendung debuggt werden kann. Mögliche Werte sind:

• Full: Vollständige Symbole werden generiert. Wenn die MSBuild-Eigenschaft DebugSymbols MSBuild-Eigenschaft ist auch True, dann ist das Anwendungspaket debuggierbar.

• PdbOnly: Es werden PDB-Symbole generiert. Das Anwendungspaket kann nicht debuggt werden.

Wenn DebugType nicht festgelegt wurde oder die leere Zeichenfolge ist, steuert die DebugSymbols-Eigenschaft, ob die Anwendung debuggt werden kann.

Gerät

Gibt an, auf welches Android-Gerät oder welchen Emulator bei der Verwendung von dotnet run --device <Device> oder MSBuild-Zielen ausgerichtet werden soll, die mit Geräten interagieren (z. B. Run, Install oder Uninstall).

Der Wert muss die vollständige Seriennummer oder der Gerätename sein, wie er von adb devices zurückgegeben wird. Wenn das Gerät z. B. serial ist emulator-5554, müssen Sie verwenden -p:Device=emulator-5554.

Bei Festlegung wird diese Eigenschaft verwendet, um die AdbTarget Eigenschaft mit dem Wert -s "<Device>"zu initialisieren.

Weitere Informationen zur Geräteauswahl finden Sie in der .NET SDK-Geräteauswahlspezifikation.

DiagnosticAddress

Ein Wert, der von dotnet-dsrouter bereitgestellt wird, wie zum Beispiel 127.0.0.1, die IP-Adresskomponente von $(DiagnosticConfiguration) oder $DOTNET_DiagnosticPorts.

Ermöglicht implizit die Mono-Diagnosekomponente, was bedeutet, dass $(EnableDiagnostics)/$(AndroidEnableProfiler) auf true festgelegt ist.

Wird standardmäßig auf 127.0.0.1 festgelegt.

Diagnostik-Konfiguration

Ein von dotnet-dsrouter für $DOTNET_DiagnosticPorts bereitgestellter Wert, wie zum Beispiel:

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

Beachten Sie, dass das ,-Zeichen mit %2c maskiert werden muss, wenn es in der Befehlszeile an dotnet build übergeben wird.

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

Dadurch wird die $DOTNET_DiagnosticPorts Umgebungsvariable automatisch festgelegt, die in der Anwendung verpackt ist.

Ermöglicht implizit die Mono-Diagnosekomponente, was bedeutet, dass $(EnableDiagnostics)/$(AndroidEnableProfiler) auf true festgelegt ist.

DiagnosticListenMode

Ein von dotnet-dsrouter angegebener Wert, wie z. B. die Überwachungsmoduskomponente von $(DiagnosticConfiguration) oder $DOTNET_DiagnosticPorts.

Ermöglicht implizit die Mono-Diagnosekomponente, was bedeutet, dass $(EnableDiagnostics)/$(AndroidEnableProfiler) auf true festgelegt ist.

Wird standardmäßig auf connect festgelegt.

DiagnosticPort

Ein von dotnet-dsrouter bereitgestellter Wert, wie 9000, der Portkomponente von $(DiagnosticConfiguration) oder $DOTNET_DiagnosticPorts.

Ermöglicht implizit die Mono-Diagnosekomponente, d. h., dass $(EnableDiagnostics)/$(AndroidEnableProfiler) auf true festgelegt wird.

Wird standardmäßig auf 9000 festgelegt.

DiagnosticSuspend

Ein boolescher Wert, bereitgestellt von dotnet-dsrouter, wie true/suspend oder false/nosuspend, eine Komponente von $(DiagnosticConfiguration) oder $DOTNET_DiagnosticPorts.

Ermöglicht implizit die Mono-Diagnosekomponente, also, dass $(EnableDiagnostics)/$(AndroidEnableProfiler) auf true festgelegt ist.

Wird standardmäßig auf false festgelegt.

EmbedAssembliesIntoApk

Eine boolesche Eigenschaft, die bestimmt, ob die Assemblys der App in das Anwendungspaket eingebettet werden sollen.

Diese Eigenschaft sollte True für Releasebuilds und False für Debugbuilds sein. Es kann in Debug-Builds erforderlich sein, wenn die Schnellbereitstellung das Zielgerät nicht unterstützt.

Wenn diese Eigenschaft lautet False, dann $(AndroidFastDeploymentType) MsBuild-Eigenschaft steuert auch, was in die .apkEingebettet werden soll, was sich auf die Bereitstellungs- und Neuerstellungszeiten auswirken kann.

Diagnose aktivieren

Synonym für die $(AndroidEnableProfiler) Eigenschaft.

Erforderlich für die Verwendung dotnet-trace oder dotnet-gcdump in Android-Anwendungen. Bei Festlegung auf true, enthält sie die Mono-Diagnosekomponente in der Anwendung. Diese Komponente ist die libmono-component-diagnostics_tracing.so systemeigene Bibliothek.

Standardmäßig ist diese Eigenschaft False.

Aktivieren Sie LLVM

Eine boolesche Eigenschaft, die bestimmt, ob LLVM verwendet wird, wenn Assemblys vorab in nativen Code kompiliert werden.

Zum Erstellen eines Projekts, für das diese Eigenschaft aktiviert ist, muss das Android-NDK installiert sein.

Standardmäßig ist diese Eigenschaft False.

Diese Eigenschaft wird ignoriert, wenn die MSBuild-Eigenschaft $(AotAssemblies) nicht den Wert True aufweist.

EnableProguard

Eine boolesche Eigenschaft, die bestimmt, ob ProGuard als Teil des Paketerstellungsprozesses ausgeführt wird, um Java-Code zu verknüpfen.

Standardmäßig ist diese Eigenschaft False.

Wenn True, werden @(ProguardConfiguration)-Dateien verwendet, um die proguard-Ausführung zu steuern.

EventSourceSupport

Bei Festlegung auf false deaktiviert .NET die EventSource-Unterstützung von gekürzten Android-Anwendungen. Durch das Deaktivieren dieses Features würden .NET-Diagnosetools wie dotnet-counters nicht funktionieren, was jedoch den Vorteil einer reduzierten Anwendungsgröße bietet.

Standardmäßig auf false eingestellt im Release Modus, es sei denn, $(EnableDiagnostics) oder $(AndroidEnableProfiler) aktiviert sind.

AnwendungsmanifestErzeugen

Aktiviert oder deaktiviert die folgenden MSBuild-Eigenschaften, die Werte in der endgültigen AndroidManifest.xml Datei ausgeben:

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

Der Standardwert $(GenerateApplicationManifest) ist true.

JavaMaximumHeapSize

Gibt den Wert des Java-Parameters-Xmx an, der beim Erstellen der .dex-Datei als Teil des Paketerstellungsprozesses verwendet werden soll. Wenn nicht angegeben ist, wird die Option -Xmx verwendet, um java mit einem Wert von 1G zu versorgen. Dies wurde unter Windows im Vergleich zu anderen Plattformen als häufig erforderlich erachtet.

Die Angabe dieser Eigenschaft ist erforderlich, wenn das _CompileDex-Ziel einen java.lang.OutOfMemoryError auslöst.

Passen Sie den Wert durch folgende Änderungen an:

<JavaMaximumHeapSize>1G</JavaMaximumHeapSize>

JavaOptions

Gibt Befehlszeilenoptionen an, die beim Erstellen der Datei an java übergeben werden sollen.

JarsignerTimestampAuthorityCertificateAlias

Über diese Eigenschaft können Sie einen Alias im Keystore für eine Zeitstempelautorität angeben. Weitere Informationen finden Sie in der Java Dokumentation zur Zeitstempelunterstützung für Signaturen.

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

JarsignerTimestampAuthorityUrl

Über diese Eigenschaft können Sie eine URL zu einem Zeitstempelautoritätsdienst angeben. Diese kann verwendet werden, um sicherzustellen, dass die .apk-Signatur einen Zeitstempel enthält. Weitere Informationen finden Sie in der Java Dokumentation zur Zeitstempelunterstützung für Signaturen.

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

LinkerDumpDependencies

Eine Bool-Eigenschaft, die das Generieren von Linkerabhängigkeiten-Datei ermöglicht. Diese Datei kann als Eingabe für das Illinkanalyzer-Tool verwendet werden.

Die Abhängigkeitsdatei linker-dependencies.xml.gz wird in das Projektverzeichnis geschrieben. Bei .NET 5/6 wird sie neben den verknüpften Assemblys in das Verzeichnis obj/<Configuration>/android<ABI>/linked geschrieben.

Der Standardwert ist Falsch.

MandroidI18n

Diese MSBuild-Eigenschaft ist veraltet und wird nicht mehr unterstützt.

MetricsSupport

Wenn auf false festgelegt, deaktiviert .NET die Metrikunterstützung für gekürzte Android-Anwendungen. Durch das Deaktivieren dieses Features würden APIs wie System.Diagnostics.Metrics z. B. nicht funktionieren, aber im Vorteil einer reduzierten Anwendungsgröße.

Standardmäßig auf false gesetzt im Release Modus, es sei denn, $(EnableDiagnostics) oder $(AndroidEnableProfiler) sind aktiviert.

MonoAndroidAssetPrefix

Gibt ein Pfadpräfix an, das am Anfang von Dateinamen mit einer Buildaktion von AndroidAsset entfernt wird. Damit soll ermöglicht werden, den Speicherort von Ressourcen zu ändern.

Der Standardwert ist Assets. Ändern Sie diese Option für die Java-Projektstruktur in assets.

MonoAndroidResourcePrefix

Gibt ein Pfadpräfix an, das am Anfang von Dateinamen bei einer Build-Aktion von AndroidResource entfernt wird. Damit soll ermöglicht werden, den Speicherort von Ressourcen zu ändern.

Der Standardwert ist Resources. Ändern Sie diese Option für die Java-Projektstruktur in res.

MonoSymbolArchive

Eine boolesche Eigenschaft, die steuert, ob .mSYM Artefakte erstellt werden, die später mit mono-symbolicate verwendet werden, um "reale" Dateinamen- und Zeilennummerninformationen aus Release-Stapelablaufverfolgungen zu extrahieren.

Dies ist standardmäßig "True" für "Release"-Apps mit aktivierten Debugsymbolen: $(EmbedAssembliesIntoApk) ist "True", $(DebugSymbols) ist wahr, und $(Optimize) ist True.

RunAOTCompilation

Eine boolesche Eigenschaft, die bestimmt, ob Assemblys vorab in systemeigenen Code kompiliert und in Anwendungen eingeschlossen werden. Diese Eigenschaft ist False standardmäßig für Debug Builds und True standardmäßig für Release Builds vorgesehen.

Diese MSBuild-Eigenschaft ersetzt die $(AotAssemblies) MSBuild-Eigenschaft von Xamarin.Android. Dies ist die gleiche Eigenschaft, die für Blazor WASM verwendet wird.

WaitForExit

Eine boolesche Eigenschaft, die das Verhalten beim Starten von dotnet run Android-Anwendungen steuert.

Wenn $(WaitForExit) nicht false (der Standard) ist, wird Folgendes geschehen dotnet run:

• Starten der Android-Anwendung
• Die Ausgabe des Streams logcat wird auf den Prozess der Anwendung gefiltert.
• Warten Sie, bis die Anwendung beendet wird, oder drücken Sie STRG+C.
• Erzwingen des Beendens der Anwendung, wenn STRG+C gedrückt wird

Wenn $(WaitForExit)false, wird dotnet run die Anwendung einfach mit adb shell am start starten und sofort zurückkehren, ohne darauf zu warten, dass die Anwendung endet oder Ausgaben streamt.

In .NET 11 eingeführt.