App-Informationen

Durchsuchen Sie das Beispiel

In diesem Artikel wird beschrieben, wie Sie die .NET Multi-Platform App UI (.NET MAUI) IAppInfo -Schnittstelle verwenden können, die Informationen zu Ihrer Anwendung bereitstellt.

Die Standardimplementierung der IAppInfo-Schnittstelle ist über die AppInfo.Current-Eigenschaft verfügbar. Die IAppInfo-Schnittstelle sowie die AppInfo-Klasse sind im Microsoft.Maui.ApplicationModel-Namespace enthalten.

Lesen der App-Informationen

Die IAppInfo-Schnittstelle weist die folgenden Eigenschaften auf:

• Name – Der Anwendungsname.
• PackageName – Der Paketname oder Anwendungsbezeichner, beispielsweise com.microsoft.myapp.
• VersionString – Die Anwendungsversion, beispielsweise 1.0.0.
• Version – Die Anwendungsversion als Version-Objekt.
• BuildString – Die Buildversionsnummer, beispielsweise 1000.
• RequestedTheme – Das erkannte Design des Systems oder der Anwendung.
• PackagingModel – Das Verpackungsmodell der Anwendung.
• RequestedLayoutDirection – Die angeforderte Layoutrichtung des Systems oder der Anwendung.

Im folgenden Codebeispiel wird der Zugriff auf einige dieser Eigenschaften veranschaulicht:

string name = AppInfo.Current.Name;
string package = AppInfo.Current.PackageName;
string version = AppInfo.Current.VersionString;
string build = AppInfo.Current.BuildString;

Abfragen des aktuellen Designs

Die Eigenschaft RequestedTheme stellt das aktuell angeforderte Design vom System für Ihre Anwendung bereit. Einer der folgenden Werte wird zurückgegeben:

• Unspecified
• Light
• Dark

Unspecified wird zurückgegeben, wenn das Betriebssystem nicht über einen bestimmten Benutzeroberflächenstil verfügt. Ein Beispiel hierfür sind Geräte, auf denen Versionen von iOS vor 13.0 ausgeführt werden.

Im folgenden Codebeispiel wird gezeigt, wie das Design abgerufen wird:

ThemeInfoLabel.Text = AppInfo.Current.RequestedTheme switch
{
    AppTheme.Dark => "Dark theme",
    AppTheme.Light => "Light theme",
    _ => "Unknown"
};

Abrufen der Layoutrichtung

Die Eigenschaft RequestedLayoutDirection stellt die aktuelle Layoutrichtung bereit, die vom System für Ihre Anwendung verwendet wird. Einer der folgenden Werte wird zurückgegeben:

• Unknown
• LeftToRight
• RightToLeft

Unknown wird zurückgegeben, wenn die Layoutrichtung unbekannt ist.

Im folgenden Codebeispiel wird das Abrufen der Layoutrichtung veranschaulicht:

LayoutDirection layoutDirection = AppInfo.Current.RequestedLayoutDirection;

Anzeigen von App-Einstellungen

Die Klasse IAppInfo kann auch eine Seite mit den Einstellungen anzeigen, die vom Betriebssystem für die Anwendung verwaltet werden:

AppInfo.Current.ShowSettingsUI();

Diese Seite mit den Einstellungen ermöglicht dem Benutzer, Anwendungsberechtigungen zu ändern und andere plattformspezifische Aufgaben auszuführen.

Besonderheiten bei der plattformspezifischen Implementierung

In diesem Abschnitt werden plattformspezifische Implementierungsdetails im Zusammenhang mit der IAppInfo-Schnittstelle beschrieben.

Android

Für die folgenden Felder werden App-Informationen aus der Datei AndroidManifest.xml abgerufen:

• BuildString – android:versionCode im manifest-Knoten
• Name – android:label im application-Knoten
• PackageName – package im manifest-Knoten
• VersionString – android:versionName im manifest-Knoten

Angefordertes Design

Android verwendet Konfigurationsmodi, um den Typ des Designs festzulegen, der vom Benutzer angefordert werden soll. Je nach Android-Version kann er vom Benutzer geändert werden oder kann geändert werden, wenn der Stromsparmodus aktiviert ist.

Weitere Informationen finden Sie in der offiziellen Android-Dokumentation zum dunklen Design.

iOS/Mac Catalyst

Für die folgenden Felder werden App-Informationen aus der Datei Info.plist abgerufen:

• BuildString – CFBundleVersion
• Name – CFBundleDisplayName falls festgelegt, andernfalls CFBundleName
• PackageName – CFBundleIdentifier
• VersionString – CFBundleShortVersionString

Angefordertes Design

Bei iOS-Versionen vor 13.0 wird stets Nicht angegeben zurückgegeben.

Windows

Für die folgenden Felder werden App-Informationen aus der Datei Package.appxmanifest abgerufen:

• BuildString – Verwendet den Build aus dem Version im Identity-Knoten
• Name – DisplayName im Properties-Knoten
• PackageName – Name im Identity-Knoten
• VersionString – Version im Identity-Knoten

Angefordertes Design

Code, der auf die IAppInfo.RequestedTheme-Eigenschaft zugreift, muss im UI-Thread aufgerufen werden. Sonst wird eine Ausnahme ausgelöst.

Windows-Anwendungen respektieren die RequestedTheme-Eigenschaftseinstellung in der Windows App.xaml. Wenn die Option auf ein bestimmtes Design festgelegt ist, gibt diese API immer diese Einstellung zurück. Um das dynamische Design des Betriebssystems zu verwenden, entfernen Sie diese Eigenschaft aus Ihrer Anwendung. Wenn Ihre App ausgeführt wird, gibt sie das vom Benutzer festgelegte Design in den Windows-Einstellungen zurück: Einstellungen>Personalisierung>Farben>Standard-App-Modus auswählen.