Partager via

Informations sur l’application

  • Article

Browse sample. Parcourir l’exemple

Cet article explique comment utiliser l’interface utilisateur de l’application multiplateforme .NET (.NET MAUI), IAppInfo qui fournit des informations sur votre application.

L’implémentation par défaut de l’interface IAppInfo est disponible via la AppInfo.Current propriété. L’interface et AppInfo la IAppInfo classe sont contenues dans l’espace Microsoft.Maui.ApplicationModel de noms.

Lire les informations de l’application

L’interface IAppInfo expose les propriétés suivantes :

  • Name — Nom de l’application.
  • PackageName — Nom du package ou identificateur d’application, tel que com.microsoft.myapp.
  • VersionString — Version de l’application, telle que 1.0.0.
  • Version — Version de l’application, en tant qu’objet Version .
  • BuildString — Numéro de build de la version, tel que 1000.
  • RequestedTheme — Thème détecté du système ou de l’application.
  • PackagingModel — Modèle d’empaquetage de l’application.
  • RequestedLayoutDirection — Direction de disposition demandée du système ou de l’application.

L’exemple de code suivant illustre l’accès à certaines de ces propriétés :

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

Obtenir le thème actuel

La RequestedTheme propriété fournit le thème demandé actuel par le système pour votre application. L’une des valeurs suivantes est retournée :

Unspecified est retourné lorsque le système d’exploitation n’a pas de style d’interface utilisateur spécifique. C’est le cas, par exemple, sur les appareils exécutant des versions d’iOS antérieures à 13.0.

L’exemple de code suivant illustre l’obtention du thème :

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

Obtenir le sens de la disposition

La RequestedLayoutDirection propriété fournit la direction de disposition actuelle utilisée par le système pour votre application. L’une des valeurs suivantes est retournée :

Unknown est retourné lorsque la direction de la disposition est inconnue.

L’exemple de code suivant illustre l’obtention de la direction de la disposition :

LayoutDirection layoutDirection = AppInfo.Current.RequestedLayoutDirection;

Afficher les paramètres de l’application

La IAppInfo classe peut également afficher une page des paramètres gérés par le système d’exploitation de l’application :

AppInfo.Current.ShowSettingsUI();

Cette page de paramètres permet à l’utilisateur de changer les autorisations de l’application et d’effectuer d’autres tâches spécifiques à la plateforme.

Spécificités de l’implémentation de la plateforme

Cette section décrit les détails d’implémentation spécifiques à la plateforme liés à l’interface IAppInfo .

Les informations d’application sont extraites de AndroidManifest.xml pour les champs suivants :

  • BuildString — android:versionCode dans le manifest nœud
  • Name — android:label dans le application nœud
  • PackageName — package dans le manifest nœud
  • VersionString — android:versionName dans le manifest nœud

Thème demandé

Android utilise des modes de configuration pour spécifier le type de thème à demander à l’utilisateur. En fonction de la version d’Android, elle peut être modifiée par l’utilisateur ou peut être modifiée lorsque le mode économiseur de batterie est activé.

Pour plus d’informations, consultez la documentation officielle Android sur le thème Sombre.