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

يمكنك إنشاء تطبيقات مُصمَّمة وفقًا لنموذج Android Auto وAndroid Automotive.
التعديل الأخير الإصدار المستقر سحب المرشح الإصدار التجريبي إصدار أولي
26 يونيو 2024 1.4.0 - 1.7.0-beta01 -

إعلان التبعيات

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

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

Groovy

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

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

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

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

Kotlin

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

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

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

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

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

ملاحظات

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

إنشاء عدد جديد

راجِع مستندات "أداة تتبُّع المشاكل" للحصول على مزيد من المعلومات.

الإصدار 1.7

الإصدار 1.7.0-beta01

26 يونيو 2024

تم طرح androidx.car.app:app-*:1.7.0-beta01. يحتوي الإصدار 1.7.0-beta01 على عمليات التنفيذ هذه. الميزات مماثلة لتلك المنشورة في alpha01، والتي تتكرر أدناه:

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

  • وضع خرائط مع المحتوى: نموذج جديد للوحة خريطة بالإضافة إلى نموذج محتوى، والذي يمكن أن يكون في الوقت الحالي قائمة / شبكة / لوحة / رسالة.
    • تم إيقاف ميزات RoutePreview وPlaceListNavigation وMapTemplate نهائيًا. وستواصل النماذج العمل كما هي.
    • تم تعديل نماذج التطبيقات لعرض الاستخدام MapWithContentبدلاً من النماذج المتوقّفة نهائيًا.
  • عنصر المحادثة: واجهات برمجة تطبيقات جديدة لعرض المحادثات (الرسائل الفورية والرسائل القصيرة SMS) وقراءة "مساعد Google" في السيارة.
  • أبعاد المركبة: واجهة برمجة تطبيقات جديدة لاسترداد مقاييس المركبات (البيانات المتوفّرة على نظام التشغيل Android Automotive في الوقت الحالي).

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

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

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

  • إصلاح حالات تسرُّب أو أعطال الذاكرة في رمز عميل CAL وفي تطبيق نموذج التنقّل CAL (I55e04)
  • استبدِل requireNotNull instances في طريقة onDestroy في BaseCarAppActivity باستخدام عمليات التحقّق إذا كانت القيمة فارغة لتجنُّب حدوث أعطال. (Iec676)

الإصدار 1.7.0-alpha02

17 أبريل 2024

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

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

  • تمت إضافة علامات تم إيقافها نهائيًا للنماذج المستندة إلى الخرائط التي سيشغّلها النموذج MapWithContent من الآن فصاعدًا.

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

  • إيقاف العمل بإصدارات MapTemplate وRoutePreviewNavigationTemplate وPlaceListNavigationTemplate القديمة والتشجيع على استخدام MapWithContentTemplate الجديدة (Ib0a08)

الإصدار 1.7.0-alpha01

3 أبريل 2024

