Informasi aplikasi

Telusuri sampel

Artikel ini menjelaskan bagaimana Anda dapat menggunakan antarmuka .NET Multi-platform App UI (.NET MAUI), IAppInfo yang menyediakan informasi tentang aplikasi Anda.

Implementasi IAppInfo default antarmuka tersedia melalui AppInfo.Current properti . IAppInfo Antarmuka dan AppInfo kelas terkandung dalam Microsoft.Maui.ApplicationModel namespace layanan.

Membaca informasi aplikasi

Antarmuka IAppInfo mengekspos properti berikut:

• Name — Nama aplikasi.
• PackageName — Nama paket atau pengidentifikasi aplikasi, seperti com.microsoft.myapp.
• VersionString — Versi aplikasi, seperti 1.0.0.
• Version — Versi aplikasi, sebagai Version objek.
• BuildString — Nomor build versi, seperti 1000.
• RequestedTheme — Tema sistem atau aplikasi yang terdeteksi.
• PackagingModel — Model pengemasan aplikasi.
• RequestedLayoutDirection — Arah tata letak sistem atau aplikasi yang diminta.

Contoh kode berikut menunjukkan akses ke beberapa properti ini:

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

Dapatkan tema saat ini

Properti RequestedTheme menyediakan tema yang diminta saat ini oleh sistem untuk aplikasi Anda. Salah satu nilai berikut dikembalikan:

• Unspecified
• Light
• Dark

Unspecified dikembalikan ketika sistem operasi tidak memiliki gaya antarmuka pengguna tertentu. Contohnya ada di perangkat yang menjalankan versi iOS yang lebih lama dari 13.0.

Contoh kode berikut menunjukkan mendapatkan tema:

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

Mendapatkan arah tata letak

Properti RequestedLayoutDirection menyediakan arah tata letak saat ini yang digunakan oleh sistem untuk aplikasi Anda. Salah satu nilai berikut dikembalikan:

• Unknown
• LeftToRight
• RightToLeft

Unknown dikembalikan ketika arah tata letak tidak diketahui.

Contoh kode berikut menunjukkan mendapatkan arah tata letak:

LayoutDirection layoutDirection = AppInfo.Current.RequestedLayoutDirection;

Menampilkan pengaturan aplikasi

Kelas IAppInfo juga dapat menampilkan halaman pengaturan yang dikelola oleh sistem operasi untuk aplikasi:

AppInfo.Current.ShowSettingsUI();

Halaman pengaturan ini memungkinkan pengguna mengubah izin aplikasi dan melakukan tugas khusus platform lainnya.

Spesifikasi implementasi platform

Bagian ini menjelaskan detail implementasi khusus platform yang IAppInfo terkait dengan antarmuka.

Android

Informasi aplikasi diambil dari AndroidManifest.xml untuk bidang berikut:

• BuildString — android:versionCode dalam manifest simpul
• Name— android:label dalam simpul application
• PackageName— package dalam simpul manifest
• VersionString— android:versionName dalam simpul manifest

Tema yang diminta

Android menggunakan mode konfigurasi untuk menentukan jenis tema yang akan diminta dari pengguna. Berdasarkan versi Android, dapat diubah oleh pengguna atau dapat diubah saat mode penghemat baterai diaktifkan.

Anda dapat membaca lebih lanjut tentang dokumentasi Android resmi untuk Dark Theme.

Katalis iOS/Mac

Informasi aplikasi diambil dari Info.plist untuk bidang berikut:

• BuildString — CFBundleVersion
• Name — CFBundleDisplayName jika diatur, lainnya CFBundleName
• PackageName — CFBundleIdentifier
• VersionString — CFBundleShortVersionString

Tema yang diminta

Tidak ditentukan selalu dikembalikan pada versi iOS yang lebih lama dari 13.0

Windows

Informasi aplikasi diambil dari Package.appxmanifest untuk bidang berikut:

• BuildString— Menggunakan Build dari pada Version node Identity
• Name— DisplayName pada simpul Properties
• PackageName— Name pada simpul Identity
• VersionString— Version pada simpul Identity

Tema yang diminta

Kode yang mengakses IAppInfo.RequestedTheme properti harus dipanggil pada utas UI atau pengecualian akan dilemparkan.

Aplikasi Windows menghormati RequestedTheme pengaturan properti di Windows App.xaml. Jika diatur ke tema tertentu, API ini selalu mengembalikan pengaturan ini. Untuk menggunakan tema dinamis OS, hapus properti ini dari aplikasi Anda. Saat aplikasi Anda dijalankan, aplikasi mengembalikan tema yang ditetapkan oleh pengguna di pengaturan Windows: Pengaturan> WarnaPersonalisasi>>Pilih mode aplikasi default Anda.