از 27 مارس 2025، توصیه می کنیم از android-latest-release به جای aosp-main برای ساختن و کمک به AOSP استفاده کنید. برای اطلاعات بیشتر، به تغییرات AOSP مراجعه کنید.
یادداشت‌های انتشار کتابخانه رابط کاربری خودرو
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
این صفحه به‌روزرسانی‌های ایجاد شده در کتابخانه 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
مسائل پرداخته شده است
- مشکل ProGuard را که مانع از بارگیری افزونه car-ui-lib بود، برطرف کرد.
- سازگاری رو به جلو برای افزونه هایی که باعث ایجاد NPE در زمان اجرا می شوند، رفع شد.
- این افزونه car-ui-lib باید یک برنامه سیستمی باشد.
- ثابت نشد
CarUiRecyclerView نوار پیمایش در برخی سناریوها را نشان نمی دهد. - برگه‌های انتخاب شده در هنگام استفاده از افزونه به روز نمی‌شوند.
- رفع مشکلات مربوط به نمونه سازی
SearchView هنگام استفاده از افزونه. - برای پیکربندی صحیح نمایشگر با استفاده از زمینه فعالیت برای پیکربندی صحیح نمایشگر، وضعیت محدودیت UX سرویس خودرو را راه اندازی کنید.
- حاشیه نویسی پوچ به روز شد.
car-ui-lib 2.5.0
مسائل پرداخته شده است
- زمان راه اندازی افزونه بهینه شده
- رفع مشکلی که در آن برنامه‌ها همیشه 1 را به عنوان حداکثر نسخه افزونه پشتیبانی شده برمی‌گرداندند.
- رونویسی طرح زمینه برای اجبار
Theme.CarUi از AppStyledView حذف شد. - روش قابل جبران برای تنظیم عنوان در
ListPreferenceFragment اضافه شد.
car-ui-lib-plugin-apis 1.4.0
ویژگی های جدید
- سفارشی سازی OEM
CarUiPreference را مجاز کنید.
این موارد را منسوخ کرد:
-
PluginFactoryOEMV5 ، به جای آن از PluginFactoryOEMV6 استفاده کنید.
car-ui-lib 2.4.0
ویژگی های جدید
- پشتیبانی برای انتقال به
AppStyledView اضافه شد.
مسائل پرداخته شده است
-
AppStyledRecyclerViewAdapter به‌روزرسانی شد تا دیگر عمومی نباشد. - یک روش راحت برای زمینه با بهینه سازی برای
AppStyledDialogController ارائه شده است. - تعریف
AppStyledViewNavIcon را به AppStyledDialogController منتقل کرد. - بازنویسی اجباری طرح زمینه در
Theme.CarUi در AppStyledView حذف شد. - انتقال برای پشتیبانی از رندر صفحه نمایش
AppStyledView اضافه شده است. -
car_ui_recycler_view_no_scrollbar را به لیست مواردی که می‌توان روی آنها قرار داد اضافه شد. - یک کتابخانه Gradle برای
CarUiRecyclerView اسپرسو ViewActions و ViewMatchers ایجاد کرد. - نمای سبک برنامه را برای استفاده از
ScrollView بازسازی کرد.
car-ui-lib-plugin-apis 1.3.0
ویژگی های جدید
این موارد را منسوخ کرد:
-
PluginFactoryOEMV4 ، به جای آن از PluginFactoryOEMV5 استفاده کنید. -
RecyclerViewOEMV1 ، به جای آن از RecyclerViewOEMV2 استفاده کنید. -
OnScrollListenerOEMV1 ، به جای آن RecyclerViewOEMV2.OnScrollListenerOEMV2 استفاده کنید.
car-ui-lib 2.3.0
ویژگی های جدید
کامپوننت جدید اضافه شد:
پشتیبانی از ویژگی های نوار اسکرول زیر اضافه شده است:
-
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 استفاده کنید.
اجرای کتابخانه ای از رابط های پوچ با پیاده سازی 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
این نسخه:
API های مشتری AppStyledView اضافه می کند:
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
این نسخه حاشیه نویسی بیهوده را اضافه می کند.
car-ui-lib-plugin-apis 1.0.0
این نسخه پشتیبانی از API های افزونه car-ui-lib زیر را معرفی می کند:
-
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 برای اندروید 12 و پایین‌تر در دسترس است و از موارد زیر پشتیبانی می‌کند:
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین به‌روزرسانی 2025-06-12 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین به‌روزرسانی 2025-06-12 بهوقت ساعت هماهنگ جهانی."],[],[],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`"]]