تم طرح androidx.car.app:app-*:1.7.0-alpha01. لقد نقلنا مخطط إصدارات المكتبة ليتوافق مع إصدار CarApi النشط. ويهدف ذلك إلى الحد من الالتباس بشأن نظام التسمية بناءً على ملاحظات المطوّرين. نتيجةً لذلك، سنتخطّى الإصدارات 1.5 أو 1.6 التي تم نقلها مباشرةً إلى الإصدار 1.7، وأن الإصدار 1.7.0-alpha01 يحتوي على عمليات التنفيذ هذه.

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

  • ربط مع محتوى: نموذج جديد باسم MapWithContent يتيح استخدام القائمة / الشبكة / اللوحة / الرسالة كمحتوى داخل الخريطة.
    • RoutePreview وPlaceListNavigation، تم إيقاف نماذج "خرائط Google" نهائيًا.
    • تم تعديل نماذج التطبيقات لعرض وظائف النماذج المتوقّفة نهائيًا باستخدام MapWithContent.
  • عنصر المحادثة: واجهات برمجة تطبيقات جديدة لعرض المحادثات (الرسائل الفورية والرسائل القصيرة SMS) وقراءة "مساعد 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 لواجهات برمجة التطبيقات التجريبية: الشارة، وأدوات تحديد حجم الصورة وحجمها GridTemplate، وGridItem طريقة للحصول على الشارة أو ضبطها. (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 comSdk34، الذي لا يزال في حالة مطوّري البرامج. 1.4-الإصدار التجريبي02 سوف يتم حل هذه المشكلة. بدلاً من ذلك، يمكنك إضافة 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 إلى الاستعداد للإصدار القادم من opt01.

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

  • عرض الخريطة من خلال توافق "مجموعة الأدوات" مع تطبيقات التنقّل
  • إضافة علامات تبويب للتطبيقات لتحسين تجربة التنسيق
  • تمت إضافة خيارات عرض نموذج القائمة / الشبكة
  • تمت إضافة فئات جديدة إلى قسم "الطقس" و"الاتصالات".
  • نقل واجهات برمجة التطبيقات المتعددة إلى إصدار 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)
  • يضيف نظام Content ID لعلامة التبويب النشطة إلى TabTemplate ويوقِف الحالة "نشط" نهائيًا في علامات التبويب (I96932).
  • إضافة السمة ItemImageShape إلى GridTemplate (Ibf431)
  • أضِف السمة ItemSize إلى GridTemplate، التي تتحكّم في حجم عناصر الشبكة وفقًا للحِزم النسبية الصغيرة أو المتوسطة أو الكبيرة. (Icdb3b)
  • إتاحة الوصول إلى واجهة برمجة التطبيقات للمطوِّرين من أجل الحصول على نسخة من حزمة الشاشة الحالية (I48107)
  • إضافة فئة لتطبيقات الطقس إلى "مكتبة تطبيقات السيارة" (I2be44)
  • إضافة فئة للاتصال بالتطبيقات إلى مكتبة تطبيقات السيارات (Icab33)
  • تم استبدال GridItem.Builder#setBadge() بطرق setImage() التي تم تحميلها بشكل زائد (Id2000).
  • إضافة خاصية الرمز إلى الشارة (I629b2)
  • إضافة طريقة لضبط لون خلفية شارة النقطة (I6411c)
  • إضافة خاصية الشارة إلى GridItem، ما يسمح بعرض الشارة أعلى صورة GridItem (I95de7)
  • تمت إضافة عنصر "شارة" تجريبي سيمثّل شارة ليتم عرضه فوق الصورة. (I9878d)

الإصدار 1.4.0-alpha01

22 شباط (فبراير) 2023

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

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

  • إضافة إجراءات المستوى الأعلى إلى GridTemplate في مكتبة تطبيقات السيارات (Id0191)
  • إضافة إجراءات المستوى الأعلى إلى "ListTemplate" في "مكتبة تطبيقات السيارة" (I9efab)
  • إضافة ميزات إضافية لربط العنوان الفرعي لعنصر وسائط أو وصفه بعناصر وسائط أخرى (Ic84bf)
  • تحديث مستوى واجهة برمجة التطبيقات لإجراءات الصف إلى المستوى 6. (Ie0a69)
  • إضافة طلبات معاودة الاتصال بالمراسلة إلى A4C (Ie3986)

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

  • إضافة مراجع مستند جافا الناقصة لـ CarMessage (I5db1c)
  • إلغاء equals() وhashCode() في ConversationItem وCarMessage (I6fd10)
  • تحسين التحقق من صحة ConversationItem.mMessages (يجب ملء قيمة غير فارغة أو قيمة غير فارغة (Iafc51)
  • إضافة تعليقات @Keep التوضيحية إلى حقول ConversationItem (I5d250)
  • تعديل مستندات جافا لتصميم الصف والإجراءات الثانوية (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])
  • لا يتم اقتطاع النص الفرعي للسمة Row عند ركن السيارة، ولكن يتم اقتطاعه إلى سطرَين أثناء القيادة. ([API 5 - All Templates])
  • حالة إيقاف الدعم لـ Action وToggle وRow ([API 5 - All Templates])

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

  • تخفيف القيود في قائمة MapTemplate لإتاحة القوائم القابلة للاختيار (I961ed)
  • أزِل قيد إجراءات العناوين للسماح بالرموز المخصصة. (Iad28f)
  • أضِف قيدًا من setOnClickListenerAllowed() إلى ActionsConstraints. حيث تم السماح لـ Action بضبط OnClickDelegate() على إجراءات باستثناء أنواع الرموز العادية. (TYPE_APP_ICON وTYPE_BACK وTYPE_PAN) (I3c745)

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

