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

Обзор примера

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

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

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

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

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

• Unspecified
• Light
• Dark

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

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

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

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

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

• Unknown
• LeftToRight
• RightToLeft

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

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

LayoutDirection layoutDirection = AppInfo.Current.RequestedLayoutDirection;

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

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

AppInfo.Current.ShowSettingsUI();

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

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

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