از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
نمای کلی
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
AppCard گروه‌بندی از عناصر UI با سبکی است که توسط OEM کنترل می‌شود و با اطلاعات ارائه‌شده توسط برنامه‌ها پر شده است. AppCardها مرتبط ترین داده ها و عملکرد یک برنامه را به گونه ای به کاربران نمایش می دهند که در دسترس و همیشه در دسترس باشد.
شکل 1. اجزای AppCard.
توسعه دهندگان شخص ثالث می توانند از AppCards برای موارد زیر استفاده کنند:
- نمایش وضعیت سفارش غذای بیرون‌بر به راننده در حین مسیر.
- عکس‌ها را به مسافران در وسایل نقلیه نشان دهید تا محیطی دلپذیر ایجاد شود.
- قیمت سکه های کریپتو را برای سرمایه گذاران پیگیری و به طور دوره ای به روز کنید.
مثالها عبارتند از:
شکل 2. نمونه های AppCard.
اپ کارت
منبع: AppCard.kt
AppCard شیئی است که داده ها را نگه می دارد. ما از ImageAppCard پشتیبانی می کنیم که دارای دو حالت است. هنگام تعریف هر نوع AppCard، هر جزء باید یک شناسه منحصر به فرد داشته باشد.
 شکل 3. تصویر با متن. |  شکل 4. نوار پیشرفت و دکمه های متنی. |
AppCard Content Provider
منبع: AppCardContentProvider.kt
ارائه‌دهنده محتوایی که در یک برنامه وجود دارد، AppCardها را ایجاد می‌کند و نمونه‌سازی می‌شود و با AppCardHost ارتباط برقرار می‌کند. برای کسب اطلاعات بیشتر، AppCardContentProviderExtension را ببینید.
میزبان AppCard
منبع: AppCardHost.kt
یک برنامه سیستمی که برای نمایش و مدیریت App Cards به AppCardContentProvider (ها) متصل می شود. برای کسب اطلاعات بیشتر، به پیکربندی میزبان AppCard مراجعه کنید.
زمینه AppCard
منبع: AppCardContext.kt
شیئی که به AppCardContentProvider راهنمایی می کند که چگونه AppCardHost ممکن است AppCard را نمایش دهد. AppCardContext حاوی این اطلاعات است:
این اطلاعات به توسعه دهندگان AppCard اجازه می دهد تا اطلاعات ارسال شده به هاست را بهینه کنند.
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],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."]]