الإصدار 1.3.0-alpha01

27 تموز (يوليو) 2022

تم طرح الإصدارات androidx.car.app:app:1.3.0-alpha01 وandroidx.car.app:app-projected:1.3.0-alpha01 وandroidx.car.app:app-automotive:1.3.0-alpha01 وandroidx.car.app:app-testing:1.3.0-alpha01. يحتوي الإصدار 1.3.0-alpha01 على هذه عمليات التنفيذ.

تتوافق الميزات التي تتضمّن تعليقات توضيحية من المستوى 5 مع واجهة برمجة التطبيقات مع الإصدار 7.9 من تطبيق Android Auto والإصدارات الأحدث.

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

  • المستوى 5 من واجهة برمجة التطبيقات: MapTemplate جديد يمكن أن تستخدمه تطبيقات التنقّل لعرض اللوحة أو إدراج المحتوى بجانب الخريطة (If5826 وIf44b8)
  • المستوى 5 من واجهة برمجة التطبيقات: واجهة برمجة تطبيقات CarAudioRecord جديدة للسماح بتسجيل إدخال الصوت عبر ميكروفون المركبة المضيفة (I5e71a)
  • المستوى 5 من واجهة برمجة التطبيقات: واجهة برمجة تطبيقات SuggestionManager جديدة للسماح للتطبيقات بتقديم اقتراحات للمضيف (I5c103)
  • المستوى 5 من واجهة برمجة التطبيقات: واجهة برمجة تطبيقات Alert جديدة لعرضها في إشعارات السياق على NavigationTemplate (I163a7 وI5ad70)
  • المستوى 5 من واجهة برمجة التطبيقات: مكوّنات Header وMapController جديدة لتسهيل إعادة استخدام النماذج (If5826)
  • تمت إضافة androidx.car.app.category.POI كفئة لتفعيل تطبيقات نقاط الاهتمام (وتم إيقاف androidx.car.app.category.PARKING وandroidx.car.app.category.CHARGING نهائيًا) (I59da1).

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

  • المستوى 5 من واجهة برمجة التطبيقات: طريقة onClick جديدة في واجهة SurfaceCallback للسماح بالتفاعل مع النقر على الخريطة (Ia9777)
  • المستوى 5 من واجهة برمجة التطبيقات: علامتان جديدتان Action.FLAG_IS_PERSISTENT وAction.FLAG_DEFAULT لوصف Action (I96318 وI5ad70)
  • المستوى 5 من واجهة برمجة التطبيقات: حالة تفعيل/إيقاف جديدة للمكوّنات Action وRow وToggle (تتوفّر دعم المضيف في الإصدار 1.3.0-beta01 للمكتبة) (Id8a09)
  • المستوى 5 من واجهة برمجة التطبيقات: تفضيل المكوِّن Header الجديد عبر setHeader على PlaceListNavigationTemplate.Builder وRoutePreviewNavigationTemplate.Builder، مع إيقاف طريقتي setTitle وsetHeaderAction الحاليتين (I30e6a)
  • المستوى 5 من واجهة برمجة التطبيقات: طريقة setOnContentRefreshListner جديدة على PlaceListMapTemplate.Builder وPlaceListNavigationTemplate.Builder للاستخدام مع عمليات تنفيذ واجهة OnContentRefreshListner الجديدة
  • المستوى 5 من واجهة برمجة التطبيقات: إصدار جديد من setTripText وsetTripIcon على TravelEstimate.Builder لتخصيص بطاقة تقدير السفر (Idcc6d، Ic620d)
  • يمكنك إضافة دعم لـ CarIconSpan في عنوان PaneTemplate (Ia1ee0).
  • يمكنك إضافة دعم لـ CarIconSpan في عنوان ونص Row (Ic1e3c).
  • يمكن أن تتضمّن ActionStrip على الخريطة الآن ما يصل إلى أربعة إجراءات (If3522).
  • تحديث المستوى 5 لواجهة برمجة التطبيقات لتطبيق السيارة (I26b8e)
  • العناوين/العناوين اختيارية الآن لـ PlaceListMapTemplate وPlaceListNavigationTemplate وRoutePreviewNavigationTemplate وGridTemplate وListTemplate وLongMessageTemplate وMessageTemplate وPaneTemplate وSignInTemplate (I2078d وIcadde)

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

  • تم تعديل قواعد PaneTemplate الخاصة بتغيير حجم الصور لتصبح مربّع حدود مربّع (Idd72e).
  • تم إصلاح استثناء يحدث إذا تم تعديل حزمة الشاشة بعد State.DESTROYED. (I3c8eb)
  • تمت إضافة عملية تحقُّق فارغة لاستعادة رمز التطبيق (I3f710).
  • تحديث واجهة برمجة تطبيقات أجهزة السيارة لاستخدام STATUS_UNKNOWN بدلاً من STATUS_UNAVAILABLE تلقائيًا (Ic9444)
  • التحقّق من توفُّر شاشة قبل إنشاء مساحة العرض (Ice027a)
  • إصلاح خطأ في "CarValue.equals()" يشمل STATUS_UNIMPLEMENTED (I24451)

