تطبيق السيارة

تعريف التبعيات

لإضافة تبعية إلى "مكتبة تطبيقات السيارة"، يجب إضافة مستودع Google Maven إلى مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف التبعيات الخاصة بالعناصر التي تحتاج إليها في ملف build.gradle لتطبيقك أو وحدتك:

dependencies {
    implementation "androidx.car.app:app:1.7.0"

    // For Android Auto specific functionality
    implementation "androidx.car.app:app-projected:1.7.0"

    // For Android Automotive specific functionality
    implementation "androidx.car.app:app-automotive:1.7.0"

    // For testing
    testImplementation "androidx.car.app:app-testing:1.7.0"
}

dependencies {
    implementation("androidx.car.app:app:1.7.0")

    // For Android Auto specific functionality
    implementation("androidx.car.app:app-projected:1.7.0")

    // For Android Automotive specific functionality
    implementation("androidx.car.app:app-automotive:1.7.0")

    // For testing
    testImplementation("androidx.car.app:app-testing:1.7.0")
}

لمزيد من المعلومات حول العناصر التابعة، يُرجى الاطّلاع على إضافة عناصر تابعة للإنشاء.

الملاحظات

تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.

إنشاء مشكلة جديدة

يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.

الإصدار 1.8

الإصدار 1.8.0-alpha02

‫18 يونيو 2025

تم طرح androidx.car.app:app-*:1.8.0-alpha02. يحتوي الإصدار 1.8.0-alpha02 على عمليات الدمج هذه.

الميزات الجديدة

• تمت إضافة دعم Action.MEDIA_PLAYBACK الذي يعرض مؤشرًا استنادًا إلى حالة تشغيل الوسائط.
• تمت إضافة إمكانية التحكّم في موضع التمرير لدى المستخدم عند إعادة تحميل SectionedItemTemplate.

تغييرات واجهة برمجة التطبيقات

• إضافة إمكانية حفظ موضع التمرير للمستخدم ضمن SectionedItemTemplate بين عمليات إعادة التحميل (Ia4c51)
• تم تعديل الإجراء MEDIA_PLAYBACK لتفعيله لإجراء نهاية الصف (I05cc4)
• إضافة نوع إجراء جديد (I6cc5a)
• أضِف CarAppExtender#addAction(Action) حتى يمكن إضافة أي نوع من الإجراءات إلى CarAppExtender. (Idc4d7)
• تم إتاحة SectionedItemTemplate لواجهة برمجة التطبيقات 8 والإصدارات الأحدث. (I9a079)

الإصدار 1.8.0-alpha01

‫20 مايو 2025

تم طرح androidx.car.app:app-*:1.8.0-alpha01. يحتوي الإصدار 1.8.0-alpha01 على عمليات الدمج هذه.

الميزات الجديدة

تتوفّر جميع الإمكانات مؤقتًا على Android Auto فقط. سيتم الاستفادة من واجهات برمجة التطبيقات نفسها في جميع أنحاء AAOS

• تمت إضافة فئة "الوسائط" لإنشاء تطبيق مخصّص، كبديل للتطبيقات المستندة إلى MediaBrowse
• تمت إضافة "نموذج التشغيل" الذي يتيح التحكّم في أهم الإجراءات أثناء عرض "تشغيل الوسائط" (متاح فقط لتطبيقات الوسائط)
• تمت إضافة دعم كامل لـ "نموذج العنصر المقسَّم" على Android Auto، ما يتيح إنشاء مجموعات من الأقسام الفرعية المكوّنة من قوائم أو جداول.
• تمت إضافة مقاس كبير جدًا كحجم إضافي لعناصر الشبكة.

تغييرات واجهة برمجة التطبيقات

• إضافة خيار حجم إضافي لعناصر الشبكة (I35b58)
• إضافة فئة وإذن لتطبيقات الوسائط إلى Car App Library (I8e100)
• تمت إضافة واجهة برمجة تطبيقات جديدة لتتيح للتطبيقات معرفة ما إذا كانت فئة الوسائط CarAppLibrary متوافقة (Ic4b08)
• تمت إضافة OnItemVisibilityChangeListener إلى القسم. (I2c2fd)
• إضافة Mileage#getOdometerKilometers وإيقاف Mileage#getOdometerMeters نهائيًا (Ic91af)

إصلاح الأخطاء

