A partire dal 27 marzo 2025, ti consigliamo di utilizzare android-latest-release
anziché aosp-main
per compilare e contribuire ad AOSP. Per ulteriori informazioni, vedi Modifiche ad AOSP.
Panoramica
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Una scheda dell'app è un raggruppamento di elementi dell'interfaccia utente con stile controllato dall'OEM e compilato con le informazioni fornite dalle app. Le schede dell'app mostrano agli utenti i dati e le funzionalità più pertinenti di un'app in modo accessibile e sempre disponibile.

Figura 1. Componenti di AppCard.
Gli sviluppatori di terze parti possono utilizzare le schede di app per:
- Mostrare lo stato di un ordine di cibo da asporto a un conducente durante il viaggio.
- Mostrare foto ai passeggeri dei veicoli per creare un'atmosfera piacevole.
- Monitora e aggiorna periodicamente il prezzo delle criptovalute per gli investitori.
Ecco alcuni esempi:

Figura 2. Esempi di AppCard.
AppCard
Fonte: AppCard.kt
Una scheda dell'app è un oggetto che contiene dati. Supportiamo un ImageAppCard
con due stati. Quando definisci qualsiasi tipo di scheda dell'app, ogni componente deve avere un ID univoco.
Figura 3. Immagine con testo.
|
Figura 4. Barra di avanzamento e pulsanti con testo.
|
ContentProvider AppCard
Fonte: AppCardContentProvider.kt
Un fornitore di contenuti esistente in un'app, che crea schede di app, viene creato e comunica con AppCardHost
. Per scoprire di più, consulta
AppCardContentProviderExtension.
Host AppCard
Fonte: AppCardHost.kt
Un'app di sistema che si connette a uno o più AppCardContentProvider
per visualizzare e gestire le schede di app. Per scoprire di più, consulta Configurare un host AppCard.
Contesto AppCard
Fonte: AppCardContext.kt
Un oggetto che fornisce suggerimenti a un AppCardContentProvider
su come un
AppCardHost
potrebbe visualizzare una scheda dell'app. AppCardContext
contiene queste informazioni:
- Livello API
Periodo di aggiornamento per:
- Completare gli aggiornamenti di AppCard
- Componenti AppCard taggati con
EnforceFastUpdateRate
L'host supporta le interazioni con AppCard?
Dimensioni massime delle immagini:
- Immagine al centro
- Immagine del pulsante
- Immagine intestazione
Numero minimo di pulsanti che si prevede di visualizzare.
Queste informazioni consentono agli sviluppatori di AppCard di ottimizzare le informazioni inviate agli host.
I campioni di contenuti e codice in questa pagina sono soggetti alle licenze descritte nella Licenza per i contenuti. Java e OpenJDK sono marchi o marchi registrati di Oracle e/o delle sue società consociate.
Ultimo aggiornamento 2025-07-27 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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."]]