A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.
Visão geral
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Um AppCard é um agrupamento de elementos de interface com estilo controlado pelo OEM e preenchido com informações fornecidas por apps. Os AppCards mostram os dados e funcionalidades mais relevantes de um app para os usuários de uma forma acessível e sempre disponível.
Figura 1. Componentes AppCard.
Os desenvolvedores terceirizados podem usar os AppCards para:
- Mostrar o status de um pedido de comida para viagem a um motorista durante o trajeto.
- Mostre fotos para os passageiros em veículos e crie um ambiente agradável.
- Acompanhe e atualize periodicamente o preço das criptomoedas para investidores.
Por exemplo:
Figura 2. Exemplos de AppCard.
AppCard
Fonte: AppCard.kt
Um AppCard é um objeto que contém dados. Oferecemos suporte a um ImageAppCard com dois estados. Ao definir qualquer tipo de AppCard, cada componente precisa ter um
ID exclusivo.
Figura 3. Imagem com texto.
|
Figura 4. Barra de progresso e botões com texto.
|
ContentProvider do AppCard
Fonte: AppCardContentProvider.kt
Um provedor de conteúdo que existe em um app, cria AppCards e é instanciado
e se comunica com AppCardHost. Para saber mais, consulte
AppCardContentProviderExtension.
Host do AppCard
Fonte: AppCardHost.kt
Um app do sistema que se conecta a AppCardContentProviders para mostrar e gerenciar
cards de apps. Para saber mais, consulte Configurar um host do AppCard.
Contexto do AppCard
Fonte: AppCardContext.kt
Um objeto que fornece dicas a um AppCardContentProvider sobre como um
AppCardHost pode mostrar um AppCard. AppCardContext contém estas informações:
- Nível da API
Período de atualização para:
- Concluir atualizações do AppCard
- Componentes AppCard marcados com
EnforceFastUpdateRate
O host oferece suporte a interações com o AppCard?
Tamanho máximo da imagem:
- Centralizar imagem
- Imagem do botão
- Imagem de cabeçalho
Número mínimo de botões que devem ser mostrados.
Essas informações permitem que os desenvolvedores do AppCard otimizem as informações enviadas aos
hosts.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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."]]
