Mulai 27 Maret 2025, sebaiknya gunakan android-latest-release
, bukan aosp-main
, untuk mem-build dan berkontribusi pada AOSP. Untuk mengetahui informasi selengkapnya, lihat Perubahan pada AOSP.
Ringkasan
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
AppCard adalah pengelompokan elemen UI dengan gaya yang dikontrol oleh OEM, dan diisi dengan informasi yang diberikan oleh aplikasi. Kartu Aplikasi menampilkan data dan fungsi aplikasi yang paling relevan kepada pengguna dengan cara yang dapat diakses dan selalu tersedia.

Gambar 1. Komponen AppCard.
Developer pihak ketiga dapat menggunakan Kartu Aplikasi untuk:
- Menampilkan status pesanan makanan pesan bawa pulang kepada pengemudi saat dalam perjalanan.
- Menampilkan foto kepada penumpang di dalam kendaraan untuk menciptakan suasana yang menyenangkan.
- Melacak dan memperbarui harga koin kripto secara berkala untuk investor.
Contohnya mencakup:

Gambar 2. Contoh AppCard.
AppCard
Sumber: AppCard.kt
AppCard adalah objek yang menyimpan data. Kami mendukung ImageAppCard
, yang memiliki
dua status. Saat menentukan jenis AppCard apa pun, setiap komponen harus memiliki
ID unik.
Gambar 3. Gambar dengan teks.
|
Gambar 4. Status progres dan tombol dengan teks.
|
AppCard ContentProvider
Sumber: AppCardContentProvider.kt
Penyedia konten yang ada di aplikasi, membuat AppCard, serta di-instance
dan berkomunikasi dengan AppCardHost
. Untuk mempelajari lebih lanjut, lihat
AppCardContentProviderExtension.
Host AppCard
Sumber: AppCardHost.kt
Aplikasi sistem yang terhubung ke AppCardContentProvider
untuk menampilkan dan mengelola Kartu Aplikasi. Untuk mempelajari lebih lanjut, lihat Mengonfigurasi host AppCard.
Konteks AppCard
Sumber: AppCardContext.kt
Objek yang memberikan petunjuk ke AppCardContentProvider
tentang cara
AppCardHost
dapat menampilkan AppCard. AppCardContext
berisi informasi ini:
Dengan informasi ini, developer AppCard dapat mengoptimalkan informasi yang dikirim ke host.
Konten dan contoh kode di halaman ini tunduk kepada lisensi yang dijelaskan dalam Lisensi Konten. Java dan OpenJDK adalah merek dagang atau merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-27 UTC.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-07-27 UTC."],[],[],null,["# Overview\n\nAn *AppCard* is a grouping of UI elements with styling controlled by the OEM,\nand populated with information provided by apps. AppCards display an app's most\nrelevant data and functionality to users in a way that is accessible and always\navailable.\n\n**Figure 1.** AppCard components.\n\nThird-party developers can use AppCards to:\n\n- Display the status of a takeout food order to a driver while en route.\n- Show photos to passengers in vehicles to form a pleasant ambiance.\n- Track and periodically update the price of crypto coins for investors.\n\nExamples include:\n\n**Figure 2.** AppCard examples.\n\nAppCard\n-------\n\n**Source:** [`AppCard.kt`](https://android.googlesource.com/platform/packages/apps/Car/libs/+/refs/tags/ub-automotive-master-20250418/car-app-card-lib/app-card/src/main/java/com/android/car/appcard/AppCard.kt)\n\nAn AppCard is an object that holds data. We support an `ImageAppCard`, that has\ntwo states. When defining any type of AppCard, each component must have a\nunique ID.\n\n|--------------------------------|---------------------------------------------------|\n| **Figure 3.** Image with text. | **Figure 4.** Progress bar and buttons with text. |\n\nAppCard ContentProvider\n-----------------------\n\n**Source:** [`AppCardContentProvider.kt`](https://android.googlesource.com/platform/packages/apps/Car/libs/+/refs/tags/ub-automotive-master-20250418/car-app-card-lib/app-card/src/main/java/com/android/car/appcard/AppCardContentProvider.kt)\n\nA content provider that exists in an app, creates AppCards, and is instantiated\nand communicates with `AppCardHost`. To learn more, see\n[AppCardContentProviderExtension](/docs/automotive/unbundled_apps/appcards/appcard#override).\n\nAppCard Host\n------------\n\n**Source:** [`AppCardHost.kt`](https://android.googlesource.com/platform/packages/apps/Car/libs/+/refs/tags/ub-automotive-master-20250418/car-app-card-host-lib/app-card-host/src/main/java/com/android/car/appcard/host/AppCardHost.kt)\n\nA system app that connects to `AppCardContentProvider`(s) to display and manage\nApp Cards. To learn more, see [Configure an AppCard host](/docs/automotive/unbundled_apps/appcards/host).\n\nAppCard Context\n---------------\n\n**Source:** [`AppCardContext.kt`](https://android.googlesource.com/platform/packages/apps/Car/libs/+/refs/tags/ub-automotive-master-20250418/car-app-card-lib/app-card/src/main/java/com/android/car/appcard/AppCardContext.kt)\n\nAn object that provides hints to an `AppCardContentProvider` about how an\n`AppCardHost` might display an AppCard. `AppCardContext` contains this\ninformation:\n\n- API level\n- Refresh period for:\n\n - Complete AppCard updates\n - AppCard components tagged with `EnforceFastUpdateRate`\n- Is the host to support interactions with AppCard?\n\n- Maximum image size:\n\n - Center image\n - Button image\n - Header image\n- Minimum number of buttons expected to be displayed.\n\nThis information allows AppCard developers to optimize the information sent to\nhosts."]]