Прочитать на английском

Поделиться через

Сведения о приложении

  • Статья

Browse sample. Обзор примера

В этой статье описывается, как использовать интерфейс пользовательского интерфейса приложений .NET (.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 — запрошенное направление макета системы или приложения.

В следующем примере кода показано, как получить доступ к некоторым из этих свойств:

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

Получение текущей темы

Свойство RequestedTheme предоставляет текущую запрошенную тему системой для приложения. Возвращается одно из следующих значений:

Unspecified возвращается, если операционная система не имеет определенного стиля пользовательского интерфейса. Например, на устройствах под управлением iOS более поздних версий, чем 13.0.

В следующем примере кода показано, как получить тему:

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

Получение направления макета

Свойство RequestedLayoutDirection предоставляет текущее направление макета, используемое системой для приложения. Возвращается одно из следующих значений:

Unknown возвращается, когда направление макета неизвестно.

В следующем примере кода показано, как получить направление макета:

C# 
LayoutDirection layoutDirection = AppInfo.Current.RequestedLayoutDirection;

Отображение параметров приложения

Класс IAppInfo также может отображать страницу параметров, поддерживаемых операционной системой для приложения:

C# 
AppInfo.Current.ShowSettingsUI();

На этой странице параметров пользователь может изменять разрешения приложения и выполнять другие задачи для платформы.

Особенности реализации платформы

В этом разделе описываются сведения о реализации для конкретной платформы, связанные с интерфейсом IAppInfo .

Сведения о приложении взяты из AndroidManifest.xml для следующих полей:

  • BuildString — android:versionCode в manifest узле
  • Name — android:label в application узле
  • PackageName — package в manifest узле
  • VersionString — android:versionName в manifest узле

Запрошенная тема

В Android используются режимы конфигурации для указания типа темы, запрашиваемой у пользователя. В зависимости от версии Android он может быть изменен пользователем или может быть изменен при включении режима экономии батареи.

Дополнительные сведения о темной теме для Android см. здесь.