• إصلاح خطأ إملائي في Javadoc الخاص بـ CarIcon.setTint (Iabd72)
• تم تعديل مستندات Row.Builder#setNumericDecoration لتوضيح أنّه لا يمكن استخدام إجراء واحد مع زخرفة رقمية، ولكن يمكن استخدام صفر أو إجراءَين مع زخرفة رقمية. (Ic0b08)
• تمت إضافة حقل للون خلفية رمز الشارة لعناصر الشبكة. (I2b6ae)

الإصدار 1.7

الإصدار 1.7.0

‫16 يوليو 2025

تم طرح androidx.car.app:app-*:1.7.0. يحتوي الإصدار 1.7.0 على عمليات الدمج هذه.

• هذا هو الإصدار الثابت الأول الذي يتضمّن إصلاحًا للثغرة الأمنية CVE-2024-10382 التي تم إصلاحها في الإصدار التجريبي 03. إذا كنت تستخدم إصدارًا أقدم من 1.7-beta03، يُرجى التحديث إلى هذا الإصدار.

الإصدار 1.7.0-rc01

‫15 يناير 2025

تم إصدار androidx.car.app:app-*:1.7.0-rc01 بدون أي تغييرات ملحوظة عن الإصدار التجريبي 03. الإصدار 1.7.0-rc01 يتضمّن عمليات الدمج هذه.

• هذا هو أول إصدار مرشّح يتضمّن إصلاحًا للثغرة الأمنية CVE-2024-10382 التي تم إصلاحها في الإصدار التجريبي 03. إذا كنت تستخدم إصدارًا أقدم من 1.7-beta03، يُرجى التحديث إلى هذا الإصدار.

