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

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

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

لإضافة اعتمادية على "مكتبة تطبيقات السيارة"، يجب تضمين مستودع 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.9

الإصدار ‎1.9.0-alpha02

‫9 سبتمبر 2026

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

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

  • تحديد مظهر التطبيق: تمت إضافة CarAppThemeSource للسماح للتطبيقات بتفعيل ميزة تحديد مظهر العلامة التجارية وللسماح للمضيفين بالبحث عن إعدادات المظهر المفضّلة.
  • عنوان البحث: تمت إضافة SearchHeader لـ SectionedItemTemplate كبديل لعنوان البحث في الإصدار 9 من واجهة برمجة التطبيقات.
  • تنسيق المكوّنات: أضفنا إمكانية تنسيق علامات التبويب (TabStyle) وإعلانات البانر (BannerStyle) وعناصر التحكّم في الوسائط ومؤشرات التقدّم (MediaPlaybackStyle وStrokeCap).

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

  • تنسيق الوسائط وشريط التقدّم: تمت إضافة MediaPlaybackStyle وsetMediaAccentColor وStrokeCap المستقلة لتخصيص عناصر التحكّم في التشغيل ومؤشرات التقدّم. تم تعديل CarProgressBarStyle ليتوافق مع الألوان القابلة للتصغير، وتمت إزالة طرق الألوان المتوقّفة نهائيًا من CarProgressBar. (Ib45c6 وI17141 وI270a4 وI10fe4 وI80a17)
  • المظهر في التطبيقات: تم طرح CarAppThemeSource للموافقة على استخدام المظهر العام للتطبيق، وتمت إضافة onGetAppTheme إلى CarAppService (مع عملية الاتصال بين العمليات المقابلة) للسماح للمضيفين بالاستعلام عن إعدادات المظهر المفضّلة. (I108f8 وIfbd41 وI97c7e)
  • تنسيق علامات التبويب: تمت إضافة إمكانية استخدام ألوان خلفية مخصّصة وألوان محتوى/نص مخصّصة ونصف قطر مخصّص للزوايا من خلال TabStyle. (I07330، Id09f6)
  • أحجام الرموز والصور: تم إيقاف IMAGE_TYPE_ICON نهائيًا في Row وGridItem وBanner وCondensedItem واستبداله بثوابت الحجم IMAGE_TYPE_SMALL وIMAGE_TYPE_MEDIUM التي يتم عرض الرموز فيها بدون تلوين تلقائيًا. تمت إعادة تصميم CarIconStyle وإضافة إمكانية استخدام أشكال مخصّصة في CarIcon. (Ie57fa، I5cc2d، Ic9584، Iaef57)
  • إعلانات البانر: تمت إضافة BannerStyle للأشكال المخصّصة ونصف قطر الزوايا، وتمت إضافة خيارات مختلفة للصور (IMAGE_TYPE_SMALL وIMAGE_TYPE_LARGE)، وتمت إزالة واجهات برمجة التطبيقات المتوقّفة نهائيًا للرموز والخلفيات لصالح setLeadingImage وaddTrailingImage. (I265bb وI7d28a وI23f62 وI2917e وI95b1c)
  • العناوين والتنسيق: تم تقديم SearchHeader لـ SectionedItemTemplate في الإصدار 9 من واجهة برمجة التطبيقات، وتمت إضافة startHeaderImage إلى Header لرموز البدء المخصّصة، كما تمت إضافة incompleteLastRowStrategy للتحكّم في معالجة الصفوف/الأعمدة الجزئية في أقسام الشبكة والمكثّفة والمميّزة. (I86632، I24937، If64be)

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

  • أوضحنا أنّه يتم تجاهل Action.TYPE_MEDIA_PLAYBACK باعتباره زر إجراء عائمًا في النماذج على مضيفي Car API 9 والإصدارات الأحدث. (Ie8fd4)

الإصدار ‎1.9.0-alpha01

‫19 مايو 2026

تم طرح androidx.car.app:app-*:1.9.0-alpha01. تمت إضافة ميزات جديدة لتوفير مرونة أكبر عند استخدام النماذج:

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

يتضمّن الإصدار 1.9.0-alpha01 هذه التعديلات.

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

  • تمت إضافة Banner وBannerSection اللذين يسمحان بإضافة Banners إلى SectionedItemTemplate. (Id5dd2، b/505494611)
  • تمت إضافة NavigationManager.setVoiceAssistantCapabilities للسماح لتطبيقات الملاحة بإرسال إمكانات المساعد الصوتي وحالة الموافقة إلى المضيف. (I34c93، b/489625791، b/486967456)
  • تمت إضافة واجهة برمجة التطبيقات NavigationVoiceAssistantCapabilities لتطبيقات الملاحة من أجل الإفصاح عن الإجراءات الصوتية المتوافقة وحالات التعطيل وحالة الموافقة على المساعد الصوتي. (I79d3e، b/489625791، b/486967456)
  • تقديم CarAppApiLevel 9 (I87656 وb/501233317)
  • إضافة واجهة برمجة تطبيقات لضبط شكل Chip أو ChipSection من خلال ChipStyle (I1fcfc، b/505086379)
  • تمت إضافة واجهات برمجة التطبيقات الجديدة CondensedItem وCondensedSection لدعم التنسيقات عالية الكثافة في SectionedItemTemplate. (Iabaa8، b/499350859)
  • تمت إضافة دعم تجريبي للترجمة في العنوان ونموذج خلفية جديد. (I66b5b)

