À partir du 27 mars 2025, nous vous recommandons d'utiliser android-latest-release
au lieu de aosp-main
pour créer et contribuer à AOSP. Pour en savoir plus, consultez la section Modifications apportées à AOSP.
Aperçu
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Une AppCard est un regroupement d'éléments d'interface utilisateur dont le style est contrôlé par l'OEM et qui sont remplis avec des informations fournies par les applications. Les AppCards affichent les données et fonctionnalités les plus pertinentes d'une application aux utilisateurs de manière accessible et toujours disponible.

Figure 1 : Composants AppCard.
Les développeurs tiers peuvent utiliser les cartes d'application pour :
- Afficher l'état d'une commande de plats à emporter à un livreur en route.
- Affichez des photos aux passagers dans les véhicules pour créer une ambiance agréable.
- Suivez et mettez à jour régulièrement le prix des cryptomonnaies pour les investisseurs.
Exemples :

Figure 2. Exemples d'AppCard.
AppCard
Source : AppCard.kt
Une AppCard est un objet qui contient des données. Nous acceptons un ImageAppCard
à deux états. Lorsque vous définissez un type d'AppCard, chaque composant doit avoir un ID unique.
Figure 3. Image avec du texte.
|
Figure 4. Barre de progression et boutons avec du texte.
|
AppCard ContentProvider
Source : AppCardContentProvider.kt
Fournisseur de contenu qui existe dans une application, crée des AppCards, et est instancié et communique avec AppCardHost
. Pour en savoir plus, consultez AppCardContentProviderExtension.
Hôte AppCard
Source : AppCardHost.kt
Application système qui se connecte à AppCardContentProvider
pour afficher et gérer les cartes d'applications. Pour en savoir plus, consultez Configurer un hôte AppCard.
Contexte AppCard
Source : AppCardContext.kt
Objet qui fournit des indications à un AppCardContentProvider
sur la façon dont un AppCardHost
peut afficher une AppCard. AppCardContext
contient les informations suivantes :
- Niveau d'API
Période d'actualisation pour :
- Mises à jour complètes d'AppCard
- Composants AppCard tagués avec
EnforceFastUpdateRate
L'hôte doit-il prendre en charge les interactions avec AppCard ?
Taille maximale de l'image :
- Centrer l'image
- Image du bouton
- Image d'en-tête
Nombre minimal de boutons à afficher.
Ces informations permettent aux développeurs AppCard d'optimiser les informations envoyées aux hôtes.
Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la Licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/27 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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."]]