Car UI 库发布说明

本页介绍了在以下每个版本中对 Car UI 库进行的更新。

car-ui-lib 2.6.0

新增功能

  • 为 CarUiToolbar 徽标添加了点击监听器。

已解决的问题

  • 修复了通过插件进行更新时，CarUiToolbar 的溢出对话框内容保持过时的问题。
  • 修复了由于应用了不正确的插页，CarUiRecyclerView 的滚动条不可见的问题。
  • 修复了当插件返回空 InsetsChangedListener 时出现的问题。
  • 添加了一项检查，以强制要求在 AppStyledView 中呈现的内容不得使用 Theme.CarUi。
  • 修复了大型横向屏幕中默认 AppStyledView 的定位。
  • 添加了 AppStyledView 背景和暗淡量的自定义。
  • 添加了对在显示 AppStyledView 后调用 AppStyledDialog#setContentView() 的支持。

已弃用以下方法

  • CarUi#installBaseLayoutAround(View, InsetsChangedListener, boolean)，请改用 CarUi#InsetsChangedListener(Context, View, InsetsChangedListener, boolean)。
  • CarUi#installBaseLayoutAround(View, InsetsChangedListener, boolean, boolean)，请改用 CarUi#InsetsChangedListener(Context, View, InsetsChangedListener, boolean, boolean)。

car-ui-lib-plugin-apis 1.5.0

新增功能

  • 添加了 CarUiToolbar 徽标点击监听器的自定义。

已弃用以下项

  • PluginFactoryOEMV6，请改用 PluginFactoryOEMV7。
  • ToolbarControllerOEMV2，请改用 ToolbarControllerOEMV3。

car-ui-lib 2.5.1

已解决的问题

  • 修复了阻止加载 car-ui-lib 插件的 ProGuard 问题。
  • 修复了会导致运行时 NPE 的插件的向前兼容性问题。
  • 强制 car-ui-lib 插件必须是系统应用。
  • 修复了在某些情况下 CarUiRecyclerView 不显示滚动条的问题。
  • 修复了使用插件时，所选标签未更新的问题。
  • 修复了使用插件时，实例化 SearchView 时出现的问题。
  • 使用 Activity 上下文初始化 Car 服务 UX 限制状态回调，以获得正确的显示配置。
  • 更新了 nullness 注解。

car-ui-lib 2.5.0

已解决的问题

  • 优化了插件启动时间。
  • 修复了应用始终返回 1 作为最大支持插件版本的问题。
  • 移除了主题的覆盖，以强制从 AppStyledView 中使用 Theme.CarUi。
  • 添加了可替换方法，以在 ListPreferenceFragment 上设置标题。

car-ui-lib-plugin-apis 1.4.0

新增功能

  • 允许 OEM 自定义 CarUiPreference。

已弃用以下项

  • PluginFactoryOEMV5，请改用 PluginFactoryOEMV6。

car-ui-lib 2.4.0

新增功能

  • 添加了对过渡到 AppStyledView 的支持。

已解决的问题

  • 更新了 AppStyledRecyclerViewAdapter，使其不再公开。
  • 为 AppStyledDialogController 优化了上下文，并提供了一种便捷方法。
  • 将 AppStyledViewNavIcon 定义移至 AppStyledDialogController。
  • 移除了在 AppStyledView 中强制将主题覆盖为 Theme.CarUi 的操作。
  • 添加了过渡效果，以支持渲染 AppStyledView 屏幕。
  • 将 car_ui_recycler_view_no_scrollbar 添加到可以叠加的项目列表中。
  • 为 CarUiRecyclerView espresso ViewActions 和 ViewMatchers 创建了一个 Gradle 库。
  • 重构了应用样式视图，以使用 ScrollView。

car-ui-lib-plugin-apis 1.3.0

新增功能

已弃用以下项

  • PluginFactoryOEMV4，请改用 PluginFactoryOEMV5。
  • RecyclerViewOEMV1，请改用 RecyclerViewOEMV2。
  • OnScrollListenerOEMV1，请改用 RecyclerViewOEMV2.OnScrollListenerOEMV2。

car-ui-lib 2.3.0

新增功能

添加了新组件

  • CarUiShortcutsPopup

添加了对以下滚动条属性的支持

  • android:fadeScrollbars
  • android:scrollbars
  • android:scrollbarThumbVertical
  • android:scrollbarTrackVertical
  • android:scrollbarStyle
  • android:scrollbarFadeDuration
  • android:verticalScrollbarPosition
  • android:requiresFadingEdge

已解决的问题

  • 修复了 CarUiRecyclerView 在 Activity 重新创建时未保持位置的问题。

  • 解决了客户端代码和 IME 服务之间的位图序列化不兼容问题。

  • 支持将 NavHostFragment 与 PreferenceFragment 结合使用。

car-ui-lib-plugin-apis 1.2.0

新增功能

将 java.util.function 接口的用法替换为以下库接口

  • com.android.car.ui.plugin.oemapis.BiConsumer
  • com.android.car.ui.plugin.oemapis.Consumer
  • com.android.car.ui.plugin.oemapis.Function

已弃用以下项

  • PluginFactoryOEMV3，请改用 PluginFactoryOEMV4。
  • ToolbarControllerOEMV1，请改用 ToolbarControllerOEMV2。
  • ContentListItemOEMV1，请改用 ContentListItemOEMV2。
  • ImeSearchInterfaceOEMV1，请改用 ImeSearchInterfaceOEMV2。

将 nullness 接口的库实现替换为 androidx.annotations 的实现。

car-ui-lib-plugin-apis 1.1.1

此版本将 minSdkVersion 更新为 28。

car-ui-lib 2.2.1

此版本

  • 引入了 CarUiFooterPreference
  • 将 minSdkVersion 更新为 28。

car-ui-lib-plugin-apis 1.1.0

此版本

  • 弃用了 AppStyledViewControllerOEMV1

  • 引入了 AppStyledViewControllerOEMV2

  • 合并了 AppStyledViewControllerOEMV1 中的更改

    public abstract int getContentAreaHeight();
public abstract int getContentAreaWidth();

  • 弃用了 PluginFactoryOEMV1 和 PluginFactoryOEMV2

  • 引入了 PluginFactoryOEMV3 接口。

car-ui-lib 2.1.0

此版本

  • 添加了 AppStyledView 客户端 API

    public int getContentAreaHeight();
public int getContentAreaWidth();

  • 引入了 CarUiPrimarySwitchPreference

  • 更新了 AppStyledDialogController 构造函数，以要求使用 Activity 而不是 Context

    • 添加了

      public AppStyledDialogController(android.app.Activity);

    • 弃用了

      public AppStyledDialogController(android.content.Context);

car-ui-lib-plugin-apis 1.0.1

此版本添加了 nullness 注解。

car-ui-lib-plugin-apis 1.0.0

此版本引入了对以下 car-ui-lib 插件 API 的支持

  • AppStyledViewDialog
  • CarUiRecyclerView
  • CarUiToolbar
  • CarUiListItems

car-ui-lib 2.0.0

此版本（在 Google Maven 上提供）为以下组件引入了 car-ui-lib 插件支持

  • AppStyledViewDialog
  • CarUiRecyclerView
  • CarUiToolbar
  • CarUiListItems

car-ui-lib 1.0.0

此版本在 AOSP 上针对 Android 12 及更低版本提供，并为以下功能提供支持