החל מ-27 במרץ 2025, מומלץ להשתמש ב-android-latest-release
במקום ב-aosp-main
כדי ליצור תרומות ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.
סקירה כללית
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
AppCard הוא קיבוץ של רכיבי ממשק משתמש עם סגנון שנקבע על ידי יצרן הציוד המקורי, ומאוכלס במידע שמסופק על ידי אפליקציות. כרטיסי האפליקציות מציגים למשתמשים את הנתונים והפונקציונליות הרלוונטיים ביותר של האפליקציה בצורה נגישה וזמינה תמיד.

איור 1. רכיבי AppCard.
מפתחים של צד שלישי יכולים להשתמש בכרטיסי אפליקציה כדי:
- הצגת הסטטוס של הזמנת אוכל במשלוח לנהג בזמן הנסיעה.
- הצגת תמונות לנוסעים בכלי רכב כדי ליצור אווירה נעימה.
- לעקוב אחרי המחיר של מטבעות קריפטו ולעדכן אותו מעת לעת עבור משקיעים.
דוגמאות:

איור 2. דוגמאות לכרטיסי אפליקציות.
AppCard
מקור: AppCard.kt
כרטיס אפליקציה הוא אובייקט שמכיל נתונים. אנחנו תומכים בערך ImageAppCard
, שיש לו שני מצבים. כשמגדירים כרטיס אפליקציה מכל סוג, לכל רכיב צריך להיות מזהה ייחודי.
איור 3. תמונה עם טקסט.
|
איור 4. סרגל התקדמות ולחצנים עם טקסט.
|
AppCard ContentProvider
מקור: AppCardContentProvider.kt
ספק תוכן שקיים באפליקציה, יוצר כרטיסי אפליקציה, מופעל ומתקשר עם AppCardHost
. מידע נוסף זמין במאמר בנושא AppCardContentProviderExtension.
AppCard Host
מקור: AppCardHost.kt
אפליקציית מערכת שמתחברת ל-AppCardContentProvider
כדי להציג ולנהל כרטיסי אפליקציה. למידע נוסף, ראו הגדרת מארח של כרטיס אפליקציה.
הקשר של כרטיס האפליקציה
מקור: AppCardContext.kt
אובייקט שמספק רמזים ל-AppCardContentProvider
לגבי האופן שבו AppCardHost
עשוי להציג כרטיס אפליקציה. AppCardContext
מכיל את המידע הבא:
המידע הזה מאפשר למפתחים של AppCard לבצע אופטימיזציה של המידע שנשלח למארחים.
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון UTC).
[[["התוכן קל להבנה","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-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."]]