الإصدار 1.8

الإصدار ‎1.8.0-rc01

‫26 أغسطس 2026

تم إصدار androidx.car.app:app-*:1.8.0-rc01 ويتضمّن الميزات نفسها المتوفّرة في الإصدار 1.8.0-beta01. يتضمّن الإصدار 1.8.0-rc01 هذه التعديلات.

  • يتضمّن هذا الإصدار إصلاحًا أمنيًا. إذا كنت تستخدم إصدارًا أقدم، يُرجى التحديث إلى هذا الإصدار.

الإصدار ‎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)

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

الإصدار ‎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 لواجهة برمجة التطبيقات (API) 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" (AGP) (مثل الإصدار 3.3 من R8)، وجميع عمليات الإنشاء عند استخدام الإصدار 8.1 أو إصدار أحدث من AGP (مثل الإصدار 8.1 من D8). ننصح العملاء الذين لا يستخدمون المكوّن الإضافي لنظام Gradle المتوافق مع Android‏ (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 هذه التعديلات. هذه النسخة مطابقة تقريبًا لنسخة beta01، ولكنها تخفّض متطلّبات compileSdk إلى 33.

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

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

الإصدار 1.4.0-beta01

‫9 أغسطس 2023

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

ملاحظة: يتطلّب الإصدار 1.4-beta01 من Jetpack Compose استخدام 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)
  • إضافة فئة لتطبيقات الاتصال إلى "مكتبة تطبيقات السيارات" (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 من "مكتبة تطبيقات السيارات"، تمت إضافة الميزات التالية كجزء من الإصدار 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 للإشارة إلى أنّها غير متاحة في 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 على قناة الاختبار المفتوح في متجر Google Play. يمكنك الرجوع إلى دليل التطوير لمزيد من التفاصيل.

تتوافق الميزات التي تمّت إضافة تعليقات توضيحية إليها بمستوى واجهة برمجة التطبيقات 4 والمستويات الأقل مع كلّ من الإصدار 7.2 والإصدارات الأحدث من Android Auto ومنصة Android Automotive OS الجديدة. يُرجى الاطّلاع على القسم Known Issues أدناه لمعرفة التحذيرات.

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

  • تمت إضافة واجهة برمجة التطبيقات التجريبية setOnContentRefreshListener إلى نماذج نقاط الاهتمام (I6bf22)

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

  • تم إصلاح تسرب الذاكرة في CarAppService عند إلغاء ربط مضيف السيارة. (I5c9ca، b/203594731)
  • تم تعديل javadoc الخاص بـ CarAppActivity لتضمين متطلبات وضع التشغيل singleTask (Id2f95)
  • يقلّل من الخلل المرئي عند الاستئناف. (Iff7e0)

المشاكل المعروفة

  • ستبدأ خرائط ActionStrip في PlaceListNavigationTemplate وRoutePreviewNavigateTemplate في التوفّر في الإصدارَين التاليَين Android Auto وAndroid Automotive OS.

الإصدار 1.2.0-alpha02

15 كانون الأول (ديسمبر) 2021

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

تمت ترقية الميزات التي تمّت إضافة تعليقات توضيحية إليها باستخدام مستوى واجهة برمجة التطبيقات 4 من تجريبية إلى ثابتة، بما في ذلك الخريطة ActionStrips في PlaceListNavigationTemplate وRoutePreviewNavigateTemplate، وصورة CarIcon في Panes، وQRCodeSignInMethod، وإمكانية ضبط تلميحات العرض (مثل العلامات) في Actions.

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

  • في الإصدار 7.1 من Android Auto والإصدارات الأحدث، تمّت زيادة الحدّ الأقصى لعدد العناصر في Pane من 2 إلى 4.

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

  • تمت إضافة طريقة toString() تجريبية إلى CarUnit(I36a3b)

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

  • تم إصلاح تعطُّل حدث في CarAppPermissionActivity إذا كانت وظيفة رد الاتصال غير نشطة (If9823)
  • تم تغيير الحدّ التلقائي للقائمة Pane إلى 4 (I0068b)

الإصدار 1.2.0-alpha01

‫3 نوفمبر 2021

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

جميع ميزات v1.2.0 الجديدة (المستوى 4 لواجهة برمجة التطبيقات أو أعلى) هي حاليًا تجريبية وتستهدف الإصدارات المستقبلية من Android Auto ونظام التشغيل Android Automotive. يمكنك الرجوع إلى دليل التطوير لمزيد من التفاصيل.

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

  • تمت إضافة تصنيف تجريبي إلى واجهة برمجة التطبيقات AutomotiveCarInfo. (Ia13e5)
  • تمت إضافة المستوى 4 من واجهة برمجة التطبيقات Car App Library (I2a2e7)
  • المستوى 4 من واجهة برمجة التطبيقات: تمت إضافة إمكانية ضبط CarIcon في Pane (Ifcc12)
  • المستوى 4 من واجهة برمجة التطبيقات: تمت إضافة طريقة تسجيل الدخول باستخدام رمز الاستجابة السريعة (Ib623e)
  • المستوى 4 من واجهة برمجة التطبيقات: تمت إضافة set/getFlags إلى Action (Ic03ab)
  • المستوى 4 من واجهة برمجة التطبيقات: تمت إضافة إمكانية التحريك والتكبير والتصغير في PlaceListNavigationTemplate وRoutePreviewNavigationTemplate (I9d8a3)

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

  • المستوى 4 من واجهة برمجة التطبيقات: إضافة آلية للسماح للتطبيقات بإرسال تحديثات الموقع الجغرافي إلى مضيف السيارة (I3bad3)
  • تم إصلاح مشكلة عدم عثور منطق التحقّق من صحة المضيف على إذن TEMPLATE_RENDERER بشكلٍ صحيح (I62618)

الإصدار 1.1.0

الإصدار 1.1.0

15 كانون الأول (ديسمبر) 2021

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

هذا إصدار ثابت، ولم يتم إجراء أي تغييرات مقارنةً بالإصدار v1.1.0-rc01. يمكنك أيضًا الاطّلاع على ملاحظات الإصدار v1.2.0-alpha02 للحصول على مزيد من التفاصيل حول الميزات الجديدة لمكتبة تطبيقات السيارات.

التغييرات المهمة منذ الإصدار 1.0.0

  • المستوى 2 من واجهة برمجة التطبيقات: SignInTemplate وLongMessageTemplate اللذان يمكن استخدامهما في عمليات تسجيل الدخول عندما تكون السيارة متوقفة
  • المستوى 2 من واجهة برمجة التطبيقات: إتاحة التفاعل مع الخريطة ضمن NavigationTemplate
  • المستوى 2 من واجهة برمجة التطبيقات: إتاحة نصوص متعددة الأطوال للسماح للتطبيقات بتقديم إصدارات متعددة من السلسلة للعرض حسب أحجام شاشة السيارة
  • المستوى 3 من واجهة برمجة التطبيقات: CarHardwareManagerيمكن استخدامه للاستعلام عن بيانات أجهزة السيارة، مثل الطراز والماركة ومستويات الوقود وأجهزة الاستشعار الأخرى.

الإصدار 1.1.0-rc01

‫3 نوفمبر 2021

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

هذا إصدار ثابت، ولم يتم إجراء أي تغييرات على واجهة برمجة التطبيقات مقارنةً بالإصدار v1.1.0-beta01. تمت إضافة ميزات تجريبية جديدة (مستوى واجهة برمجة التطبيقات 4) مخصّصة لإصدارات Android Auto المستقبلية. لمزيد من التفاصيل حول واجهات برمجة التطبيقات التجريبية، يُرجى الاطّلاع على ملاحظات الإصدار الخاصة بـ v1.2.0-alpha01.

الإصدار 1.1.0-beta01

‫1 سبتمبر 2021

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

تتوافق جميع ميزات v1.1.0 (المستوى 2 من واجهة برمجة التطبيقات والإصدارات الأحدث) تمامًا مع الإصدار 6.7 من Android Auto والإصدارات الأحدث. يمكنك الرجوع إلى دليل التطوير لمزيد من التفاصيل.

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

  • تمت إزالة Manager كواجهة عامة (Ie381b)
  • تمّت إضافة إمكانية ضبط خلفية مخصّصة تحمل العلامة التجارية لطلب الحصول على إذن (I74b76)
  • تمت الإضافة في ‎ScreenManager.getStackSize (I0b16a)
  • تمت إزالة الدالة الإنشائية ScreenController التي تستخدم TestCarContext (Iefebc) بشكل صريح

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

  • تمت إضافة عملية التحقّق من مستوى واجهة برمجة التطبيقات عند إنشاء CarHardwareManager (I48f9b)
  • تمت إضافة عمليات تحقّق من الاستخدام غير الصالح لـ CarSpan في جميع أنحاء واجهة برمجة التطبيقات (I65ae6)
  • تم إصلاح مشكلة كانت تؤدي إلى ترك الحزمة في حالة غير صالحة (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) (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)