الإصدار 1.2

الإصدار 1.2.0

9 تشرين الثاني (نوفمبر) 2022

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

  • هذا إصدار تثبيت، ولم تطرأ أي تغييرات مقارنةً بالإصدار 1.2.0-rc01.

الإصدار 1.2.0-rc01

23 آذار (مارس) 2022

تم طرح androidx.car.app:app-*:1.2.0-rc01. يحتوي الإصدار 1.2.0-rc01 على هذه عمليات التنفيذ.

  • هذا إصدار تثبيت، ولم تطرأ أي تغييرات على واجهة برمجة التطبيقات مقارنةً بالإصدار v1.2.0-beta02. تمّت إضافة ميزات تجريبية جديدة (المستوى 5 من واجهة برمجة التطبيقات) مخصّصة لإصدارات Android Auto وAndroid Automotive المستقبلية.

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

  • تم إصلاح استثناء يحدث إذا تم تعديل حزمة الشاشة بعد State.DESTROYED. (I3c8eb)
  • تم تعديل واجهة برمجة تطبيقات CarSensors للإشارة إلى أنّه لم يتم تنفيذها في نظام التشغيل AAOS (Idd57b).
  • تم تعديل السمة PlaceListMapTempalte.Builder#setCurrentLocationEnabled للإشارة إلى أنّ ACCESS_COARSE_LOCATION سيكون كافيًا لهذه الميزة (I510c2).
  • تم جعل رقم الخروج اختياريًا لأنواع المناورة ذات زاوية الدوران (Ife7d1).

الإصدار 1.2.0-beta02

26 يناير 2022

تم طرح androidx.car.app:app-*:1.2.0-beta02. يحتوي الإصدار 1.2.0-beta02 على عمليات التنفيذ هذه.

