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

إنشاء تطبيقات تستند إلى نماذج لـ Android Auto ونظام التشغيل Android Automotive
آخر الأخبار الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأولي
‫22 أبريل 2026 1.7.0 - 1.8.0-beta01 -

تحديد الاعتماديات

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

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

Groovy

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"
}

Kotlin

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-beta01

‫22 أبريل 2026

تم طرح androidx.car.app:app-*:1.8.0-beta01. يتضمّن الإصدار 1.8.0-beta01 هذه التعديلات.

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

  • تمت إضافة إمكانية استخدام نموذج "العناصر المُقسَّمة"، ما يتيح إنشاء تنسيقات أكثر تعقيدًا للقوائم والجداول.
  • تحسين التوافق مع ميزة "تشغيل الوسائط"
  • تمت إضافة إمكانية استخدام IMAGE_TYPE_MEDIUM في RowImageType.
  • تمت إضافة Intent Action ACTION_MEDIA_SHOW_PLAYBACK_VIEW لتشغيل شاشات تشغيل الوسائط.

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

  • تمّت إضافة دعم IMAGE_TYPE_MEDIUM في RowImageType (I76108)
  • أضِف إجراء النية ACTION_MEDIA_SHOW_PLAYBACK_VIEW. عند إرسال هذا الإجراء إلى نشاط يتيح استخدامه، يشير ذلك إلى أنّ التطبيق يجب أن يعرض شاشة التشغيل أو شاشة ذات صلة (If29db، b/455949944).

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

  • تغيير السلوك التلقائي لـ SectionedItemTemplate القادم لحفظ حالة التمرير عند إعادة تحميل النموذج وعند تنفيذ إجراءات الرجوع (I6c9cc، b/461256656)

الإصدار ‎1.8.0-alpha03

‫19 نوفمبر 2025

تم طرح androidx.car.app:app-*:1.8.0-alpha03. يتضمّن الإصدار 1.8.0-alpha03 هذه التعديلات.

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

  • تمت إضافة صورة إلى الصفوف، ما يتيح حالات استخدام جديدة للقوائم.
  • أضِف SectionedItemTemplate#alphabeticalIndexingStrategy للسماح بفهرسة أبجدية مختلفة لمسرّعات القوائم.

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

  • تمت إضافة endImageType لـ endImages في "الصفوف" (I8865b)
  • أضِف SectionedItemTemplate#alphabeticalIndexingStrategy. هذا الخيار بديل عن #isAlphabeticalIndexingAllowed ويمنح المطوّرين المزيد من الخيارات للفهرسة الأبجدية. (Ia164d، b/410092683)
  • إضافة دعم لصورة نهاية إلى صف في تطبيق سيارة (If93f0)
  • تمت إضافة CarIcon MediaPlayback لتسهيل استخدام الإجراء العادي MediaPlayback. (Ib6cb7)

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

  • نقل القيمة التلقائية minSdk من الإصدار 21 من واجهة برمجة التطبيقات إلى الإصدار 23 من واجهة برمجة التطبيقات (Ibdfca، b/380448311، b/435705964، b/435705223)

الإصدار ‎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)
  • إضافة فئة وإذن لتطبيقات الوسائط إلى "مكتبة تطبيقات السيارات" (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 التي تم إصلاحها في الإصدار التجريبي 3. إذا كنت تستخدم إصدارًا أقدم من 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 أو إصدار أحدث من "المكوّن الإضافي لنظام Gradle المتوافق مع Android" (مثل الإصدار 3.3 من R8)، وجميع عمليات الإنشاء عند استخدام الإصدار 8.1 أو إصدار أحدث من "المكوّن الإضافي لنظام Gradle المتوافق مع 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 يتيح استخدام قائمة أو شبكة أو لوحة أو رسالة كمحتوى داخل خريطة.
    • تم إيقاف نماذج الخرائط RoutePreview وPlaceListNavigation نهائيًا.
    • تم تعديل التطبيقات النموذجية لعرض وظائف النماذج المتوقّفة نهائيًا باستخدام 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 توفُّر compileSdk34، الذي لا يزال في حالة التطوير. سيتم حلّ هذه المشكلة في الإصدار 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)
  • إضافة فئة لتطبيقات الطقس إلى "مكتبة تطبيقات السيارات" (I2be44)
  • إضافة فئة لتطبيقات الاتصال إلى Car App Library (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 في "مكتبة تطبيقات السيارات" (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 هذه التعديلات.

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

بالإضافة إلى الإمكانات التي تمت إضافتها في الإصدار 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)

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

الإصدار 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)
  • تعديل مستوى واجهة برمجة التطبيقات لتطبيق السيارة إلى 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 Automotive (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 يمكن استخدامها للبحث عن بيانات أجهزة المركبة، مثل الطراز والماركة ومستويات الوقود وأجهزة الاستشعار الأخرى. تتوفّر هذه الميزة حاليًا لإصدار 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)
  • تم تعديل أسماء الطرق و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 أو الإصدارات الأحدث. اتّبِع دليل التطوير للحصول على تفاصيل حول كيفية إنشاء تطبيقات للسيارات باستخدام المكتبة.

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

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

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