アプリ情報

  • [アーティクル]

Browse sample. サンプルを参照する

この記事では、アプリケーションに関する情報を提供する .NET マルチプラットフォーム アプリ UI (.NET MAUI) IAppInfo インターフェイスの使用方法について説明します。

IAppInfo インターフェイスの既定の実装は、AppInfo.Current プロパティを通じて利用できます。 IAppInfo インターフェイスと AppInfo クラスは、どちらも Microsoft.Maui.ApplicationModel 名前空間に含まれています。

アプリ情報を読む

IAppInfo インターフェイスは次のプロパティを公開します。

  • Name - アプリケーション名。
  • PackageName - パッケージ名またはアプリケーション識別子 (com.microsoft.myapp など)。
  • VersionString - アプリケーションのバージョン (1.0.0 など)。
  • Version - Version オブジェクトとしてのアプリケーションのバージョン
  • BuildString - バージョンのビルド番号 (1000 など)。
  • RequestedTheme - システムまたはアプリケーションの検出されたテーマ。
  • PackagingModel - アプリケーションのパッケージ化モデル。
  • RequestedLayoutDirection - システムまたはアプリケーションの要求されたレイアウト方向。

次のコード例は、これらのプロパティの一部にアクセスする方法を示しています。

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 - manifest ノード内の android:versionCode
  • Name - application ノード内の android:label
  • PackageName - manifest ノード内の package
  • VersionString - manifest ノード内の android:versionName

要求されたテーマ

Android では、要求するテーマの種類を指定するために、ユーザーからの構成モードが使用されます。 Android のバージョンに基づいて、ユーザーが変更することもできれば、バッテリー セーバー モードが有効になっているときに変更されることもあります。

詳細については、公式のダーク テーマに関する Android ドキュメントを参照してください。