A partir del 27 de marzo de 2025, te recomendamos que uses android-latest-release en lugar de aosp-main para compilar y contribuir a AOSP. Para obtener más información, consulta Cambios en AOSP.
Descripción general
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Una AppCard es una agrupación de elementos de la IU con un diseño controlado por el OEM y que se completa con la información que proporcionan las apps. Las AppCards muestran los datos y las funcionalidades más relevantes de una app a los usuarios de una manera accesible y siempre disponible.
Figura 1: Son los componentes de AppCard.
Los desarrolladores externos pueden usar las tarjetas de apps para hacer lo siguiente:
- Mostrar el estado de un pedido de comida para llevar a un conductor mientras está en camino
- Mostrar fotos a los pasajeros en los vehículos para crear un ambiente agradable
- Hacer un seguimiento del precio de las criptomonedas y actualizarlo periódicamente para los inversores
Los siguientes son algunos ejemplos:
Figura 2: Ejemplos de AppCard.
AppCard
Fuente: AppCard.kt
Una AppCard es un objeto que contiene datos. Admitimos un ImageAppCard que tiene dos estados. Cuando se define cualquier tipo de AppCard, cada componente debe tener un ID único.
Figura 3: Imagen con texto.
|
Figura 4: Barra de progreso y botones con texto.
|
ContentProvider de AppCard
Fuente: AppCardContentProvider.kt
Es un proveedor de contenido que existe en una app, crea AppCards, se instancia y se comunica con AppCardHost. Para obtener más información, consulta AppCardContentProviderExtension.
Host de AppCard
Fuente: AppCardHost.kt
Es una app del sistema que se conecta a AppCardContentProvider para mostrar y administrar tarjetas de apps. Para obtener más información, consulta Cómo configurar un host de AppCard.
Contexto de AppCard
Fuente: AppCardContext.kt
Es un objeto que proporciona sugerencias a un AppCardContentProvider sobre cómo un AppCardHost podría mostrar una AppCard. AppCardContext contiene la siguiente información:
- Nivel de API
Período de actualización para:
- Actualizaciones completas de AppCard
- Componentes de AppCard etiquetados con
EnforceFastUpdateRate
¿Es el host que admite interacciones con AppCard?
Tamaño máximo de la imagen:
- Imagen central
- Imagen del botón
- Imagen del encabezado
Es la cantidad mínima de botones que se espera que se muestren.
Esta información permite que los desarrolladores de AppCard optimicen la información que se envía a los hosts.
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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."]]
