Informace o aplikaci

Procházení ukázky

Tento článek popisuje, jak můžete používat rozhraní .NET Multi-Platform App UI (.NET MAUI), IAppInfo které poskytuje informace o vaší aplikaci.

Výchozí implementace IAppInfo rozhraní je k dispozici prostřednictvím AppInfo.Current vlastnosti. Rozhraní IAppInfo i AppInfo třída jsou obsaženy v Microsoft.Maui.ApplicationModel oboru názvů.

Čtení informací o aplikaci

Rozhraní IAppInfo zveřejňuje následující vlastnosti:

• Name — Název aplikace.
• PackageName — Název balíčku nebo identifikátor aplikace, například com.microsoft.myapp.
• VersionString — Verze aplikace, například 1.0.0.
• Version — Verze aplikace jako Version objekt.
• BuildString — Číslo buildu verze, například 1000.
• RequestedTheme — Zjištěný motiv systému nebo aplikace.
• PackagingModel — Model balení aplikace.
• RequestedLayoutDirection — Požadovaný směr rozložení systému nebo aplikace.

Následující příklad kódu ukazuje přístup k některým z těchto vlastností:

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

Získání aktuálního motivu

Tato RequestedTheme vlastnost poskytuje aktuální požadovaný motiv systémem pro vaši aplikaci. Vrátí se jedna z následujících hodnot:

• Unspecified
• Light
• Dark

Unspecified vrátí, pokud operační systém nemá konkrétní styl uživatelského rozhraní. Příkladem je zařízení se staršími verzemi iOSu než 13.0.

Následující příklad kódu ukazuje získání motivu:

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

Získání směru rozložení

Vlastnost RequestedLayoutDirection poskytuje aktuální směr rozložení používaný systémem pro vaši aplikaci. Vrátí se jedna z následujících hodnot:

• Unknown
• LeftToRight
• RightToLeft

Unknown je vrácena, pokud je směr rozložení neznámý.

Následující příklad kódu ukazuje získání směru rozložení:

LayoutDirection layoutDirection = AppInfo.Current.RequestedLayoutDirection;

Zobrazení nastavení aplikace

Třída IAppInfo může také zobrazit stránku nastavení udržovaná operačním systémem pro aplikaci:

AppInfo.Current.ShowSettingsUI();

Tato stránka nastavení umožňuje uživateli změnit oprávnění aplikace a provádět další úlohy specifické pro danou platformu.

Specifika implementace platformy

Tato část popisuje podrobnosti implementace specifické pro platformu související s rozhraním IAppInfo .

Android

Informace o aplikaci pocházejí z souboru AndroidManifest.xml pro následující pole:

• BuildString — android:versionCode v manifest uzlu
• Name — android:label v application uzlu
• PackageName — package v manifest uzlu
• VersionString — android:versionName v manifest uzlu

Požadovaný motiv

Android používá režimy konfigurace k určení typu motivu, který má uživatel vyžádat. Na základě verze Androidu ho může uživatel změnit nebo může být změněn, když je povolený režim spořič baterie.

Další informace najdete v oficiální dokumentaci k Androidu pro tmavý motiv.

iOS/Mac Catalyst

Informace o aplikaci jsou převzaty z souboru Info.plist pro následující pole:

• BuildString — CFBundleVersion
• Name — CFBundleDisplayName pokud je nastavena, jinak CFBundleName
• PackageName — CFBundleIdentifier
• VersionString — CFBundleShortVersionString

Požadovaný motiv

Nezadané je vždy vráceno ve verzích iOSu starších než 13.0.

Windows

Informace o aplikaci jsou převzaty z Package.appxmanifest pro následující pole:

• BuildString — Používá Build z Version Identity uzlu
• Name — DisplayName na Properties uzlu
• PackageName — Name na Identity uzlu
• VersionString — Version na Identity uzlu

Požadovaný motiv

Kód, který přistupuje k IAppInfo.RequestedTheme vlastnosti, musí být volán ve vlákně uživatelského rozhraní nebo bude vyvolána výjimka.

Aplikace pro Windows respektují RequestedTheme nastavení vlastnosti v souboru Windows App.xaml. Pokud je nastavené na určitý motiv, toto rozhraní API vždy vrátí toto nastavení. Pokud chcete použít dynamický motiv operačního systému, odeberte tuto vlastnost z aplikace. Když je aplikace spuštěná, vrátí motiv nastavený uživatelem v nastavení Windows: Nastavení> Personalization>Colors>Choose your default app mode.