共用方式為

應用程式資訊

  • 發行項

Browse sample. 流覽範例

本文說明如何使用 .NET 多平臺應用程式 UI （.NET MAUI） IAppInfo 介面，其提供應用程式的相關信息。

介面的預設實作 IAppInfo 可透過 AppInfo.Current 屬性取得。 IAppInfo介面和AppInfo類別都包含在 命名空間中Microsoft.Maui.ApplicationModel。

讀取應用程式資訊

介面 IAppInfo 會公開下列屬性：

下列程式代碼範例示範如何存取其中一些屬性：

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

取得目前的主題

屬性 RequestedTheme 會為您的應用程式提供系統目前要求的主題。 傳回下列其中一個值：

Unspecified 當作業系統沒有特定的使用者介面樣式時，會傳回 。 此情況的其中一個範例，是執行早於 13.0 之 iOS 版本的裝置。

下列程式代碼範例示範如何取得主題：

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

取得版面配置方向

屬性 RequestedLayoutDirection 會提供系統針對您的應用程式所使用的目前版面配置方向。 傳回下列其中一個值：

Unknown 當設定方向未知時，會傳回 。

下列程式代碼範例示範如何取得配置方向：

LayoutDirection layoutDirection = AppInfo.Current.RequestedLayoutDirection;

顯示應用程式設定

類別 IAppInfo 也可以顯示應用程式作業系統所維護的設定頁面：

AppInfo.Current.ShowSettingsUI();

此設定頁面可讓使用者變更應用程式權限，並執行其他平台特定的工作。

平台實作細節

本節說明與 介面相關的 IAppInfo 平臺特定實作詳細數據。

應用程式資訊取自 AndroidManifest.xml 中的下列欄位：

  • BuildString— android:versionCode 在節點中manifest
  • Name— android:label 在節點中application
  • PackageName— package 在節點中manifest
  • VersionString— android:versionName 在節點中manifest

要求的主題

Android 會使用設定模式來指定要向使用者要求的佈景主題類型。 根據 Android 版本，用戶可以變更它，或在啟用省電模式時變更。

您可以在官方的深色佈景主題 Android 文件 \(英文\) 中深入閱讀。