Informations sur l’application

Parcourir l'exemple. 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 propriété AppInfo.Current. L'interface IAppInfo et la classe AppInfo sont contenues dans l'espace de noms Microsoft.Maui.ApplicationModel.

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. 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 l'orientation 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 comment obtenir l’orientation du layout :

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 modifier les autorisations d’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 l'AndroidManifest.xmlpour 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 les 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é.

Vous pouvez en savoir plus sur la documentation Android officielle pour Dark Theme.

  • Last updated on