يمكن الآن نشر تطبيقات السيارات التي تم إنشاؤها باستخدام إصدار المكتبة هذا وتستهدف منصة Android Automotive OS على قناة الاختبار المفتوح على "متجر Play". يمكنك الاطّلاع على دليل التطوير للحصول على مزيد من التفاصيل.

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

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

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

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

  • تم إصلاح تسرُّب الذاكرة في CarAppService عندما يلغي مضيف السيارة الربط. (I5c9ca، b/203594731)
  • تم تعديل مستند CarAppActivity javadoc لتضمين متطلبات وضع تشغيل oneTask (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 وإمكانية ضبط تلميحات العرض (مثل العلامات) في Actions.

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

  • في الإصدار Android Auto 7.1 والإصدارات الأحدث، تمت زيادة الحد الأقصى للعناصر المسموح بها في 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 من واجهة برمجة التطبيقات لمكتبة تطبيقات السيارات (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 والإصدارات الأحدث) متوافقة بالكامل مع الإصدار Android Auto 6.7 والإصدارات الأحدث. يمكنك الرجوع إلى دليل التطوير للاطّلاع على مزيد من التفاصيل.

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

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

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

  • تمت إضافة فحص على مستوى واجهة برمجة التطبيقات عند إنشاء CarHardwareManager (I48f9b).
  • تمت إضافة عمليات تحقُّق بشأن الاستخدام غير الصالح لنظام CarSpan في واجهة برمجة التطبيقات (I65ae6).
  • تم إصلاح المشكلة المتمثلة في وضع علامة "مكتمل" على Screen أثناء إنشائها، ما يعني إبقاء الحزمة في حالة معطّلة (I81b13).
  • إصلاح مشكلة تسجيل CarNotificationManager.notify لخطأ في نظام التشغيل Automotive في حال كان هناك إجراءات بالرموز في CarAppExtender (I3633d)
  • تمت إضافة طريقة تأكيد الاتصال لكي يتمكّن التطبيق والمضيف من إنشاء إصدار من واجهة برمجة التطبيقات (I7d6f8).

الإصدار 1.1.0-alpha02

21 يوليو 2021

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

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

  • مستوى واجهة برمجة التطبيقات 3: تمت إضافة CarHardwareManagerيمكن استخدامه لطلب البحث عن البيانات الخاصة بأجهزة المركبة، مثل الطراز والعلامة التجارية ومستويات الوقود وأجهزة الاستشعار الأخرى. في الوقت الحالي، لا تتوفّر هذه الميزة إلا للإصدار Android Auto 6.7 والإصدارات الأحدث في قناة الاختبار المفتوح. يتطلب اختبار ذلك في بيئة سطح المكتب إصدارًا جديدًا من Desktop Head Unit سيتم إصداره بشكل منفصل. يمكنك متابعتنا على صفحة اختبار تطبيقات Android للسيارات للحصول على تفاصيل حول موعد توفُّر الإصدار الجديد.
  • يمكنك اتّباع دليل التطوير ومرجع المكتبة للحصول على تفاصيل إضافية وإرشادات تصميم حول كيفية استخدام هذه الميزات في مضيفي السيارات المتوافقة مع المستوى 3 من واجهة برمجة التطبيقات.

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

  • دمج طريقتَي مراحل النشاط SessionController وScreenController في طريقة moveToState واحدة (I1ed00)
  • تمت إضافة CarContext#getHostInfo() (I8977e)
  • تمت إزالة الحقول المتوقّفة. (I67168)
  • تم تحديث SessionController وScreenController لكشف الصيغ الإنشائية مباشرةً (Iabf22)
  • تمت إزالة "PinSignInMethod.Builder" و"ProviderSignInMethod.Builder" (I9f0cb)
  • تمت إضافة 'setCarAppResult() لتفعيل استخدام التطبيقات المستنِدة إلى نماذج "للنتيجة" في AAOS (I37741).
  • تمت إضافة تعليقات توضيحية على واجهات CarHardware باستخدام @MainThread. (Ib2f85)
  • تمت إعادة تسمية "OnCarDataListener" إلى "OnCarDataAvailableListener" (I518ca)
  • تم تعديل أسماء الطُرق CarInfo وSpeed وMileage وJavadoc. (I86672)
  • تمت إعادة تسمية "Toll" إلى "TollCard". (I3e7c8)
  • تمت إزالة PinSignInMethod.getPin المتوقّفة والتي تم استبدالها بـ PinSignInMethod.getPinCode (I996ce)
  • تمت إزالة OnInputCompletedListener (تم استبداله بـ InputCallback). (Ib5be1)
  • تم تغيير PinSignInMethod ليصبح CharSequence بدلاً من String (I275d5).

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

  • إصلاحات Javadoc لأجهزة السيارة. (I2abbc)

مساهمة خارجية

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

  • وفي SignInTemplate، قد يؤدي استخدام InputSignInMethod إلى ظهور NullPointerException في مضيف السيارة. ستتم معالجة هذا الأمر في الإصدار التالي من المكتبة. لحلّ هذه المشكلة، عليك تضمين هذا السطر في إعدادات Proguard لتطبيقك: -keep class androidx.car.app.model.signin.InputSignInMethod { *; }

الإصدار 1.1.0-alpha01

16 حزيران (يونيو) 2021

تم طرح الإصدارات androidx.car.app:app:1.1.0-alpha01 وandroidx.car.app:app-automotive:1.1.0-alpha01 وandroidx.car.app:app-testing:1.1.0-alpha01. يحتوي الإصدار 1.1.0-alpha01 على عمليات التنفيذ هذه.

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

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

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

  • تم جعل جميع طرق الواجهة *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 من واجهة برمجة تطبيقات السيارة) (Ic5cee).

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

  • تم تعديل متطلبات حجم الصورة لمراعاة شاشات السيارات الأكبر حجمًا (I116dc)
  • غير مسموح بإضافة أكثر من إجراءين في نصوص النموذج (I32157)
  • تم التأكّد من وضع علامات على كل عمليات إنشاء PendingIntent في مكتبة تطبيقات السيارة. (If84fe، وb/186394900)
  • تم تعديل javadoc للسماح بتغيير نص Row كعمليات إعادة تحميل (If3f9c)
  • أصبحت androidx.activity:activity:1.2.0 الآن تبعية لواجهة برمجة التطبيقات (Id1cb9)
  • تم إنشاء SignInTemplate وLongMessageTemplate لطلب إجراءات ركن السيارة فقط في جسمه وتعديل المستندات للإشارة إلى أنّه ستظهر فقط عند ركن السيارة (Iddaa9).
  • تم إصلاح استثناء يحدث عند ظهور Screen أثناء البدء (Ifcf40 وb/184664896)
  • تم السماح بلون النص المخصص في ForegroundCarColorSpan (I69e59)
  • تم إصلاح مشكلة رصد العلامة ON_DESTROY على Session بعد ON_DESTROY على Screen (I52e01، b/183696617).
  • يُسمح بتعديل javadoc عند ضبط الوقت المتبقي لـ TravelEstimate على وقت غير معروف. (I99610، b/183632456)
  • تم تحديث Action للتوافق مع ForegroundColorSpan في العنوان وأي لون خلفية مخصص (I578e4)
  • لا تنفِّذ NavigationManagerCallback#onStopNavigation إذا تم محو طلب الاستدعاء قبل تنفيذ المُنفِّذ (I7fc5e، b/181143772)
  • تم إصلاح مشكلة تتطلب أن يعتمد التطبيق صراحةً على lifecycle-common-java8 (I8b8c8)

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

  • في SignInTemplate، تعرض لوحة المفاتيح على الشاشة رمز "بحث" بدلاً من رمز "Enter" عندما يريد المستخدم تأكيد الإدخال. وكحل بديل، يمكن للمستخدمين الوصول إلى لوحة مفاتيح الهاتف التي يتم تنشيطها عندما يكون حقل الإدخال محل التركيز.
  • في الإصدار 6.5 من Android Auto، قد يتم استدعاء ميزة "التحريك والتكبير/التصغير" في SurfaceCallback بشكل غير صحيح لبعض إيماءات اللمس.

