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.
Note di rilascio della libreria dell'interfaccia utente dell'auto
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina descrive gli aggiornamenti apportati alla libreria dell'interfaccia utente dell'auto in ciascuna delle release elencate di seguito.
car-ui-lib 2.6.0
Nuove funzionalità
- È stato aggiunto un gestore di tocco per il logo
CarUiToolbar
.
Problemi risolti
- È stato risolto un problema per cui i contenuti della finestra di dialogo di overflow di
CarUiToolbar
rimanevano obsoleti quando si eseguivano gli aggiornamenti tramite il plug-in.
- È stato risolto un problema per cui la barra di scorrimento di
CarUiRecyclerView
non era visibile perché erano stati applicati rientramenti errati.
- È stato risolto un problema relativo al ritorno di un valore nullo per
InsetsChangedListener
da parte del plug-in.
- È stato aggiunto un controllo per applicare il criterio "
AppStyledView
non deve utilizzare
Theme.CarUi
" ai contenuti visualizzati in AppStyledView
.
- È stato corretto il posizionamento predefinito di
AppStyledView
nelle schermate orizzontali di grandi dimensioni.
- È stata aggiunta la personalizzazione dello sfondo e dell'intensità dell'effetto sfocatura di
AppStyledView
.
- È stato aggiunto il supporto per le chiamate al numero
AppStyledDialog#setContentView()
dopo la visualizzazione di
AppStyledView
.
Questi metodi sono stati ritirati:
CarUi#installBaseLayoutAround(View, InsetsChangedListener, boolean)
, usa
CarUi#InsetsChangedListener(Context, View, InsetsChangedListener, boolean)
instead.
CarUi#installBaseLayoutAround(View, InsetsChangedListener, boolean,
boolean)
, utilizza CarUi#InsetsChangedListener(Context, View,
InsetsChangedListener, boolean, boolean)
.
car-ui-lib-plugin-apis 1.5.0
Nuove funzionalità
- È stata aggiunta la personalizzazione dell'ascoltatore del tocco del logo
CarUiToolbar
.
Questi elementi sono stati ritirati:
PluginFactoryOEMV6
, utilizza PluginFactoryOEMV7
.
ToolbarControllerOEMV2
, utilizza ToolbarControllerOEMV3
.
car-ui-lib 2.5.1
Problemi risolti
- È stato risolto un problema di ProGuard che impediva il caricamento del plug-in car-ui-lib.
- È stata corretta la compatibilità futura per i plug-in che causano un errore NPE in fase di runtime.
- Impostare il plug-in car-ui-lib come app di sistema.
- È stato corretto il problema per cui la barra di scorrimento non veniva visualizzata in alcuni scenari.
CarUiRecyclerView
- È stato corretto il problema relativo alle schede selezionate che non si aggiornavano quando veniva utilizzato il plug-in.
- Sono stati risolti i problemi relativi all'inizializzazione di
SearchView
quando viene utilizzato il plug-in.
- Inizializza il callback dello stato della limitazione dell'esperienza utente del servizio auto utilizzando il contesto dell'attività per la configurazione corretta del display.
- Annunci di nullità aggiornati.
car-ui-lib 2.5.0
Problemi risolti
- Tempo di avvio del plug-in ottimizzato.
- È stato risolto un problema per cui le app restituivano sempre 1 come versione massima del plug-in supportata.
- È stata rimossa la sovrascrittura del tema per forzare
Theme.CarUi
da AppStyledView
.
- È stato aggiunto un metodo sostituibile per impostare il titolo su
ListPreferenceFragment
.
car-ui-lib-plugin-apis 1.4.0
Nuove funzionalità
- Consenti la personalizzazione OEM di
CarUiPreference
.
Questi elementi sono stati ritirati:
PluginFactoryOEMV5
, utilizza PluginFactoryOEMV6
.
car-ui-lib 2.4.0
Nuove funzionalità
- È stato aggiunto il supporto per la transizione a
AppStyledView
.
Problemi risolti
AppStyledRecyclerViewAdapter
non è più pubblico.
- È stato fornito un metodo di utilità per il contesto con ottimizzazione per
AppStyledDialogController
.
- La definizione di
AppStyledViewNavIcon
è stata spostata in AppStyledDialogController
.
- È stata rimossa la sovrascrittura forzata del tema su
Theme.CarUi
in AppStyledView
.
- Sono state aggiunte transizioni per supportare il rendering delle schermate
AppStyledView
.
- È stato aggiunto
car_ui_recycler_view_no_scrollbar
all'elenco di elementi che possono essere sovrapposti.
- È stata creata una libreria Gradle per
CarUiRecyclerView
espresso ViewActions
e
ViewMatchers
.
- È stato eseguito il refactoring della visualizzazione in stile app per utilizzare
ScrollView
.
car-ui-lib-plugin-apis 1.3.0
Nuove funzionalità
Questi elementi sono stati ritirati:
PluginFactoryOEMV4
, utilizza PluginFactoryOEMV5
.
RecyclerViewOEMV1
, utilizza RecyclerViewOEMV2
.
OnScrollListenerOEMV1
, usa RecyclerViewOEMV2.OnScrollListenerOEMV2
.
car-ui-lib 2.3.0
Nuove funzionalità
È stato aggiunto un nuovo componente:
È stato aggiunto il supporto per i seguenti attributi della barra di scorrimento:
android:fadeScrollbars
android:scrollbars
android:scrollbarThumbVertical
android:scrollbarTrackVertical
android:scrollbarStyle
android:scrollbarFadeDuration
android:verticalScrollbarPosition
android:requiresFadingEdge
Problemi risolti
È stato corretto CarUiRecyclerView
, che non manteneva la posizione al momento della Activity
ricreazione.
È stata risolta l'incompatibilità di serializzazione dei bitmap tra il codice client e il servizio IME.
È stato attivato l'utilizzo di NavHostFragment
con PreferenceFragment
.
car-ui-lib-plugin-apis 1.2.0
Nuove funzionalità
È stato sostituito l'utilizzo delle interfacce java.util.function
con le seguenti interfacce della libreria:
com.android.car.ui.plugin.oemapis.BiConsumer
com.android.car.ui.plugin.oemapis.Consumer
com.android.car.ui.plugin.oemapis.Function
Questi elementi sono stati ritirati:
PluginFactoryOEMV3
, utilizza PluginFactoryOEMV4
.
ToolbarControllerOEMV1
, utilizza ToolbarControllerOEMV2
.
ContentListItemOEMV1
, utilizza ContentListItemOEMV2
.
ImeSearchInterfaceOEMV1
, utilizza ImeSearchInterfaceOEMV2
.
È stata sostituita l'implementazione della libreria delle interfacce di nullità con le implementazioni di androidx.annotations
.
car-ui-lib-plugin-apis 1.1.1
Questa release aggiorna minSdkVersion
a 28.
car-ui-lib 2.2.1
Questa release:
- Presenta
CarUiFooterPreference
- Aggiorna
minSdkVersion
a 28.
car-ui-lib-plugin-apis 1.1.0
Questa release:
- È deprecato
AppStyledViewControllerOEMV1
Presenta AppStyledViewControllerOEMV2
Sono state incorporate le modifiche apportate dal giorno AppStyledViewControllerOEMV1
:
public abstract int getContentAreaHeight();
public abstract int getContentAreaWidth();
PluginFactoryOEMV1
e PluginFactoryOEMV2
sono deprecati
Presenta l'interfaccia PluginFactoryOEMV3
.
car-ui-lib 2.1.0
Questa release:
Aggiunge le API client AppStyledView
:
public int getContentAreaHeight();
public int getContentAreaWidth();
Presenta CarUiPrimarySwitchPreference
Aggiorna il costruttore AppStyledDialogController
in modo che richieda Activity
instead of Context
:
Aggiunge:
public AppStyledDialogController(android.app.Activity);
Funzionalità ritirate:
public AppStyledDialogController(android.content.Context);
car-ui-lib-plugin-apis 1.0.1
Questa release aggiunge annotazioni di nullità.
car-ui-lib-plugin-apis 1.0.0
Questa versione introduce il supporto per le seguenti API dei plug-in car-ui-lib
:
AppStyledViewDialog
CarUiRecyclerView
CarUiToolbar
CarUiListItems
car-ui-lib 2.0.0
Questa versione, disponibile su Google Maven, introduce il supporto del plug-in car-ui-lib
per i seguenti componenti:
AppStyledViewDialog
CarUiRecyclerView
CarUiToolbar
CarUiListItems
car-ui-lib 1.0.0
Questa release è disponibile su AOSP per Android 12 e versioni precedenti e supporta:
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-06-12 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-06-12 UTC."],[],[],null,["# Car UI library release notes\n\nThis page describes updates made to the Car UI library in each of the releases\nlisted below.\n\ncar-ui-lib 2.6.0\n----------------\n\n### New features\n\n- Added a tap listener for the `CarUiToolbar` logo.\n\n### Issues addressed\n\n- Fixed an issue where `CarUiToolbar`'s overflow dialog content would remain stale when making the updates through the plugin.\n- Fixed an issue where `CarUiRecyclerView`'s scrollbar was not visible because incorrect insets were applied.\n- Fixed an issue when the plugin returned a null `InsetsChangedListener`.\n- Added a check to enforce content rendered in `AppStyledView` must not use `Theme.CarUi`.\n- Fixed default `AppStyledView` positioning in large landscape screens.\n- Added customization of `AppStyledView` background and dim amount.\n- Added support for calls to `AppStyledDialog#setContentView()` after `AppStyledView` is shown.\n\nDeprecated these methods:\n\n- `CarUi#installBaseLayoutAround(View, InsetsChangedListener, boolean)`, use `CarUi#InsetsChangedListener(Context, View, InsetsChangedListener, boolean)` instead.\n- `CarUi#installBaseLayoutAround(View, InsetsChangedListener, boolean,\n boolean)`, use `CarUi#InsetsChangedListener(Context, View,\n InsetsChangedListener, boolean, boolean)` instead.\n\ncar-ui-lib-plugin-apis 1.5.0\n----------------------------\n\n### New features\n\n- Added customization of `CarUiToolbar` logo tap listener.\n\nDeprecated these items:\n\n- `PluginFactoryOEMV6`, use `PluginFactoryOEMV7` instead.\n- `ToolbarControllerOEMV2`, use `ToolbarControllerOEMV3` instead.\n\ncar-ui-lib 2.5.1\n----------------\n\n### Issues addressed\n\n- Fixed a ProGuard issue that was preventing loading the car-ui-lib plugin.\n- Fixed forward compatibility for plugins that would cause NPE at runtime.\n- Enforce that car-ui-lib plugin has to be a system app.\n- Fixed `CarUiRecyclerView` not showing scrollbar in some scenarios.\n- Fixed selected tabs not updating when the plugin is used.\n- Fixed issues with instantiating `SearchView` when the plugin is used.\n- Initialize Car service UX restriction state callback using Activity context for correct display configuration.\n- Updated nullness annotations.\n\ncar-ui-lib 2.5.0\n----------------\n\n### Issues addressed\n\n- Optimized plugin startup time.\n- Fixed an issue where apps were always returning 1 as max supported plugin version.\n- Removed the overwriting of theme to force `Theme.CarUi` from `AppStyledView`.\n- Added overridable method to set title on `ListPreferenceFragment`.\n\ncar-ui-lib-plugin-apis 1.4.0\n----------------------------\n\n### New features\n\n- Allow OEM customization of `CarUiPreference`.\n\nDeprecated these items:\n\n- `PluginFactoryOEMV5`, use `PluginFactoryOEMV6` instead.\n\ncar-ui-lib 2.4.0\n----------------\n\n### New features\n\n- Added support for the transition to `AppStyledView`.\n\n### Issues addressed\n\n- Updated `AppStyledRecyclerViewAdapter` to no longer be public.\n- Provided a convenience method for context with optimization for `AppStyledDialogController`.\n- Moved the `AppStyledViewNavIcon` definition to `AppStyledDialogController`.\n- Removed forced overwriting of theme to `Theme.CarUi` in `AppStyledView`.\n- Added transitions to support the rendering of `AppStyledView` screens.\n- Added `car_ui_recycler_view_no_scrollbar` to the list of items that can be overlaid.\n- Created a Gradle library for `CarUiRecyclerView` espresso `ViewActions` and `ViewMatchers`.\n- Refactored the app-styled view to use `ScrollView`.\n\ncar-ui-lib-plugin-apis 1.3.0\n----------------------------\n\n### New features\n\nDeprecated these items:\n\n- `PluginFactoryOEMV4`, use `PluginFactoryOEMV5` instead.\n- `RecyclerViewOEMV1`, use `RecyclerViewOEMV2` instead.\n- `OnScrollListenerOEMV1`, use `RecyclerViewOEMV2.OnScrollListenerOEMV2` instead.\n\ncar-ui-lib 2.3.0\n----------------\n\n### New features\n\nAdded new component:\n\n- `CarUiShortcutsPopup`\n\nAdded support for the following scrollbar attributes:\n\n- `android:fadeScrollbars`\n- `android:scrollbars`\n- `android:scrollbarThumbVertical`\n- `android:scrollbarTrackVertical`\n- `android:scrollbarStyle`\n- `android:scrollbarFadeDuration`\n- `android:verticalScrollbarPosition`\n- `android:requiresFadingEdge`\n\n### Addressed issues\n\n- Fixed `CarUiRecyclerView`, which did not maintain position upon `Activity`\n recreation.\n\n- Resolved bitmap serialization incompatibility between the client code and\n the IME service.\n\n- Enabled usage of `NavHostFragment` with `PreferenceFragment`.\n\ncar-ui-lib-plugin-apis 1.2.0\n----------------------------\n\n### New features\n\nReplaced usage of `java.util.function` interfaces with the following library\ninterfaces:\n\n- `com.android.car.ui.plugin.oemapis.BiConsumer`\n- `com.android.car.ui.plugin.oemapis.Consumer`\n- `com.android.car.ui.plugin.oemapis.Function`\n\nDeprecated these items:\n\n- `PluginFactoryOEMV3`, use `PluginFactoryOEMV4` instead.\n- `ToolbarControllerOEMV1`, use `ToolbarControllerOEMV2` instead.\n- `ContentListItemOEMV1`, use `ContentListItemOEMV2` instead.\n- `ImeSearchInterfaceOEMV1`, use `ImeSearchInterfaceOEMV2` instead.\n\nReplaced the library implementation of nullness interfaces with implementations\nof `androidx.annotations`.\n\ncar-ui-lib-plugin-apis 1.1.1\n----------------------------\n\nThis release updates the `minSdkVersion` to 28.\n\ncar-ui-lib 2.2.1\n----------------\n\nThis release:\n\n- Introduces `CarUiFooterPreference`\n- Updates the `minSdkVersion` to 28.\n\ncar-ui-lib-plugin-apis 1.1.0\n----------------------------\n\nThis release:\n\n- Deprecates `AppStyledViewControllerOEMV1`\n- Introduces `AppStyledViewControllerOEMV2`\n\n- Incorporates changes from `AppStyledViewControllerOEMV1`:\n\n public abstract int getContentAreaHeight();\n public abstract int getContentAreaWidth();\n\n- Deprecates `PluginFactoryOEMV1` and `PluginFactoryOEMV2`\n\n- Introduces the `PluginFactoryOEMV3` interface.\n\ncar-ui-lib 2.1.0\n----------------\n\nThis release:\n\n- Adds `AppStyledView` client APIs:\n\n public int getContentAreaHeight();\n public int getContentAreaWidth();\n\n- Introduces `CarUiPrimarySwitchPreference`\n\n- Updates the `AppStyledDialogController` constructor to require `Activity`\n instead of `Context`:\n\n - Adds:\n\n public AppStyledDialogController(android.app.Activity);\n\n - Deprecates:\n\n public AppStyledDialogController(android.content.Context);\n\ncar-ui-lib-plugin-apis 1.0.1\n----------------------------\n\nThis release adds nullness annotations.\n\ncar-ui-lib-plugin-apis 1.0.0\n----------------------------\n\nThis release introduces support for the following `car-ui-lib` plugin APIs:\n\n- `AppStyledViewDialog`\n- `CarUiRecyclerView`\n- `CarUiToolbar`\n- `CarUiListItems`\n\ncar-ui-lib 2.0.0\n----------------\n\nThis version, available on [Google\nMaven](https://maven.google.com/web/index.html?#com.android.car.ui),\nintroduces `car-ui-lib` plugin support for these components:\n\n- `AppStyledViewDialog`\n- `CarUiRecyclerView`\n- `CarUiToolbar`\n- `CarUiListItems`\n\ncar-ui-lib 1.0.0\n----------------\n\nThis release is available on AOSP for Android 12 and lower and provides\nsupport for:\n\n- `AppStyledViewDialog`\n- [`CarUiRecyclerView`](/docs/devices/automotive/hmi/car_ui/caruirecyclerview)\n- [`CarUiToolbar`](/docs/devices/automotive/hmi/car_ui/toolbar_rro)\n- [`CarUiListItems`](/docs/devices/automotive/hmi/car_ui/caruilistitem)\n- Dialog\n- Resource customization through [runtime resource overlays (RROs)](/docs/core/architecture/rros)\n- [`PreferencesFragment`](/docs/devices/automotive/hmi/car_ui/caruipreference)\n- [Rotary support](/docs/devices/automotive/hmi/rotary_controller/oem_integration)\n- `WideScreenImeKeyboard`"]]