Informacje o aplikacji
W tym artykule opisano sposób używania interfejsu użytkownika aplikacji wieloplatformowej platformy .NET (.NET MAUI IAppInfo ), który zawiera informacje o aplikacji.
Domyślna implementacja interfejsu IAppInfo
jest dostępna za pośrednictwem AppInfo.Current właściwości . Zarówno interfejs, jak IAppInfo
i AppInfo
klasa są zawarte w Microsoft.Maui.ApplicationModel
przestrzeni nazw.
Odczytywanie informacji o aplikacji
Interfejs IAppInfo
uwidacznia następujące właściwości:
- Name — nazwa aplikacji.
- PackageName — nazwa pakietu lub identyfikator aplikacji, taki jak
com.microsoft.myapp
. - VersionString — wersja aplikacji, taka jak
1.0.0
. - Version — wersja aplikacji jako Version obiekt.
- BuildString — numer kompilacji wersji, taki jak
1000
. - RequestedTheme — wykryty motyw systemu lub aplikacji.
- PackagingModel — model pakowania aplikacji.
- RequestedLayoutDirection — żądany kierunek układu systemu lub aplikacji.
W poniższym przykładzie kodu pokazano, jak uzyskać dostęp do niektórych z tych właściwości:
string name = AppInfo.Current.Name;
string package = AppInfo.Current.PackageName;
string version = AppInfo.Current.VersionString;
string build = AppInfo.Current.BuildString;
Pobieranie bieżącego motywu
Właściwość RequestedTheme udostępnia bieżący żądany motyw przez system dla aplikacji. Zwracana jest jedna z następujących wartości:
Unspecified
jest zwracany, gdy system operacyjny nie ma określonego stylu interfejsu użytkownika. Przykładem jest to na urządzeniach z systemem iOS starszym niż 13.0.
W poniższym przykładzie kodu pokazano pobieranie motywu:
ThemeInfoLabel.Text = AppInfo.Current.RequestedTheme switch
{
AppTheme.Dark => "Dark theme",
AppTheme.Light => "Light theme",
_ => "Unknown"
};
Pobieranie kierunku układu
Właściwość RequestedLayoutDirection zapewnia bieżący kierunek układu używany przez system dla aplikacji. Zwracana jest jedna z następujących wartości:
Unknown
jest zwracany, gdy kierunek układu jest nieznany.
W poniższym przykładzie kodu pokazano, jak uzyskać kierunek układu:
LayoutDirection layoutDirection = AppInfo.Current.RequestedLayoutDirection;
Wyświetlanie ustawień aplikacji
Klasa IAppInfo może również wyświetlić stronę ustawień obsługiwanych przez system operacyjny dla aplikacji:
AppInfo.Current.ShowSettingsUI();
Ta strona ustawień umożliwia użytkownikowi zmianę uprawnień aplikacji i wykonywanie innych zadań specyficznych dla platformy.
Specyfiki implementacji platformy
W tej sekcji opisano szczegóły implementacji specyficzne dla platformy związane z interfejsem IAppInfo .
Informacje o aplikacji są pobierane z pliku AndroidManifest.xml dla następujących pól:
- BuildString—
android:versionCode
w węźlemanifest
- Name—
android:label
w węźleapplication
- PackageName—
package
w węźlemanifest
- VersionString—
android:versionName
w węźlemanifest
Żądany motyw
System Android używa trybów konfiguracji, aby określić typ motywu do żądania od użytkownika. Na podstawie wersji systemu Android można ją zmienić przez użytkownika lub zmienić po włączeniu trybu oszczędzania baterii.
Więcej informacji można uzyskać w oficjalnej dokumentacji systemu Android dotyczącej motywu ciemnego.