الإصدار 1.0.0 لاختبار تطبيق السيارات

الإصدار 1.0.0-alpha01

24 آذار (مارس) 2021

تم طرح androidx.car.app:app-testing:1.0.0-alpha01. يحتوي الإصدار 1.0.0-alpha01 على عمليات التنفيذ هذه.

هذا هو الإصدار الأول من Jetpack لمكتبة الاختبار المغلق المصدر سابقًا. ويمكنك الرجوع إلى النماذج لمعرفة كيفية استخدام هذه المكتبة في اختباراتك.

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

  • تمت إزالة وحدات التحكّم في فئات النماذج. أصبحت أدوات الحصول على النماذج الآن جزءًا من مساحة واجهة برمجة التطبيقات العامة التي تسمح بالتحقق من صحة القيم التي تم ضبطها في أدوات الإنشاء.
  • تم استبدال CarAppServiceController السابق بـ SessionController الجديد لاختبار المنطق المرتبط طوال فترة الاتصال بالنقاط الساخنة.

الإصدار 1.0.0

الإصدار 1.0.0

21 نيسان (أبريل) 2021

تم طرح androidx.car.app:app:1.0.0. يحتوي الإصدار 1.0.0 على عمليات الالتزام هذه.

الميزات الرئيسية للإصدار 1.0.0

  • في أوائل نيسان (أبريل)، أعلنّا أنّه أصبح بإمكان التطبيقات البدء بالنشر على قناة الإنتاج باستخدام "androidx.car.app:app:1.0.0-rc01". أصبح الإصدار 1.0.0 من Car App Library ثابتًا الآن ومتوافقًا تمامًا مع Android Auto 6.1 والإصدارات الأحدث.
  • يمكنك اتّباع دليل التطوير للحصول على تفاصيل حول كيفية إنشاء تطبيقات التنقّل ومواقف السيارات والشحن لنظام Android Auto باستخدام المكتبة.

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

  • تم إصلاح استثناء يحدث عند ظهور Screen أثناء البدء (70aae1، b/184664896)
  • تم إصلاح مشكلة رصد العلامة ON_DESTROY على Session بعد ON_DESTROY على Screen (0ceecb، وb/183696617).