الإصدار 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 (هذه هي القيمة التلقائية بدءًا من الإصدار 2.1.0 من المترجم البرمجي للغة Kotlin). (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 مع الإصدار 7.3 أو إصدار أحدث من "مكوّن Android الإضافي" (مثل الإصدار 3.3 من R8)، وجميع عمليات الإنشاء عند استخدام الإصدار 8.1 أو إصدار أحدث من "مكوّن Android الإضافي" (مثل الإصدار 8.1 من D8). ننصح العملاء الذين لا يستخدمون 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" في السيارة
• سمات المركبة: واجهة برمجة تطبيقات جديدة لاسترداد مقاييس المركبة (البيانات متاحة حاليًا على نظام التشغيل Android Automotive).

تغييرات واجهة برمجة التطبيقات

• أضِف العلامة @ExperimentalCarApi إلى MediaPlaybackTemplate.Builder. (Ic1957)
• تضيف هذه السمة SectionedItemTemplate جديدة في الوضع التجريبي. (I5958a)
• تقديم CarAppApiLevel 8 (I3fa22)
• تضيف هذه السمة MediaPlaybackTemplate لعرض المحتوى أثناء تشغيل الوسائط في "مكتبة تطبيقات السيارة". (I3c10d)
• تمت إضافة واجهة برمجة تطبيقات جديدة تتيح للتطبيقات رصد ما إذا كان النظام يتيح تشغيل الصوت في الخلفية أثناء القيادة (I0f868)

إصلاح الأخطاء

• إصلاح بعض حالات تسرب الذاكرة والأعطال في رمز برنامج CAL وفي تطبيق CAL Navigation Sample App. (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 يتيح عرض قائمة أو شبكة أو لوحة أو رسالة كمحتوى داخل خريطة.
  • تم إيقاف نماذج الخرائط نهائيًا.RoutePreviewPlaceListNavigation
  • تم تعديل التطبيقات النموذجية لعرض وظائف النماذج المتوقّفة نهائيًا باستخدام MapWithContent.
• عنصر المحادثة: واجهات برمجة تطبيقات جديدة لعرض المحادثات (المراسلة الفورية والرسائل القصيرة) وقراءة "مساعد Google" في السيارة
• سمات المركبة: واجهة برمجة تطبيقات جديدة لاسترداد مقاييس المركبة (تتوفّر البيانات حاليًا على AAOS).

تغييرات واجهة برمجة التطبيقات

• وضع علامة "تجريبي" على نوع صورة الصف الصغير جدًا (I5184b)
• تمت إضافة واجهة برمجة التطبيقات CarInfo#fetchExteriorDimensions التي تتيح الوصول إلى معلومات أبعاد المركبة الخارجية، مثل الارتفاع والعرض وما إلى ذلك (Ia40c5)
• تمت إزالة العلامة ExperimentalAPI من MapWithContentTemplate (I66db8)
• تعديل المَعلمة GridItem#setTitle لتكون قابلة للقيم الفارغة (I3d610)
• لا تتطلّب واجهة برمجة التطبيقات GetHeader الإصدار 7 من واجهة برمجة التطبيقات لأنّها متوافقة مع الإصدارات القديمة (I8c812)
• إضافة دعم Header في ListTemplate وإيقاف headerAction وheaderTitle وactionStrip نهائيًا (I7ae01)
• إيقاف title وheaderAction وactionStrip نهائيًا في GridTemplate وإتاحة Header (I41a9c)
• إزالة شرط المستوى 7 لواجهات برمجة التطبيقات التجريبية: Badge، وGridTemplate أدوات الحصول على حجم العنصر وشكل الصورة وتعيينهما، وGridItem طرق الحصول على Badge وتعيينه (Id71eb)
• إيقاف title وheaderAction وactionStrip نهائيًا في PaneTemplate، وإضافة دعم Header الجديد (I23154)
• تم تغيير بيانات قياس استخدام "مركز الوسائط" من 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 عمليات الإيداع هذه.. هذا الإصدار مطابق تقريبًا للإصدار التجريبي 01، ولكنّه يخفّض متطلّبات compileSdk إلى 33.

إصلاح الأخطاء

• تم إصلاح الخطأ الذي كان يؤدي إلى عدم عرض شاشات التحميل بشكلٍ مناسب على علامات التبويب. (cae860)

الإصدار 1.4.0-beta01

‫9 أغسطس 2023

تم طرح androidx.car.app:app-*:1.4.0-beta01. يحتوي الإصدار 1.4.0-beta01 على عمليات الإيداع هذه..

ملاحظة: يتطلّب الإصدار 1.4-beta01 من مكتبة Room الإصدار 34 من compileSdk، الذي لا يزال في حالة التطوير. سيتم حلّ هذه المشكلة في الإصدار 1.4-beta02. بدلاً من ذلك، يمكنك إضافة android.suppressUnsupportedCompileSdk=34 إلى ملف settings.gradle الخاص بمشروعك لإيقاف التحذير مؤقتًا بأمان.

الميزات الجديدة

• عرض خريطة مجموعة العدادات لتطبيقات التنقّل
• نموذج علامة التبويب الجديد لتحسين تخطيط التطبيق وسهولة استخدامه
• إتاحة حدود المهام التكيُّفية
• الإجراءات الثانوية على عناصر القائمة

تغييرات واجهة برمجة التطبيقات

• See 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)
• إضافة فئة لتطبيقات الطقس إلى Car App Library (I2be44)
• إضافة فئة لتطبيقات الاتصال إلى "مكتبة تطبيقات السيارات" (Icab33)
• تم استبدال GridItem.Builder#setBadge() بطُرق setImage() محمّلة بشكل زائد (Id2000)
• إضافة سمة الرمز إلى الشارة (I629b2)
• إضافة طريقة لضبط لون خلفية شارة النقطة (I6411c)
• أضِف السمة Badge إلى GridItem، ما يسمح بعرض شارة فوق صورة GridItem. (I95de7)
• تمت إضافة عنصر Badge تجريبي سيمثّل شارة سيتم عرضها فوق صورة. (I9878d)

الإصدار 1.4.0-alpha01

‫22 فبراير 2023

تم طرح androidx.car.app:app-*:1.4.0-alpha01. يحتوي الإصدار 1.4.0-alpha01 على عمليات الإيداع هذه.

تغييرات واجهة برمجة التطبيقات

• إضافة إجراءات رفيعة المستوى إلى GridTemplate في Car App Library (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 على عمليات الإيداع هذه.

• إصلاحات أخطاء بسيطة من الإصدار التجريبي 01. ما مِن تغييرات كبيرة.

الإصدار 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 لواجهة برمجة التطبيقات والإصدارات الأقدم مع كلّ من Android Auto 8.1 والإصدارات الأحدث وGoogle Automotive App Host 1.4 والإصدارات الأحدث.

الميزات الجديدة

بالإضافة إلى الإمكانات التي تمت إضافتها في الإصدار 1.3.0-alpha01 من Car App Library، تمت إضافة الميزات التالية كجزء من الإصدار beta01 (تتضمّن جميع الميزات هنا تغييرات من جهة المضيف فقط بدون أي تغييرات في واجهة برمجة التطبيقات):

• سيستمر ظهور شريط التنقّل العائم حتى عندما يكون المستخدم في شاشة اختيار مستندة إلى الخريطة في PlaceListNavigationTemplate وRoutePreviewNavigationTemplate وMapTemplate. يمكن إجراء ذلك من خلال تعديل معلومات التنقّل من خلال NavigationManager.updateTrip().
• فعِّل زر الإجراء باستخدام FLAG_DEFAULT لعرض رسم متحرك لانتهاء المهلة. سيتم النقر على هذا الزر تلقائيًا بعد انتهاء المهلة. ([API 5 - All Templates])
• لا يتم اقتطاع النص الفرعي Rows عندما تكون السيارة متوقفة، ولكن يتم اقتطاعه إلى سطرَين أثناء القيادة. ([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 لوصف Actions (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 API إلى 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 عمليات الإيداع هذه.

• هذا إصدار ثابت، ولم يتم إجراء أي تغييرات مقارنةً بالإصدار v1.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 للإشارة إلى أنّه لم يتم تنفيذها لنظام التشغيل Android Auto (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 من واجهة برمجة التطبيقات والمستويات الأقل مع كلّ من Android Auto 7.2 والإصدار الجديد 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 في PlaceListNavigationTemplate وRoutePreviewNavigateTemplate، وصورة CarIcon في Pane، وQRCodeSignInMethod، وإمكانية ضبط تلميحات العرض (مثل العلامات) في Action.

الميزات الجديدة

• في الإصدار 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 OS المستقبلية. راجِع دليل التطوير لمزيد من التفاصيل.

تغييرات واجهة برمجة التطبيقات

• تمت إضافة تصنيف "تجريبية" إلى واجهة برمجة التطبيقات 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)
• تم إصلاح مشكلة كانت تؤدي إلى ترك الحزمة في حالة غير صالحة (I81b13) في حال تم وضع العلامة "تم" على Screen أثناء إنشائه.
• إصلاح مشكلة كانت تؤدي إلى تسجيل CarNotificationManager.notify لخطأ في AutomotiveOS في حال توفّر إجراءات تتضمّن رموزًا في CarAppExtender (I3633d)
• تمت إضافة طريقة مصافحة بين التطبيق والمضيف لتحديد إصدار واجهة برمجة التطبيقات (I7d6f8)

الإصدار 1.1.0-alpha02

‫21 تموز (يوليو) 2021

تم طرح androidx.car.app:app-*:1.1.0-alpha02. يحتوي الإصدار 1.1.0-alpha02 على عمليات الإيداع هذه.

الميزات الجديدة

• المستوى 3 من واجهة برمجة التطبيقات: تمت إضافة CarHardwareManager يمكن استخدامه للبحث عن بيانات أجهزة المركبة، مثل الطراز والماركة ومستويات الوقود وأجهزة الاستشعار الأخرى. تتوفّر هذه الميزة حاليًا فقط في الإصدار 6.7 من Android Auto أو الإصدارات الأحدث في قناة الاختبار المفتوح. يتطلّب اختبار هذه الميزة في بيئة سطح المكتب إصدارًا جديدًا من 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)
• تم تعديل أسماء الطرق وJavadoc في CarInfo وSpeed وMileage. (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، تعرض لوحة المفاتيح على الشاشة رمز "بحث" بدلاً من رمز "إدخال" عندما يريد المستخدم تأكيد الإدخال. كحلّ بديل، يمكن للمستخدمين الوصول إلى لوحة مفاتيح الهاتف التي يتم تفعيلها عندما يكون حقل الإدخال في التركيز.
• في الإصدار 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 الأول من المكتبة السابقة ذات المصدر المغلق، وهو متوافق مع الإصدار 6.1 من Android Auto أو الإصدارات الأحدث. اتّبِع دليل التطوير للحصول على تفاصيل حول كيفية إنشاء تطبيقات للسيارات باستخدام المكتبة.

الميزات الجديدة

• تم تقديم GridTemplate يمكن لتطبيقك استخدامه لعرض قائمة بعناصر واجهة المستخدم في تخطيط شبكي.
• تمت إضافة طريقة CarAppService.createHostValidator للتحقّق من أنّ اتصال المضيف وارد من مصدر موثوق (مثل Android Auto).
• تمت إضافة واجهة برمجة تطبيقات CarAppExtender.Builder.setColor. (b/174231592)

إصلاح الأخطاء

• تم إصلاح مشكلة استئناف Screen غير الصحيح عند عرض الشاشات بالتسلسل. (b/177590791)