تطبيق السيارة
آخر تعديل | الإصدار الثابت | إصدار محتمل | الإصدار التجريبي | الإصدار التجريبي الأول |
---|---|---|---|---|
13 تشرين الثاني (نوفمبر) 2024 | 1.4.0 | - | 1.7.0-beta03 | - |
الإعلان عن التبعيات
لإضافة عنصر تابع إلى "مكتبة تطبيقات السيارات"، يجب إضافة مستودع Google Maven إلى مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.
أضِف التبعيات للعناصر التي تحتاج إليها في ملف build.gradle
ل
تطبيقك أو وحدتك:
Groovy
dependencies { implementation "androidx.car.app:app:1.4.0" // For Android Auto specific functionality implementation "androidx.car.app:app-projected:1.4.0" // For Android Automotive specific functionality implementation "androidx.car.app:app-automotive:1.4.0" // For testing testImplementation "androidx.car.app:app-testing:1.4.0" }
Kotlin
dependencies { implementation("androidx.car.app:app:1.4.0") // For Android Auto specific functionality implementation("androidx.car.app:app-projected:1.4.0") // For Android Automotive specific functionality implementation("androidx.car.app:app-automotive:1.4.0") // For testing testImplementation("androidx.car.app:app-testing:1.4.0") }
لمزيد من المعلومات عن العناصر الاعتمادية، اطّلِع على مقالة إضافة عناصر الاعتماد الخاصة بالإصدار.
ملاحظات
تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا واجهت مشاكل جديدة أو كان لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مكتبة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية عن طريق النقر على زر النجمة.
اطّلِع على مستندات أداة تتبُّع المشاكل لمزيد من المعلومات.
الإصدار 1.7
الإصدار 1.7.0-beta03
13 تشرين الثاني (نوفمبر) 2024
تم إصلاح ثغرة أمنية وإصلاح أخطاء عامة أخرى. إذا كنت تستخدم إصدارًا أقدم، يُرجى التحديث لاستخدام هذا الإصدار.
تم إصدار androidx.car.app:app-*:1.7.0-beta03
. يتضمّن الإصدار 1.7.0-beta03 عمليات الربط هذه.
تغييرات واجهة برمجة التطبيقات
- عدِّل رمز تسلسل / تحويل البيانات إلى سلسلة في CAL لمعالجة العناصر التي تمّ الإعلان عن التعليق التوضيحي
@CarProtocol
فيها فقط. (Ic730e) - يمكن الآن استخدام
CarAppExtender
لتوسيع نطاق إطار العملNotification.Builder
بدلاً منNotificationCompat.Builder
فقط. (Id3ad7) - أضِف
KEY_EXCLUDE_MEDIA_ITEM_FROM_MIXED_APP_LIST
إضافيًا. (I201f9) - أوقِف نهائيًا أسلوب الإنشاء Builder الفارغ في
ConversationItem
واستبدِله بأسلوب إنشاء يأخذ المَعلمات المطلوبة. تُضيف هذه الميزة أيضًا عملية تحقّق للحماية من الرسائل غير الصالحة. (Ic8221)
إصلاح الأخطاء
- تأكَّد من أنّ خريطة
PlaceList
تستخدم عنوان الرأس (نص فقط). (Ic992f) - تستخدم هذه المكتبة الآن تعليقات توضيحية حول عدم تحديد قيمة لسمة JSpecify، وهي عبارة عن استخدام للنوع. على مطوّري Kotlin استخدام مَعلمات المُجمِّع التالية لفرض الاستخدام الصحيح:
-Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode
. (Ib5367، b/326456246)
الإصدار 1.7.0-beta02
18 أيلول (سبتمبر) 2024
تم إصدار androidx.car.app:app-*:1.7.0-beta02
. يتضمّن الإصدار 1.7.0-beta02 عمليات الربط هذه.
تغييرات واجهة برمجة التطبيقات
- إضافة
KEY_ROOT_HINT_MEDIA_HOST_VERSION
إضافية (I8796b) - استبدال فئة
TabContents.Api8Builder
بـ@ExperimentalCarApi
في فئةTabContents.Builder
(I26fbe) - إضافة إجراء النية والإضافات لـ
CarMediaApp
(I50782) - وضع علامة على واجهات برمجة تطبيقات المراسلة على أنّها غير تجريبية (I0b070)
- إضافة ميزة تحميل العناصر عن بُعد إلى
SectionedItemTemplate
(تتيح تحميل قوائم طويلة بدون تعطُّل) (I0d122) - أضِف
SectionedItemTemplate
إلى قائمة النماذج المتوافقة داخلTabTemplate
في واجهة برمجة التطبيقات 8. (Idc5d6)
إصلاح الأخطاء
- تمت إزالة التحديد اليدوي للوصول إلى واجهات برمجة تطبيقات المنصة الجديدة لأنّ ذلك يحدث تلقائيًا من خلال وضع نماذج لواجهات برمجة التطبيقات عند استخدام R8 مع AGP 7.3 أو إصدار أحدث (مثل R8 الإصدار 3.3) ولجميع الإصدارات عند استخدام AGP 8.1 أو إصدار أحدث (مثل D8 الإصدار 8.1). ننصح العملاء الذين لا يستخدمون AGP بالترقية إلى الإصدار 8.1 من D8 أو إصدار أحدث. يُرجى مراجعة هذه المقالة للاطّلاع على مزيد من التفاصيل. (I9496c، b/345472586)
الإصدار 1.7.0-beta01
26 حزيران (يونيو) 2024
تم إصدار androidx.car.app:app-*:1.7.0-beta01
. يتضمّن الإصدار 1.7.0-beta01 عمليات الربط هذه. الميزات هي نفسها الميزات المنشورة في الإصدار alpha01، والتي تتم تكرارها أدناه:
الميزات الجديدة
- خريطة تتضمّن محتوى: نموذج جديد عبارة عن لوحة خريطة بالإضافة إلى نموذج محتوى، يمكن أن يكون في الوقت الحالي قائمة / شبكة / لوحة / رسالة.
- تم إيقاف
RoutePreview
وPlaceListNavigation
وMapTemplate
نهائيًا. وسيستمر عمل النماذج على النحو المعتاد. - تم تعديل نماذج التطبيقات لعرض استخدام
MapWithContent
بدلاً من النماذج المتوقّفة نهائيًا.
- تم إيقاف
- عنصر المحادثة: واجهات برمجة تطبيقات جديدة لعرض المحادثات (الرسائل الفورية والرسائل القصيرة) وقراءة "مساعد Google" في السيارة
- أبعاد المركبات: واجهة برمجة تطبيقات جديدة لاسترداد قياسات المركبات (البيانات في AAOS في الوقت الحالي)
تغييرات واجهة برمجة التطبيقات
- أضِف علامة
@ExperimentalCarApi
إلىMediaPlaybackTemplate.Builder
. (Ic1957) - إضافة
SectionedItemTemplate
جديدة في الإصدار التجريبي (I5958a) - تعريف
CarAppApiLevel 8
(I3fa22) - إضافة
MediaPlaybackTemplate
لعرض المحتوى أثناء تشغيل الوسائط في "مكتبة تطبيقات السيارات" (I3c10d) - تمت إضافة واجهة برمجة تطبيقات جديدة للتطبيقات من أجل رصد ما إذا كان النظام يتيح تشغيل الصوت في الخلفية أثناء القيادة (I0f868)
إصلاح الأخطاء
- إصلاح حالات معيّنة من تسرُّب الذاكرة والأعطال في رمز برنامج CAL العميل وفي تطبيق "نموذج التنقّل في CAL" (I55e04)
- استبدِل
requireNotNull instances
في طريقةonDestroy
فيBaseCarAppActivity
بعمليات التحقّق من القيم الخالية لتجنُّب الأعطال. (Iec676)
الإصدار 1.7.0-alpha02
17 نيسان (أبريل) 2024
تم إصدار androidx.car.app:app-*:1.7.0-alpha02
. يتضمّن الإصدار 1.7.0-alpha02 عمليات الربط هذه.
الميزات الجديدة
- تمت إضافة علامات متوقّفة نهائيًا للنماذج المستندة إلى الخرائط التي سيستخدمها نموذج
MapWithContent
من الآن فصاعدًا.
تغييرات واجهة برمجة التطبيقات
- إيقاف
MapTemplate
وRoutePreviewNavigationTemplate
وPlaceListNavigationTemplate
القديمة نهائيًا وتشجيعهم على استخدامMapWithContentTemplate
الجديدة (Ib0a08)
الإصدار 1.7.0-alpha01
3 نيسان (أبريل) 2024
تم إصدار androidx.car.app:app-*:1.7.0-alpha01
. لقد نقلنا مخطّط إصدار المكتبة لمطابقة إصدار CarApi النشط. ويهدف ذلك إلى تقليل الالتباس بشأن مخطّط التسمية استنادًا إلى ملاحظات المطوّرين. نتيجةً لذلك، سنتخطّى الإصدارَين 1.5 و1.6 وننتقل مباشرةً إلى الإصدار 1.7. يحتوي الإصدار 1.7.0-alpha01 على هذه المراجعات.
الميزات الجديدة
- خريطة تتضمّن محتوى: نموذج جديد باسم
MapWithContent
يتيح استخدام قائمة أو شبكة أو لوحة أو رسالة كمحتوى داخل خريطة.RoutePreview
،PlaceListNavigation
، تم إيقاف نماذج الخرائط نهائيًا.- تم تعديل نماذج التطبيقات لعرض وظائف النماذج المتوقّفة نهائيًا باستخدام
MapWithContent
.
- عنصر المحادثة: واجهات برمجة تطبيقات جديدة لعرض المحادثات (المحادثة الفورية والرسائل القصيرة) وقراءة "مساعد Google" في السيارة
- أبعاد المركبات: واجهة برمجة تطبيقات جديدة لاسترداد قياسات المركبات (البيانات في AAOS في الوقت الحالي)
تغييرات واجهة برمجة التطبيقات
- وضع علامة على نوع صورة الصفوف الصغيرة جدًا على أنّه تجريبي (I5184b)
- تمت إضافة واجهة برمجة التطبيقات
CarInfo#fetchExteriorDimensions
التي تسمح بالوصول إلى معلومات الأبعاد الخارجية للمركبة، مثل الارتفاع والعرض وما إلى ذلك (Ia40c5). - تمّت إزالة علامة
ExperimentalAPI
منMapWithContentTemplate
(I66db8) - عدِّل المَعلمة
GridItem#setTitle
لتصبح nullable. (I3d610) - لا تتطلّب واجهة برمجة التطبيقات
GetHeader
استخدام الإصدار 7 من واجهة برمجة التطبيقات لأنّها متوافقة مع الإصدارات القديمة (I8c812). - إتاحة
Header
فيListTemplate
وإيقافheaderAction
وheaderTitle
وactionStrip
نهائيًا (I7ae01) - إيقاف
title
وheaderAction
وactionStrip
نهائيًا فيGridTemplate
وإضافة إمكانية استخدامHeader
(I41a9c) - إزالة متطلبات المستوى 7 لواجهات برمجة التطبيقات التجريبية: الشارة،
GridTemplate
وظائف الحصول على/ضبط حجم العنصر وشكل الصورة،GridItem
طرق الحصول على/ضبط الشارة (Id71eb) - إيقاف
title
وheaderAction
وactionStrip
نهائيًا فيPaneTemplate
، وإضافة دعمHeader
جديد (I23154) - تم تغيير بيانات القياس في Media Center من
BroadcastReceiver
إلى "التصفّح" في الإجراء المخصّص. (I4185f) - تمت إضافة سمة
Header
فيMessageTemplate
. تم إيقاف التوافق معActionStrip
وheaderAction
وtitle
. (Ie2de8) - تعديل مستوى ظهور التنبيهات الثابتة (Icf8a8)
- أزِل سمة
isLoading
من النموذج الرئيسي (I651e6). - إضافة عناصر إضافية لإعلام تطبيقات الوسائط بمَعلمات واجهة المستخدم الرئيسية (I85ca2)
- إضافة ميزة إحصاءات مركز الوسائط إلى
MediaExtensions
(I7ce28) - تمت إضافة خيار لعرض صورة صغيرة جدًا في الصفوف. (I72c03)
إصلاح الأخطاء
- عدِّل javadoc في
ConversationItem
للإشارة إلى أنّه يجب ترتيب الرسائل من الأقدم إلى الأحدث. (I77a2a) - تعديل منطق اقتطاع
ListTemplate
لإزالة الرسائل الأقدم منConversationItem
(Ie0a61)
الإصدار 1.4
الإصدار 1.4.0
29 أيار (مايو) 2024
تم إصدار androidx.car.app:app-*:1.4.0
. الإصدار 1.4.0 هو إصدار ترويجي من الإصدار 1.4.0-rc02.
التغييرات المهمة منذ الإصدار 1.3.0
- عرض الخرائط على مجموعة العدادات لتطبيقات التنقّل
- نموذج علامة تبويب جديد لتحسين تنسيق التطبيق أو سهولة استخدامه
- إتاحة الحدود القصوى للمهام التكيُّفية
- الإجراءات الثانوية على عناصر القائمة
الإصدار 1.4.0-rc02
13 كانون الأول (ديسمبر) 2023
تم إصدار androidx.car.app:app-*:1.4.0-rc02
. يحتوي الإصدار 1.4.0-rc02 على هذه المراجعات. إصلاحات بسيطة فقط
إصلاح الأخطاء
- تعديل javadoc في
ConversationItem
للإشارة إلى أنّه يجب ترتيب الرسائل من الأقدم إلى الأحدث (I77a2a) - تعديل منطق اقتطاع
ListTemplate
لإزالة الرسائل الأقدم منConversationItem
(Ie0a61)
الإصدار 1.4.0-rc01
1 تشرين الثاني (نوفمبر) 2023
تم إصدار الإصدار androidx.car.app:app-*:1.4.0-rc01
بدون أي تغييرات ملحوظة. يحتوي الإصدار 1.4.0-rc01 على هذه المراجعات.
الإصدار 1.4.0-beta02
20 أيلول (سبتمبر) 2023
تم إصدار androidx.car.app:app-*:1.4.0-beta02
. يحتوي الإصدار 1.4.0-beta02 على هذه المراجعات. هذه الإصدارات متطابقة تقريبًا مع الإصدار beta01، ولكنّها تخفض متطلبات compileSdk
إلى 33.
إصلاح الأخطاء
- تم إصلاح خلل كان يؤدي إلى عدم عرض شاشات التحميل في علامات التبويب بشكلٍ صحيح. (cae860)
الإصدار 1.4.0-beta01
9 آب (أغسطس) 2023
تم إصدار androidx.car.app:app-*:1.4.0-beta01
. يحتوي الإصدار 1.4.0-beta01 على هذه المراجعات.
ملاحظة: يتطلب الإصدار 1.4-beta01 استخدام compileSdk34 الذي لا يزال في حالة التطوير. ستتم معالجة هذه المشكلة في الإصدار 1.4-beta02. بدلاً من ذلك، يمكنك إضافة
android.suppressUnsupportedCompileSdk=34
إلى ملفsettings.gradle
في مشروعك لإيقاف التحذير مؤقتًا بأمان.
الميزات الجديدة
- عرض خريطة مجموعة العدادات لتطبيقات التنقّل
- نموذج علامة تبويب جديد لتحسين تنسيق التطبيق أو سهولة استخدامه
- إتاحة الحدود المخصّصة للمهام التكيُّفية
- الإجراءات الثانوية على عناصر القائمة
تغييرات واجهة برمجة التطبيقات
- راجِع alpha02.
الإصدار 1.4.0-alpha02
26 تموز (يوليو) 2023
تم إصدار androidx.car.app:app-*:1.4.0-alpha02
. يحتوي الإصدار 1.4.0-alpha02 على هذه المراجعات.
- يهدف إصدار Alpha02 إلى التحضير لإصدار beta01 القادم.
الميزات الجديدة
- إتاحة عرض الخرائط على مجموعة العدادات لتطبيقات التنقّل
- تمت إضافة علامات تبويب للتطبيقات لتحسين تجربة التنسيق
- تمّت إضافة خيارات عرض نماذج القوائم أو الشبكات
- تمت إضافة فئات جديدة لكلّ من "الطقس" و"الرسائل".
- نقل العديد من واجهات برمجة التطبيقات إلى الإصدار التالي من CarApi 7
تغييرات واجهة برمجة التطبيقات
- إضافة حقول الوسائط المتعددة إلى
CarMessage
(I5aaf6) - إضافة إجراءات مخصّصة إلى
ConversationItem
في "مكتبة تطبيقات السيارات" (Ie5ed6) - أضِف عناصر إضافية للإشارة إلى أنّه يتم تشغيل عنصر وسائط بتنسيق صوتي غامر، وعرض شعار تنسيق المحتوى (Icb5bb).
- إضافة نوع إجراء جديد،
ActionsConstraints
واجهة برمجة التطبيقات لتفعيل زر الإنشاء (I31661) - تمّ ضبط
set/getTemplate
على أنّهset/get ContentTemplate
(Ica036) - ستكون مَعلمة النموذج الآن
@NonNull
. تم تعديل مستندات واجهة برمجة التطبيقاتMapWithContentTemplate
(I0f8ed) - إزالة علامة
@ExperimentalCarApi
للإجراءات فيListTemplate
لإطلاقها في CAL 1.4 (I2cfcb) - إزالة علامة
@ExperimentalCarApi
لـTabTemplate
(Ifcb82) - إزالة
@ExperimentalCarApi
تعليقات توضيحية من الإجراءات الثانوية والتصاميم في الصف (I8487e) - إضافة معرّف محتوى علامة التبويب النشطة إلى
TabTemplate
وإيقاف الحالة النشطة في علامات التبويب نهائيًا (I96932) - إضافة الموقع
ItemImageShape
إلىGridTemplate
(Ibf431) - أضِف السمة
ItemSize
إلىGridTemplate
التي تتحكّم في حجم عناصر الشبكة وفقًا للمجموعات النسبية الصغيرة والمتوسطة والكبيرة. (Icdb3b) - افتح إمكانية الوصول إلى واجهة برمجة التطبيقات للمطوّرين للحصول على نسخة من حِزمة الشاشة الحالية. (I48107)
- إضافة فئة تطبيقات الطقس إلى "مكتبة تطبيقات السيارات" (I2be44)
- إضافة فئة للتطبيقات التي تتصل بمكتبة تطبيقات السيارات (Icab33)
- تم استبدال
GridItem.Builder#setBadge()
بأساليبsetImage()
ذات عدد مهام زائد (Id2000) - إضافة سمة الرمز إلى الشارة (I629b2)
- إضافة طريقة لضبط لون خلفية شارة النقطة (I6411c)
- أضِف سمة الشارة إلى
GridItem
، ما يسمح بعرض شارة فوق صورةGridItem
. (I95de7) - تمت إضافة عنصر شارة تجريبي سيمثّل شارة يتم عرضها فوق صورة. (I9878d)
الإصدار 1.4.0-alpha01
22 شباط (فبراير) 2023
تم إصدار androidx.car.app:app-*:1.4.0-alpha01
. يحتوي الإصدار 1.4.0-alpha01 على هذه المراجعات.
تغييرات واجهة برمجة التطبيقات
- إضافة إجراءات من المستوى الأعلى إلى
GridTemplate
في مكتبة تطبيقات السيارات (Id0191) - تضيف الإجراءات على مستوى أعلى إلى
ListTemplate
في "مكتبة تطبيقات السيارات" (I9efab) - إضافة عناصر إضافية لربط الترجمة أو الوصف لعنصر وسائط بعناصر وسائط أخرى (Ic84bf)
- عدِّل مستوى واجهة برمجة التطبيقات لإجراءات الصف إلى المستوى 6. (Ie0a69)
- إضافة عمليات استدعاء المراسلة إلى A4C (Ie3986)
إصلاح الأخطاء
- أضِف مراجع JavaDoc غير المتوفّرة لـ
CarMessage
. (I5db1c) - إلغاء
equals()
وhashCode()
واستبدالهما بـConversationItem
وCarMessage
(I6fd10) - تحسين عملية التحقّق من
ConversationItem.mMessages
(يجب أن يكون الحقل غير فارغ وغير صفري (Iafc51)) - إضافة
@Keep
تعليقات توضيحية إلى حقولConversationItem
(I5d250) - تعديل مستندات Java لتزيين الصف والإجراءات الثانوية (I000b6)
الإصدار 1.3
الإصدار 1.3.0-rc01
7 كانون الأول (ديسمبر) 2022
تم إصدار androidx.car.app:app-*:1.3.0-rc01
. يحتوي الإصدار 1.3.0-rc01 على هذه المراجعات.
- إصلاحات أخطاء بسيطة من الإصدار beta01 ما مِن تغييرات كبيرة.
الإصدار 1.3.0-beta01
7 أيلول (سبتمبر) 2022
تم إصدار androidx.car.app:app:1.3.0-beta01
وandroidx.car.app:app-projected:1.3.0-beta01
وandroidx.car.app:app-automotive:1.3.0-beta01
وandroidx.car.app:app-testing:1.3.0-beta01
. يحتوي الإصدار 1.3.0-beta01 على هذه المراجعات.
- يمكن الآن نشر تطبيقات السيارات التي تم إنشاؤها باستخدام هذه المكتبة على "متجر Play" باستخدام المستوى 5 من واجهة برمجة التطبيقات (اطّلِع على دليل المطوّر). إنّ الميزات التي تمت إضافة تعليقات توضيحية لها باستخدام المستوى 5 من واجهة برمجة التطبيقات والإصدارات الأقدم متوافقة مع كلّ من الإصدار 8.1 من Android Auto والإصدارات الأحدث والإصدار 1.4 من Google Automotive App Host والإصدارات الأحدث.
الميزات الجديدة
بالإضافة إلى الإمكانات التي تمت إضافتها في الإصدار 1.3.0-alpha01 من "مكتبة تطبيقات السيارات"، تمت إضافة الميزات التالية كجزء من الإصدار beta01 (لا تتضمّن جميع الميزات هنا سوى التغييرات على جانب المضيف بدون أي تغييرات على واجهة برمجة التطبيقات):
- سيستمر عرض شريط التنقّل العائم حتى عندما يكون المستخدم في شاشة اختيار مستندة إلى الخريطة في
PlaceListNavigationTemplate
وRoutePreviewNavigationTemplate
وMapTemplate
. يمكن إجراء ذلك من خلال تعديل معلومات التنقّل من خلالNavigationManager.updateTrip()
. - فعِّل زر الإجراء باستخدام
FLAG_DEFAULT
لعرض صورة متحركة للوقت المنقضي. سيتم النقر على هذا الزر تلقائيًا بعد انتهاء مهلة الانتظار. ([API 5 - All Templates]
) - لا يتم اقتطاع النص الفرعي لرمز
Row
عندما تكون السيارة متوقفة، ولكن يتم اقتطاعه إلى سطرَين أثناء القيادة. ([API 5 - All Templates]
) - السماح بحالة "غير مفعّل" لـ
Action
وToggle
وRow
([API 5 - All Templates]
)
تغييرات واجهة برمجة التطبيقات
- تخفيف القيود في قائمة
MapTemplate
للسماح بالقوائم القابلة للاختيار (I961ed) - أزِل القيود المفروضة على إجراءات العنوان للسماح بالرموز المخصّصة. (Iad28f)
- أضِف قيدًا
setOnClickListenerAllowed()
إلىActionsConstraints
. حيث سُمح لـAction
بضبطOnClickDelegate()
على الإجراءات باستثناء أنواع الرموز العادية. (TYPE_APP_ICON
وTYPE_BACK
وTYPE_PAN
) (I3c745)
إصلاح الأخطاء
- تمت إضافة توافق Android Automotive Template Host 1.4 والإصدارات الأحدث مع الشاشات المنحنية (
[Host change]
).
الإصدار 1.3.0-alpha01
27 تموز (يوليو) 2022
تم إصدار androidx.car.app:app:1.3.0-alpha01
وandroidx.car.app:app-projected:1.3.0-alpha01
وandroidx.car.app:app-automotive:1.3.0-alpha01
وandroidx.car.app:app-testing:1.3.0-alpha01
. يحتوي الإصدار 1.3.0-alpha01 على هذه المراجعات.
تتوافق الميزات التي تمت إضافة تعليقات توضيحية لها باستخدام المستوى 5 من واجهة برمجة التطبيقات مع الإصدار 7.9 من Android Auto والإصدارات الأحدث.
الميزات الجديدة
- المستوى 5 لواجهة برمجة التطبيقات:
MapTemplate
جديدة يمكن استخدامها من قِبل تطبيقات التنقّل لعرض لوحة أو قائمة بالمحتوى بجانب خريطة (If5826 وIf44b8) - المستوى 5 من واجهة برمجة التطبيقات: واجهة برمجة تطبيقات
CarAudioRecord
جديدة للسماح بتسجيل الإدخال الصوتي عبر ميكروفون المركبة المستضافة (I5e71a) - المستوى 5 من واجهة برمجة التطبيقات: واجهة برمجة تطبيقات
SuggestionManager
جديدة للسماح للتطبيقات بتقديم اقتراحات للمضيف (I5c103) - المستوى 5 من واجهة برمجة التطبيقات: واجهة برمجة تطبيقات
Alert
جديدة لعرض الإشعارات في السياق علىNavigationTemplate
(I163a7 وI5ad70) - المستوى 5 من واجهة برمجة التطبيقات: مكوّنان جديدان
Header
وMapController
لتسهيل إعادة الاستخدام في جميع النماذج (If5826) - تمت إضافة
androidx.car.app.category.POI
لفئة تفعيل تطبيقات نقاط الاهتمام (وandroidx.car.app.category.PARKING
وandroidx.car.app.category.CHARGING
اللذان تم إيقافهما نهائيًا) (I59da1)
تغييرات واجهة برمجة التطبيقات
- المستوى 5 من واجهة برمجة التطبيقات: طريقة
onClick
جديدة في واجهةSurfaceCallback
للسماح بالنقر على التفاعل مع الخريطة (Ia9777) - المستوى 5 من واجهة برمجة التطبيقات: علامتان جديدتان
Action.FLAG_IS_PERSISTENT
وAction.FLAG_DEFAULT
لوصفAction
(I96318 وI5ad70) - المستوى 5 من واجهة برمجة التطبيقات: حالة جديدة مفعَّلة/متوقفة لمكوّنات
Action
وRow
وToggle
(سيتوفّر دعم المضيف في الإصدار 1.3.0-beta01 من المكتبة) (Id8a09) - المستوى 5 من واجهة برمجة التطبيقات: استخدام المكوّن
Header
الجديد من خلالsetHeader
فيPlaceListNavigationTemplate.Builder
وRoutePreviewNavigationTemplate.Builder
، مع إيقاف الطريقتَينsetTitle
وsetHeaderAction
الحاليتَين نهائيًا (I30e6a) - المستوى 5 من واجهة برمجة التطبيقات: طريقة
setOnContentRefreshListner
جديدة فيPlaceListMapTemplate.Builder
وPlaceListNavigationTemplate.Builder
لاستخدامها مع عمليات تنفيذ واجهةOnContentRefreshListner
الجديدة - المستوى 5 من واجهة برمجة التطبيقات:
setTripText
وsetTripIcon
جديدان فيTravelEstimate.Builder
لتخصيص بطاقة تقدير التنقّل (Idcc6d وIc620d) - إتاحة استخدام
CarIconSpan
في عنوانPaneTemplate
(Ia1ee0) - إتاحة استخدام
CarIconSpan
في عنوانRow
ونصه (Ic1e3c) - يمكن أن تتضمّن عروض
ActionStrip
على الخريطة الآن ما يصل إلى أربع إجراءات (If3522). - تعديل مستوى واجهة برمجة التطبيقات لتطبيق Car App إلى 5 (I26b8e)
- أصبحت العناوين اختيارية الآن للسمات
PlaceListMapTemplate
وPlaceListNavigationTemplate
وRoutePreviewNavigationTemplate
وGridTemplate
وListTemplate
وLongMessageTemplate
وMessageTemplate
وPaneTemplate
وSignInTemplate
(I2078d وIcadde).
إصلاح الأخطاء
- تم تعديل قواعد ضبط حجم الصور
PaneTemplate
لتكون مربّعًا محدودًا (Idd72e) - تم إصلاح استثناء يحدث إذا تم تعديل حزمة الشاشة بعد
State.DESTROYED
. (I3c8eb) - تمت إضافة عملية تحقّق من القيمة الخالية لاسترداد رمز التطبيق (I3f710).
- تعديل Car Hardware API لاستخدام
STATUS_UNKNOWN
بدلاً منSTATUS_UNAVAILABLE
تلقائيًا (Ic9444) - التحقّق مما إذا كان العرض متوفّرًا قبل إنشاء السطح (Ice027a)
- إصلاح خطأ
CarValue.equals()
فيSTATUS_UNIMPLEMENTED
(I24451)
الإصدار 1.2
الإصدار 1.2.0
9 تشرين الثاني (نوفمبر) 2022
تم إصدار androidx.car.app:app-*:1.2.0
. يحتوي الإصدار 1.2.0 على هذه المراجعات.
- هذا الإصدار مستقر، ولا تتوفّر أي تغييرات مقارنةً بالإصدار 1.2.0-rc01.
الإصدار 1.2.0-rc01
23 آذار (مارس) 2022
تم إصدار androidx.car.app:app-*:1.2.0-rc01
. يحتوي الإصدار 1.2.0-rc01 على هذه المراجعات.
- هذا الإصدار مخصّص لتحسين الأداء، ولا تتوفّر أي تغييرات في واجهة برمجة التطبيقات مقارنةً بالإصدار
v1.2.0-beta02
. تمّت إضافة ميزات تجريبية جديدة (المستوى 5 لواجهة برمجة التطبيقات) مخصّصة لإصدارات Android Auto وAndroid Automotive المستقبلية.
إصلاح الأخطاء
- تم إصلاح استثناء يحدث إذا تم تعديل حزمة الشاشة بعد
State.DESTROYED
. (I3c8eb) - تم تعديل واجهة برمجة التطبيقات
CarSensors
للإشارة إلى أنّها لم يتم تنفيذها لنظام التشغيل AAOS (Idd57b). - تم تعديل
PlaceListMapTempalte.Builder#setCurrentLocationEnabled
لتحديد أنّ ACCESS_COARSE_LOCATION سيكون كافيًا للميزة (I510c2) - جعل رقم الخروج اختياريًا لأنواع المناورات في دوار مع زاوية (Ife7d1)
الإصدار 1.2.0-beta02
26 كانون الثاني (يناير) 2022
تم إصدار androidx.car.app:app-*:1.2.0-beta02
. يحتوي الإصدار 1.2.0-beta02 على هذه المراجعات.
يمكن الآن نشر تطبيقات السيارات التي تم إنشاؤها باستخدام إصدار المكتبة هذا وتستهدف منصة Android Automotive OS
على قناة الاختبار المفتوح في "متجر Play". راجِع دليل التطوير للاطّلاع على مزيد من التفاصيل.
إنّ الميزات التي تمت إضافة تعليقات توضيحية لها باستخدام المستوى 4 من واجهة برمجة التطبيقات والمستويات الأقدم متوافقة مع كلّ من الإصدار 7.2 من Android Auto
والإصدارات الأحدث والنظام الأساسي الجديد Android Automotive OS
. يُرجى الاطّلاع على القسم Known Issues
أدناه لمعرفة التحذيرات.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة واجهة برمجة التطبيقات التجريبية
setOnContentRefreshListener
إلى نماذج نقاط الاهتمام (I6bf22).
إصلاح الأخطاء
- تم إصلاح تسرب في الذاكرة في
CarAppService
عند إلغاء ربط مضيف السيارة. (I5c9ca، b/203594731) - تم تعديل javadoc في
CarAppActivity
لتضمين متطلبات وضع التشغيل singleTask (Id2f95) - يقلل من الخلل المرئي عند استئناف التشغيل. (Iff7e0)
المشاكل المعروفة
- ستبدأ ميزة
ActionStrip
في الخريطة فيPlaceListNavigationTemplate
وRoutePreviewNavigateTemplate
في الظهور في الإصدارَينAndroid Auto
وAndroid Automotive OS
القادمَين.
الإصدار 1.2.0-alpha02
15 كانون الأول (ديسمبر) 2021
تم إصدار androidx.car.app:app-*:1.2.0-alpha02
. يحتوي الإصدار 1.2.0-alpha02 على هذه المراجعات.
تم ترقية الميزات التي تمّت إضافة تعليقات توضيحية لها باستخدام مستوى واجهة برمجة التطبيقات 4 من إصدار تجريبي إلى إصدار ثابت، بما في ذلك ActionStrip
s الخريطة في PlaceListNavigationTemplate
وRoutePreviewNavigateTemplate
، وCarIcon
الصورة في Pane
s، وQRCodeSignInMethod
، وإمكانية ضبط إشارات العرض (مثل الأعلام) في Action
s.
الميزات الجديدة
- في الإصدار 7.1 من Android Auto والإصدارات الأحدث، تم زيادة الحد الأقصى لعدد العناصر في
Pane
من 2 إلى 4.
تغييرات واجهة برمجة التطبيقات
- تمت إضافة طريقة
toString()
تجريبية إلىCarUnit
(I36a3b)
إصلاح الأخطاء
- تم إصلاح عطل حدث في
CarAppPermissionActivity
إذا لم يكن المرجع متوفّرًا (If9823). - تم تغيير الحدّ الأقصى لقائمة
Pane
التلقائية إلى 4 (I0068b)
الإصدار 1.2.0-alpha01
3 تشرين الثاني (نوفمبر) 2021
تم إصدار androidx.car.app:app-*:1.2.0-alpha01
. يحتوي الإصدار 1.2.0-alpha01 على هذه المراجعات.
جميع ميزات v1.2.0
الجديدة (الإصدار 4 من واجهة برمجة التطبيقات والإصدارات الأحدث) هي حاليًا ميزات تجريبية تستهدف الإصدارات المستقبلية من Android Auto وAndroid Automotive. راجِع دليل التطوير للاطّلاع على مزيد من التفاصيل.
تغييرات واجهة برمجة التطبيقات
- تم جعل واجهة برمجة التطبيقات
AutomotiveCarInfo
تجريبية. (Ia13e5) - تمت إضافة المستوى 4 من واجهة برمجة التطبيقات Car App Library (I2a2e7)
- المستوى 4 من واجهة برمجة التطبيقات: تمت إضافة إمكانية ضبط
CarIcon
فيPane
(Ifcc12) - مستوى واجهة برمجة التطبيقات 4: تمت إضافة طريقة تسجيل الدخول باستخدام رمز الاستجابة السريعة (Ib623e)
- المستوى 4 من واجهة برمجة التطبيقات: تمت إضافة set/getFlags إلى
Action
(Ic03ab) - المستوى 4 من واجهة برمجة التطبيقات: تمت إضافة ميزة التمرير السريع والتكبير/التصغير في
PlaceListNavigationTemplate
وRoutePreviewNavigationTemplate
(I9d8a3)
إصلاح الأخطاء
- مستوى واجهة برمجة التطبيقات 4: إضافة آلية للسماح للتطبيقات بإرسال تعديلات الموقع الجغرافي إلى مضيف السيارة (I3bad3)
- إصلاح مشكلة عدم عثور منطق التحقّق من المضيف على إذن TEMPLATE_RENDERER بشكلٍ صحيح (I62618)
الإصدار 1.1.0
الإصدار 1.1.0
15 كانون الأول (ديسمبر) 2021
تم إصدار androidx.car.app:app-*:1.1.0
. يحتوي الإصدار 1.1.0 على عمليات الربط هذه.
هذا إصدار مستقر، ولا تتوفّر أي تغييرات مقارنةً بالإصدار v1.1.0-rc01
. يمكنك أيضًا الاطّلاع على ملاحظات الإصدار v1.2.0-alpha02
للحصول على مزيد من التفاصيل عن الميزات الجديدة لمكتبة تطبيقات السيارات.
التغييرات المهمة منذ الإصدار 1.0.0
- المستوى 2 من واجهة برمجة التطبيقات:
SignInTemplate
وLongMessageTemplate
اللذان يمكن استخدامهما لعمليات تسجيل الدخول عندما تكون المركبة متوقفة - المستوى 2 من واجهة برمجة التطبيقات: إتاحة التفاعل مع الخريطة ضمن
NavigationTemplate
- المستوى 2 من واجهة برمجة التطبيقات: يتيح هذا المستوى عرض نصوص ذات أطوال متعددة للسماح للتطبيقات بتوفير نُسخ متعددة من السلسلة لعرضها استنادًا إلى أحجام شاشات السيارات.
- المستوى 3 من واجهة برمجة التطبيقات:
CarHardwareManager
يمكن استخدامه لطلب بيانات أجهزة المركبة، مثل الطراز والعلامة التجارية ومستويات الوقود وأجهزة الاستشعار الأخرى.
الإصدار 1.1.0-rc01
3 تشرين الثاني (نوفمبر) 2021
تم إصدار androidx.car.app:app-*:1.1.0-rc01
. يحتوي الإصدار 1.1.0-rc01 على هذه المراجعات.
هذا الإصدار مخصّص لتحسين الأداء، ولا تتوفّر أي تغييرات في واجهة برمجة التطبيقات مقارنةً بالإصدار v1.1.0-beta01
. تمت إضافة ميزات تجريبية جديدة (المستوى 4 لواجهة برمجة التطبيقات) مخصّصة لإصدارات Android Auto المستقبلية. يُرجى الاطّلاع على ملاحظات الإصدار v1.2.0-alpha01
للحصول على مزيد من التفاصيل حول واجهات برمجة التطبيقات التجريبية.
الإصدار 1.1.0-beta01
1 أيلول (سبتمبر) 2021
تم إصدار androidx.car.app:app-*:1.1.0-beta01
. يحتوي الإصدار 1.1.0-beta01 على هذه المراجعات.
جميع ميزات v1.1.0
(الإصدار 2 من واجهة برمجة التطبيقات والإصدارات الأحدث) متوافقة تمامًا مع الإصدار 6.7 من Android Auto والإصدارات الأحدث. راجِع دليل التطوير للاطّلاع على مزيد من التفاصيل.
تغييرات واجهة برمجة التطبيقات
- تمت إزالة
Manager
كواجهة علنية (Ie381b) - تمت إضافة إمكانية ضبط خلفية مخصّصة تحمل علامة تجارية لطلب الإذن (I74b76)
- تمت إضافة
ScreenManager.getStackSize
(I0b16a) - تمّت إزالة باني
ScreenController
الذي يأخذTestCarContext
بشكل صريح (Iefebc).
إصلاح الأخطاء
- تمت إضافة فحص مستوى واجهة برمجة التطبيقات عند إنشاء
CarHardwareManager
(I48f9b) - تمّت إضافة عمليات تحقّق من استخدام
CarSpan
غير الصالح في واجهة برمجة التطبيقات (I65ae6) - تم إصلاح مشكلة تؤدي إلى ترك الحزمة في حالة تعطُّل إذا تم وضع علامة على
Screen
على أنّها مكتملة أثناء إنشائها (I81b13). - إصلاح مشكلة تؤدي إلى تسجيل خطأ في AutomotiveOS
من خلال
CarNotificationManager.notify
في حال توفّر إجراءات تتضمّن رموزًا فيCarAppExtender
(I3633d) - تمت إضافة طريقة بدء اتصال للتطبيق والمضيف لتحديد إصدار واجهة برمجة التطبيقات (I7d6f8).
الإصدار 1.1.0-alpha02
21 تموز (يوليو) 2021
تم إصدار androidx.car.app:app-*:1.1.0-alpha02
. يحتوي الإصدار 1.1.0-alpha02 على هذه المراجعات.
الميزات الجديدة
- المستوى 3 من واجهة برمجة التطبيقات: تمت إضافة
CarHardwareManager
يمكن استخدامه لطلب بيانات أجهزة المركبة، مثل الطراز والعلامة التجارية ومستويات الوقود وأجهزة الاستشعار الأخرى. لا تتوفّر هذه الميزة حاليًا إلا لإصدار Android Auto 6.7 والإصدارات الأحدث في قناة الاختبار المفتوح. يتطلّب اختبار هذه الميزة في بيئة الكمبيوتر المكتبي استخدام إصدار جديد منDesktop Head Unit
سيتم إصداره بشكل منفصل. يُرجى متابعة صفحة اختبار تطبيقات Android للسيارات لمعرفة تفاصيل حول وقت توفّر الإصدار الجديد. - اتّبِع دليل التطوير ومرجع المكتبة للحصول على تفاصيل إضافية وإرشادات تصميم حول كيفية استخدام هذه الميزات في مضيفات السيارات المتوافقة مع المستوى 3 من واجهة برمجة التطبيقات.
تغييرات واجهة برمجة التطبيقات
- دمج طُرق دورة حياة
SessionController
وScreenController
في طريقة واحدةmoveToState
(I1ed00) - تمت إضافة
CarContext#getHostInfo()
(I8977e) - تمّت إزالة الحقول المتوقّفة نهائيًا. (I67168)
- تم تعديل
SessionController
وScreenController
لعرض أدوات الإنشاء مباشرةً (Iabf22) - تمت إزالة
PinSignInMethod.Builder
وProviderSignInMethod.Builder
(I9f0cb) - تمت إضافة setCarAppResult() لتفعيل استخدام التطبيقات المستندة إلى النماذج "للنتيجة" في AAOS (I37741)
- واجهة
CarHardware
التي تمت إضافة تعليقات توضيحية إليها باستخدام@MainThread
(Ib2f85) - تمت إعادة تسمية
OnCarDataListener
إلىOnCarDataAvailableListener
(I518ca) - تم تعديل أسماء طرق
CarInfo
وSpeed
وMileage
وjavadoc. (I86672) - تمت إعادة تسمية
Toll
إلىTollCard
. (I3e7c8) - تمت إزالة القيمة
PinSignInMethod.getPin
المتوقّفة نهائيًا والتي تم استبدالها بالقيمةPinSignInMethod.getPinCode
(I996ce). - تمت إزالة
OnInputCompletedListener
(استُبدِل بـInputCallback
). (Ib5be1) - تم تغيير
PinSignInMethod
لقبولCharSequence
بدلاً منString
(I275d5)
إصلاح الأخطاء
- إصلاحات Javadoc لأجهزة السيارات (I2abbc)
المساهمة الخارجية
المشاكل المعروفة
- في
SignInTemplate
، قد يؤدي استخدامInputSignInMethod
إلى حدوثNullPointerException
في مضيف السيارة. وسيتم حلّ هذه المشكلة في الإصدار التالي من المكتبة. لحلّ هذه المشكلة، أدرِج هذا السطر في إعدادات Proguard لتطبيقك:-keep class androidx.car.app.model.signin.InputSignInMethod { *; }
الإصدار 1.1.0-alpha01
16 حزيران (يونيو) 2021
تم إصدار androidx.car.app:app:1.1.0-alpha01
وandroidx.car.app:app-automotive:1.1.0-alpha01
وandroidx.car.app:app-testing:1.1.0-alpha01
. يحتوي الإصدار 1.1.0-alpha01 على هذه المراجعات.
الميزات الجديدة
- المستوى 2 لواجهة برمجة التطبيقات:
SignInTemplate
وLongMessageTemplate
الجديدان اللذان يمكن استخدامهما لعمليات تسجيل الدخول عندما تكون المركبة متوقفة - المستوى 2 من واجهة برمجة التطبيقات: إتاحة التفاعل مع الخريطة الجديدة ضمن
NavigationTemplate
- المستوى 2 من واجهة برمجة التطبيقات: إتاحة استخدام نصوص متعددة الطول للسماح للتطبيقات بتوفير نُسخ متعددة من السلسلة لعرضها استنادًا إلى أحجام شاشة السيارة
- اتّبِع دليل التطوير وJavadoc للمكتبة للحصول على تفاصيل إضافية وإرشادات تصميم حول كيفية استخدام هذه الميزات في مضيفي السيارات المتوافقين مع المستوى 2 من واجهة برمجة التطبيقات.
تغييرات واجهة برمجة التطبيقات
- تم ضبط جميع طرق واجهة
*Callback
على الإعداد التلقائي وإعادة تسميةOnRequestPermissionsCallback
إلىOnRequestPermissionsListener
(Ib3ec9). - تم تعديل فئات
androidx.car.app.hardware
لإزالة فئات المُنشئين والمَعلمات غير الضرورية. (I67beb) - تمت إضافة
androidx.car.app.hardware
فئة للوصول إلى بيانات محدّدة للسيارة، مثل الوقود والبطارية والسرعة. (Iff3c9) - تمت إضافة
ActionStrip
فيMessageTemplate
(Ida657) - تمت إضافة
setLoading
إلىMessageTemplate
. (I2a4b5) - تمت إعادة تسمية
ConnectionToCar
إلىCarConnection
(Ife9bd) - تم تغيير
NavigationTemplate
لعرضPanModeDelegate
صريح (I13877) - تم تعديل ترتيب المَعلمات في
CarContext.requestPermissions
(Ib890a) - تم تعديل مفتاح البيانات الوصفية لتحديد الحد الأدنى لمستوى واجهة برمجة التطبيقات للمركبات على
androidx.car.api.minCarApiLevel
(Ib0d41). - تم إنشاء واجهة برمجة تطبيقات تتيح مراقبة حالة اتصال السيارة (Ifc935).
- تمّت إضافة إمكانية ضبط زرّ تبديل لعنصر
Action
، وتمت إضافة نوع وضع التمريرAction
(Ica6af). - تم إنشاء
CarNotificationManager
لإتاحة إرسال الإشعارات في السيارة (I10d7a) - تمت إضافة
ConstraintManager
لتوفير حدود القائمة من المضيف (I8690e) - تمت إضافة واجهة برمجة التطبيقات لميزة "وضع التمرير" وشريط إجراءات الخريطة في الإصدار
NavigationTemplate
(I77aa6). - تمت إضافة واجهة برمجة التطبيقات الخاصة بتمويه الصورة وتكبيرها أو تصغيرها في
SurfaceCallback
لتطبيقات التنقّل (Id5e9d) - تم تعديل
CarAppApiLevel
إلى 2 (Ic1540) - تمت إضافة إمكانية طلب الأذونات من
CarAppService
(I5421e) - تمت إضافة تعليق توضيحي
RequiresCarApi(2)
إلى واجهة برمجة التطبيقات لنصّ متعدد (Iacb62) - السماح بأشكال نصية متعدّدة في عنوان نموذج القائمة المكوّنة من نصفَين (Ib8df7)
- تمت إضافة
LongMessageTemplate
جديدة (تتطلب المستوى 2 من Car API) (Ic5cee)
إصلاح الأخطاء
- متطلبات مُعدَّلة لحجم الصورة لمراعاة شاشات السيارات الأكبر حجمًا (I116dc)
- لا يُسمح بإضافة أكثر من إجراءَين في أجسام النماذج (I32157)
- التأكّد من أنّ جميع عمليات إنشاء
PendingIntent
في مكتبة تطبيقات السيارات قد تم ضبط علامات لها (If84fe، b/186394900) - تم تعديل javadoc للسماح بتغييرات النص في
Row
عند إعادة التحميل (If3f9c) - أصبح
androidx.activity:activity:1.2.0
الآن أحد العناصر التي تعتمد على واجهة برمجة التطبيقات (Id1cb9). - تم تعديل
SignInTemplate
وLongMessageTemplate
لطلب الإجراءات المتعلقة بالمركبة المتوقفة فقط في نصهما وتعديل المستندات للإشارة إلى أنّه لن يتم عرضها إلا عندما تكون السيارة متوقفة (Iddaa9) - تم إصلاح استثناء يحدث عند عرض
Screen
أثناء البدء (Ifcf40، b/184664896) - لون النص المخصّص المسموح به في
ForegroundCarColorSpan
(I69e59) - تم حلّ مشكلة ظهور
ON_DESTROY
علىSession
بعدON_DESTROY
Screen
(I52e01، b/183696617) - تم تعديل javadoc بشأن الحالات التي يُسمح فيها بضبط الوقت المتبقّي لـ
TravelEstimate
على وقت غير معروف. (I99610، b/183632456) - تم تعديل
Action
للسماح باستخدامForegroundColorSpan
في العنوان وأي لون خلفية مخصّص (I578e4). - لا تنفِّذ
NavigationManagerCallback#onStopNavigation
إذا تم محو طلب معاودة الاتصال قبل تنفيذ المُنفِّذ (I7fc5e، b/181143772) - تم إصلاح مشكلة كانت تتطلب من التطبيق الاعتماد بشكل صريح على lifecycle-common-java8 (I8b8c8).
المشاكل المعروفة
- في
SignInTemplate
، تعرض لوحة المفاتيح على الشاشة رمز "بحث" بدلاً من رمز "مفتاح Enter" عندما يريد المستخدم تأكيد الإدخال. كحل بديل، يمكن للمستخدمين الوصول إلى لوحة مفاتيح الهاتف التي يتم تفعيلها عندما يكون حقل الإدخال في المقدّمة. - في الإصدار 6.5 من Android Auto، قد يتم استدعاء طلبات الاستدعاء الخاصة بتمويه الصورة وتكبيرها في
SurfaceCallback
بشكل غير صحيح لبعض إيماءات اللمس.
الإصدار 1.0.0 من اختبار تطبيقات السيارات
الإصدار 1.0.0-alpha01
24 آذار (مارس) 2021
تم إصدار androidx.car.app:app-testing:1.0.0-alpha01
. يحتوي الإصدار 1.0.0-alpha01 على هذه المراجعات.
هذا هو أول إصدار من Jetpack لمكتبة اختبار المصدر المغلق سابقًا. يمكنك الرجوع إلى عيّنات حول كيفية استخدام هذه المكتبة في اختباراتك.
الميزات الجديدة
- تمت إزالة عناصر التحكّم في فئات النماذج. أصبحت أدوات الحصول على النماذج الآن جزءًا من واجهة برمجة التطبيقات المتاحة للجميع، ما يتيح التحقّق من القيم التي تم ضبطها في أدوات الإنشاء.
- تم استبدال العنصر السابق
CarAppServiceController
بالعنصر الجديدSessionController
لاختبار المنطق المرتبط بمدة الاتصال بالنقاط الساخنة.
الإصدار 1.0.0
الإصدار 1.0.0
21 نيسان (أبريل) 2021
تم إصدار androidx.car.app:app:1.0.0
. يحتوي الإصدار 1.0.0 على عمليات الربط هذه.
الميزات الرئيسية في الإصدار 1.0.0
- في أوائل نيسان (أبريل)، أعلنّا أنّه يمكن للتطبيقات بدء نشر الإصدارات العلنية باستخدام
androidx.car.app:app:1.0.0-rc01
. أصبح الإصدار 1.0.0 من "مكتبة تطبيقات السيارات" ثابتًا ومتوافقًا بالكامل مع الإصدار 6.1 من Android Auto والإصدارات الأحدث. - اتّبِع دليل التطوير للحصول على تفاصيل حول كيفية إنشاء تطبيقات التنقّل وركن السيارات والشحن لنظام Android Auto باستخدام المكتبة.
إصلاح الأخطاء
- تم إصلاح استثناء يحدث عند عرض
Screen
أثناء البدء (70aae1، b/184664896) - تم حلّ مشكلة ظهور
ON_DESTROY
فيSession
بعدON_DESTROY
فيScreen
(0ceecb، b/183696617)
الإصدار 1.0.0-rc01
24 آذار (مارس) 2021
تم إصدار androidx.car.app:app:1.0.0-rc01
. يحتوي الإصدار 1.0.0-rc01 على هذه المراجعات.
إصلاح الأخطاء
- تم إصلاح خطأ في حالة السباق حيث كان يتم استدعاء
NavigationManagerCallback#onStopNavigation
بعد محو طلب إعادة الاتصال. حدث ذلك إذا تم محو طلب إعادة الاتصال قبل تنفيذه (I7fc5e، b/181143772). - تم إصلاح مشكلة كانت تتطلّب من التطبيق الاعتماد صراحةً على
lifecycle-common-java8
(I8b8c8). - تم إصلاح خطأ
NullPointerException
الذي كان يتم طرحه عندما يتلقّى التطبيق طلبstopNavigation
بعد أن أزال طلب معاودة اتصال (Ib8b89، b/181143772) - تحسينات لمنع إرسال المكالمات إلى التطبيق إذا لم تكن دورة حياته في حالة
CREATED
على الأقل (I86965 وb/179800224 وb/177921120) - تم إصلاح مشكلة كانت تؤدي إلى ظهور خطأ ANR على المضيف بسبب قيمة غير صالحة لإصدار واجهة برمجة التطبيقات المحدّدة في بيان التطبيق. (Iffedd، b/174231592)
الإصدار 1.0.0-beta01
24 شباط (فبراير) 2021
تم إصدار androidx.car.app:app:1.0.0-beta01
. يحتوي الإصدار 1.0.0-beta01 على هذه المراجعات.
هذا هو أول إصدار من Jetpack للمكتبة التي كانت مفتوحة المصدر سابقًا، وهو متوافق مع Android Auto 6.1 أو الإصدارات الأحدث. اتّبِع دليل التطوير للحصول على تفاصيل حول كيفية إنشاء تطبيقات للسيارات باستخدام المكتبة.
الميزات الجديدة
- تمّ تقديم
GridTemplate
الذي يمكن لتطبيقك استخدامه لعرض قائمة بعناصر واجهة المستخدم في تخطيط شبكة. - تمّت إضافة طريقة
CarAppService.createHostValidator
للتحقّق من أنّ اتصال المضيف مصدره موثوق (مثل Android Auto). - تمت إضافة واجهة برمجة تطبيقات
CarAppExtender.Builder.setColor
. (b/174231592)
إصلاح الأخطاء
- تم إصلاح مشكلة استئناف
Screen
غير الصحيح عند عرض الشاشات بشكل تسلسلي. (b/177590791)