الإصدار 1.0.0-rc01

24 آذار (مارس) 2021

تم طرح androidx.car.app:app:1.0.0-rc01. يحتوي الإصدار 1.0.0-rc01 على هذه عمليات التنفيذ.

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

  • تم إصلاح خطأ حالة السباق حيث تم استدعاء "NavigationManagerCallback#onStopNavigation" بعد محو معاودة الاتصال. حدث ذلك في حال محو معاودة الاتصال قبل التشغيل الفعلي لتنفيذ معاودة الاتصال (I7fc5e، b/181143772).
  • تم إصلاح مشكلة تتطلب أن يعتمد التطبيق صراحةً على lifecycle-common-java8 (I8b8c8).
  • تم إصلاح NullPointerException الذي تم عرضه عندما يتلقّى التطبيق مكالمة stopNavigation عندما يكون قد أزال معاودة الاتصال (Ib8b89، b/181143772).
  • تحسينات على عدم إرسال المكالمات إلى التطبيق إذا لم تكن دورة حياته على الأقل في حالة CREATED (I86965، b/179800224، b/177921120)
  • تم إصلاح مشكلة ظهور واجهة برمجة تطبيقات دقيقة غير صالحة تم تحديدها في ملف بيان التطبيق، ما يؤدي إلى حدوث خطأ ANR على المضيف. (Iffedd، b/174231592)

الإصدار 1.0.0-beta01

24 شباط (فبراير) 2021

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

هذا هو الإصدار الأول من Jetpack لمكتبة المصادر المغلقة سابقًا، وهو متوافق مع الإصدار Android Auto 6.1 أو الإصدارات الأحدث. يمكنك اتّباع دليل التطوير للاطّلاع على تفاصيل حول كيفية إنشاء تطبيقات السيارات باستخدام المكتبة.

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

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

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

  • تم إصلاح مشكلة استئناف Screen الخاطئ عند ظهور الشاشات بشكل تسلسلي. (b/177590791)