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

إنشاء تطبيقات تستند إلى نماذج لـ Android Auto وAndroid Automotive OS
آخر الأخبار الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأوّلي
‫19 نوفمبر 2025 1.7.0 - - 1.8.0-alpha03

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

لإضافة اعتمادية على Car App Library، يجب تضمين مستودع 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-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)

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

الإصدار 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 التي تم إصلاحها في الإصدار التجريبي 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 أو إصدار أحدث من "المكوّن الإضافي لنظام 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 هذه التعديلات. الميزات هي نفسها الميزات المنشورة في الإصدار الأولي 01، والتي يتم تكرارها أدناه:

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

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

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

بالإضافة إلى الإمكانات التي تمت إضافتها في الإصدار 1.3.0-alpha01 من "مكتبة تطبيقات السيارات"، تمت إضافة الميزات التالية كجزء من الإصدار 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)
  • تعديل مستوى 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 للإشارة إلى أنّها غير متاحة في 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 من واجهة برمجة التطبيقات والمستويات الأقل مع كلّ من 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() لإتاحة استخدام التطبيقات المستندة إلى نماذج "للحصول على نتيجة" في نظام التشغيل Android Automotive (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)