اپلیکیشن ماشین

برنامه‌های قالب‌بندی شده برای Android Auto و Android Automotive OS بسازید.
آخرین به روز رسانی انتشار پایدار کاندید را آزاد کنید نسخه بتا انتشار آلفا
13 نوامبر 2024 1.4.0 - 1.7.0-beta03 -

اعلام وابستگی ها

برای افزودن وابستگی به کتابخانه برنامه خودرو، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Maven Google را بخوانید.

وابستگی‌های مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

شیار 

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

کاتلین

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

13 نوامبر 2024

یک آسیب پذیری امنیتی و سایر رفع اشکالات عمومی رفع شد. اگر از نسخه پایین تر استفاده می کنید، لطفاً برای استفاده از این نسخه به روز رسانی کنید .

androidx.car.app:app-*:1.7.0-beta03 منتشر شد. نسخه 1.7.0-beta03 حاوی این تعهدات است.

تغییرات API

  • کد CAL Serialization / De-Serialization را به‌روزرسانی کنید تا فقط به اشیایی رسیدگی کند که حاشیه‌نویسی @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, -Xtype-enhancement-improvements-strict-mode . ( Ib5367 , b/326456246 )

نسخه 1.7.0-beta02

18 سپتامبر 2024

androidx.car.app:app-*:1.7.0-beta02 منتشر شد. نسخه 1.7.0-beta02 حاوی این تعهدات است.

تغییرات API

  • اضافه کردن KEY_ROOT_HINT_MEDIA_HOST_VERSION اضافی ( I8796b )
  • کلاس TabContents.Api8Builder با سازنده @ExperimentalCarApi در کلاس TabContents.Builder جایگزین کنید ( I26fbe )
  • افزودن اکشن قصد و موارد اضافی برای CarMediaApp ( I50782 )
  • علامت‌گذاری APIهای پیام‌رسان به‌عنوان غیرتجربی ( I0b070 )
  • بارگیری از راه دور مورد را به SectionedItemTemplate اضافه کنید (به لیست های طولانی اجازه می دهد بدون خراب شدن بارگیری شوند) ( I0d122 )
  • SectionedItemTemplate به لیست الگوهای پشتیبانی شده در TabTemplate در API 8 اضافه کنید. ( Idc5d6 )

رفع اشکال

  • طرح دستی دسترسی به APIهای پلتفرم جدید حذف شد زیرا این به طور خودکار از طریق مدلسازی API هنگام استفاده از R8 با AGP 7.3 یا جدیدتر (مثلا R8 نسخه 3.3) و برای همه ساخت‌ها هنگام استفاده از AGP 8.1 یا بالاتر (به عنوان مثال D8 نسخه 8.1) اتفاق می‌افتد. به مشتریانی که از 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 را به جای الگوهای منسوخ نشان دهند
  • مورد مکالمه: APIهای جدید برای نمایش مکالمات (IM، SMS) و بازخوانی دستیار در ماشین.
  • ابعاد خودرو: API جدید برای بازیابی معیارهای خودرو (داده‌های AAOS در حال حاضر).

تغییرات API

  • تگ @ExperimentalCarApi را به MediaPlaybackTemplate.Builder اضافه کنید. ( IC1957 )
  • یک SectionedItemTemplate جدید در آزمایشی اضافه می کند. ( I5958a )
  • معرفی CarAppApiLevel 8 ( I3fa22 )
  • MediaPlaybackTemplate برای نمایش محتوا در حین پخش رسانه در کتابخانه برنامه خودرو اضافه می کند. ( I3c10d )
  • Api جدید برای برنامه‌ها اضافه شد تا تشخیص دهد آیا سیستم از صدای پس‌زمینه هنگام رانندگی پشتیبانی می‌کند ( I0f868 )

رفع اشکال

  • موارد خاصی از نشت و خرابی حافظه را در کد سرویس گیرنده CAL و در برنامه نمونه ناوبری CAL برطرف می کند. ( I55e04 )
  • برای جلوگیری از خرابی، requireNotNull instances در متد onDestroy BaseCarAppActivity با بررسی های if-null جایگزین کنید. ( Iec676 )

نسخه 1.7.0-alpha02

17 آوریل 2024

androidx.car.app:app-*:1.7.0-alpha02 منتشر شد. نسخه 1.7.0-alpha02 حاوی این تعهدات است.

ویژگی های جدید

  • پرچم‌های منسوخ شده برای الگوهای مبتنی بر نقشه اضافه شد که الگوی MapWithContent به حرکت رو به جلو کمک می‌کند.

تغییرات API

  • منسوخ کردن 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 ، Map اکنون منسوخ شده‌اند.
    • برنامه های نمونه به روز شده اند تا عملکرد الگوهای منسوخ شده را با استفاده از MapWithContent نشان دهند.
  • مورد مکالمه : APIهای جدید برای نمایش مکالمات (IM، SMS) و بازخوانی دستیار در ماشین.
  • ابعاد خودرو : API جدید برای بازیابی اندازه‌گیری‌های خودرو (داده‌های AAOS در حال حاضر).

تغییرات API

  • علامت گذاری نوع تصویر ردیف کوچک اضافی به عنوان آزمایشی ( I5184b )
  • API CarInfo#fetchExteriorDimensions اضافه شد که امکان دسترسی به اطلاعات ابعاد بیرونی خودرو مانند ارتفاع، عرض و غیره را فراهم می‌کند ( Ia40c5 )
  • برچسب ExperimentalAPI از MapWithContentTemplate ( I66db8 ) حذف شد
  • پارامتر GridItem#setTitle را برای پوچ شدن به روز کنید. ( I3d610 )
  • GetHeader API به API 7 نیاز ندارد زیرا با نسخه قبلی سازگار است ( I8c812 )
  • پشتیبانی از Header در ListTemplate اضافه کنید، headerAction منسوخ کنید، headerTitle ، actionStrip ( I7ae01 )
  • title , headerAction , actionStrip را در GridTemplate حذف کنید و پشتیبانی از Header را اضافه کنید ( I41a9c )
  • سطح 7 مورد نیاز برای APIهای آزمایشی را حذف کنید: نشان، اندازه آیتم GridTemplate و شکل تصویر گیرنده/تنظیم کننده، روش GridItem برای گرفتن/تنظیم نشان. ( ID71eb )
  • حذف title ، headerAction ، actionStrip در PaneTemplate ، افزودن پشتیبانی جدید Header ( I23154 )
  • تله متری Media Center را از BroadcastReceiver به Browse Custom Action تغییر داد. ( 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 حاوی این commit ها است. . فقط اصلاحات جزئی

رفع اشکال

  • javadoc را در ConversationItem به روز کنید تا بیان کنید که پیام ها باید به ترتیب از قدیمی ترین به جدیدترین مرتب شوند ( I77a2a )
  • منطق کوتاه کردن ListTemplate را به روز کنید تا قدیمی ترین پیام ها را از ConversationItem حذف کنید ( Ie0a61 )

نسخه 1.4.0-rc01

1 نوامبر 2023

androidx.car.app:app-*:1.4.0-rc01 بدون هیچ تغییر قابل توجهی منتشر شد. نسخه 1.4.0-rc01 حاوی این commit ها است. .

نسخه 1.4.0-beta02

20 سپتامبر 2023

androidx.car.app:app-*:1.4.0-beta02 منتشر شد. نسخه 1.4.0-beta02 حاوی این تعهدات است. . این تقریباً مشابه beta01 است، اما نیاز compileSdk را به 33 کاهش می دهد.

رفع اشکال

  • رفع اشکالی که در آن صفحه های بارگیری در Tabs به درستی نمایش داده نمی شوند. ( 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 پروژه خود اضافه کنید تا به طور موقت هشدار را سرکوب کنید.

ویژگی های جدید

تغییرات API

  • آلفا02 را ببینید

نسخه 1.4.0-alpha02

26 جولای 2023

androidx.car.app:app-*:1.4.0-alpha02 منتشر شد. نسخه 1.4.0-alpha02 حاوی این commit ها است.

  • انتشار Alpha02 در نظر گرفته شده است تا آماده سازی برای انتشار آینده beta01 باشد.

ویژگی های جدید

  • ارائه نقشه در پشتیبانی از Instrument Cluster برای برنامه های ناوبری
  • برای بهبود تجربه چیدمان، برگه هایی برای برنامه ها اضافه شد
  • گزینه های رندر قالب فهرست / شبکه اضافه شد
  • دسته بندی های جدید برای آب و هوا و Comms اضافه شده است
  • چندین API را به نسخه بعدی CarApi 7 منتقل کنید

تغییرات API

  • افزودن فیلدهای چندرسانه ای به CarMessage ( I5aaf6 )
  • اقدامات سفارشی را به ConversationItem در کتابخانه برنامه خودرو اضافه می کند ( Ie5ed6 )
  • اضافه کردن موارد اضافی برای نشان دادن اینکه یک آیتم رسانه ای با فرمت صوتی همهجانبه پخش می شود و نشان دادن قالب محتوای آن ( Icb5bb )
  • برای پشتیبانی از دکمه نوشتن، نوع اقدام جدید، ActionsConstraints API را اضافه کنید. ( I31661 )
  • ساخته شده set/getTemplate به عنوان set/get ContentTemplate ( Ica036 )
  • پارامتر الگو اکنون @NonNull خواهد بود. اسناد MapWithContentTemplate API به روز شده ( I0f8ed )
  • برچسب @ExperimentalCarApi را برای Actions در ListTemplate برای راه اندازی در CAL 1.4 ( I2cfcb ) حذف می کند.
  • برچسب @ExperimentalCarApi را برای TabTemplate ( Ifcb82 ) حذف می کند
  • حاشیه‌نویسی‌های @ExperimentalCarApi را از اقدامات و تزئینات ثانویه ردیف حذف کنید ( I8487e )
  • شناسه محتوای برگه فعال را به TabTemplate اضافه می کند و وضعیت فعال را در Tabs منسوخ می کند ( I96932 )
  • افزودن ویژگی ItemImageShape به GridTemplate ( Ibf431 )
  • ویژگی ItemSize به GridTemplate اضافه کنید، که اندازه آیتم های شبکه را بر اساس سطل های کوچک، متوسط ​​و بزرگ کنترل می کند. ( Icdb3b )
  • دسترسی API را برای توسعه دهندگان باز کنید تا یک کپی از پشته صفحه فعلی به دست آورند. ( I48107 )
  • دسته بندی برنامه های آب و هوا را به کتابخانه برنامه خودرو ( I2be44 ) اضافه می کند
  • دسته‌ای را برای تماس با برنامه‌ها به کتابخانه برنامه خودرو ( Icab33 ) اضافه می‌کند
  • جایگزین GridItem.Builder#setBadge() با متدهای setImage() بارگذاری شده ( Id2000 )
  • افزودن ویژگی نماد به نشان ( I629b2 )
  • افزودن روش برای تنظیم رنگ پس‌زمینه نشان نقطه ( I6411c )
  • ویژگی Badge را به GridItem اضافه کنید تا نشانی در بالای تصویر GridItem نمایش داده شود. ( I95de7 )
  • یک شیء نشان آزمایشی اضافه شد که نشان‌دهنده نشانی است که روی یک تصویر نمایش داده می‌شود. ( I9878d )

نسخه 1.4.0-alpha01

22 فوریه 2023

androidx.car.app:app-*:1.4.0-alpha01 منتشر شد. نسخه 1.4.0-alpha01 حاوی این commit ها است.

تغییرات API

  • اقدامات سطح بالا را به GridTemplate در کتابخانه برنامه خودرو اضافه می کند ( Id0191 )
  • اقدامات سطح بالا را به ListTemplate در کتابخانه برنامه خودرو ( I9efab ) اضافه می کند
  • افزودن موارد اضافی برای پیوند دادن زیرنویس یک مورد رسانه یا توضیحات آن به سایر موارد رسانه ( Ic84bf )
  • به‌روزرسانی سطح api برای عملکردهای ردیف به سطح 6. ( Ie0a69 )
  • افزودن تماس های پیام رسانی به A4C ( Ie3986 )

رفع اشکال

  • ارجاعات جاوا doc از دست رفته را برای CarMessage اضافه کنید. ( I5db1c )
  • برای ConversationItem و CarMessage equals() و hashCode() را لغو کنید ( 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 حاوی این commit ها است.

  • رفع اشکال جزئی از beta01. بدون تغییرات عمده

نسخه 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 حاوی این تعهدات است.

ویژگی های جدید

علاوه بر قابلیت‌های اضافه شده در Car App Library 1.3.0-alpha01، ویژگی‌های زیر به عنوان بخشی از beta01 اضافه شده‌اند (همه ویژگی‌ها در اینجا فقط شامل تغییرات سمت میزبان بدون هیچ تغییری در API هستند):

  • نوار پیمایش شناور حتی زمانی که کاربر در یک صفحه انتخاب مبتنی بر نقشه در PlaceListNavigationTemplate ، RoutePreviewNavigationTemplate و MapTemplate باشد، همچنان نشان داده می شود. این را می توان با به روز رسانی اطلاعات ناوبری از طریق NavigationManager.updateTrip() انجام داد.
  • دکمه اکشن را با FLAG_DEFAULT فعال کنید تا انیمیشن زمان‌بندی داشته باشید. این دکمه به طور پیش فرض پس از اتمام زمان کلیک می شود. ( [API 5 - All Templates] )
  • زیرمتن Row در هنگام پارک خودرو کوتاه نمی شود، اما هنگام رانندگی به 2 خط کوتاه می شود. ( [API 5 - All Templates] )
  • پشتیبانی از حالت غیرفعال برای Action ، Toggle ، Row ( [API 5 - All Templates] )

تغییرات API

  • برای پشتیبانی از لیست‌های قابل انتخاب، محدودیت‌ها را در فهرست MapTemplate کاهش دهید ( I961ed )
  • محدودیت Header Actions را حذف کنید تا آیکون های سفارشی مجاز شوند. ( 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 حاوی این commit ها است.

ویژگی های حاشیه نویسی شده با API سطح 5 با Android Auto نسخه 7.9 و بالاتر سازگار است.

ویژگی های جدید

  • API Level 5: MapTemplate جدید که می تواند توسط برنامه های ناوبری برای نمایش صفحه یا فهرست محتوا در کنار نقشه استفاده شود ( If5826 ، If44b8 )
  • API Level 5: CarAudioRecord API جدید برای امکان ضبط ورودی صدا از طریق میکروفون خودروی میزبان ( I5e71a )
  • API Level 5: SuggestionManager API جدید که به برنامه‌ها اجازه می‌دهد پیشنهاداتی را به میزبان ارائه کنند ( I5c103 )
  • API سطح 5: API Alert جدید برای نمایش در اعلان‌های زمینه در NavigationTemplate ( I163a7 ، I5ad70 )
  • API Level 5: کامپوننت های Header و MapController جدید برای تسهیل استفاده مجدد در قالب ها ( If5826 )
  • androidx.car.app.category.POI به عنوان دسته ای برای فعال کردن برنامه های POI اضافه شد (و androidx.car.app.category.PARKING و androidx.car.app.category.CHARGING منسوخ شده) ( I59da1 )

تغییرات API

  • API Level 5: روش جدید onClick در رابط SurfaceCallback برای امکان ضربه زدن بر روی نقشه تعاملی ( Ia9777 )
  • API سطح 5: پرچم‌های جدید Action.FLAG_IS_PERSISTENT و Action.FLAG_DEFAULT برای توصیف Action ( I96318 ، I5ad70 )
  • API سطح 5: وضعیت جدید فعال/غیرفعال برای مؤلفه‌های Action ، Row و Toggle (پشتیبانی میزبان در نسخه 1.3.0-beta01 کتابخانه) ( Id8a09 )
  • API Level 5: از طریق setHeader در PlaceListNavigationTemplate.Builder و RoutePreviewNavigationTemplate.Builder از مؤلفه Header جدید استفاده کنید، و متدهای setTitle و setHeaderAction موجود را منسوخ کنید ( I30e6a )
  • API سطح 5: روش جدید setOnContentRefreshListner در PlaceListMapTemplate.Builder و PlaceListNavigationTemplate.Builder برای استفاده با پیاده سازی رابط OnContentRefreshListner جدید.
  • API سطح 5: setTripText و setTripIcon جدید در TravelEstimate.Builder برای سفارشی کردن کارت برآورد سفر ( Idcc6d ، Ic620d )
  • اضافه کردن پشتیبانی از CarIconSpan در عنوان PaneTemplate ( Ia1ee0 )
  • اضافه کردن پشتیبانی برای عنوان و متن CarIconSpan s in a Row ( Ic1e3c )
  • Map ActionStrip اکنون می تواند تا چهار عمل داشته باشد ( If3522 )
  • به‌روزرسانی سطح API Car App به 5 ( I26b8e )
  • سرصفحه‌ها/عناوین اکنون برای PlaceListMapTemplate ، PlaceListNavigationTemplate ، RoutePreviewNavigationTemplate ، GridTemplate ، ListTemplate ، LongMessageTemplate ، MessageTemplate ، PaneTemplate، PaneTemplate ، و SignInTemplate ، اختیاری هستند. Icadde )

رفع اشکال

  • قوانین اندازه‌گیری تصویر PaneTemplate به‌روزرسانی شد تا کادر مربعی محدود شود ( Idd72e )
  • رفع یک استثنا که اگر پشته صفحه بعد از State.DESTROYED اصلاح شود، اتفاق می افتد. ( I3c8eb )
  • یک بررسی تهی برای بازیابی نماد برنامه اضافه شد ( I3f710 )
  • به‌روزرسانی 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 حاوی این commit ها است.

  • این نسخه تثبیت کننده است و هیچ تغییری در مقایسه با v1.2.0-rc01 وجود ندارد.

نسخه 1.2.0-rc01

23 مارس 2022

androidx.car.app:app-*:1.2.0-rc01 منتشر شد. نسخه 1.2.0-rc01 حاوی این commit ها است.

  • این یک نسخه تثبیت‌کننده است و هیچ تغییری در API در مقایسه با v1.2.0-beta02 وجود ندارد. ویژگی های آزمایشی جدیدی (سطح API 5) اضافه شده است که برای نسخه های آینده Android Auto و Android Automotive در نظر گرفته شده است.

رفع اشکال

  • رفع یک استثنا که اگر پشته صفحه بعد از State.DESTROYED اصلاح شود، اتفاق می افتد. ( I3c8eb )
  • CarSensors API را به‌روزرسانی کرد تا نشان دهد که برای 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 منتشر شوند. برای جزئیات بیشتر به راهنمای توسعه مراجعه کنید.

ویژگی های حاشیه نویسی شده با API سطح 4 و پایین تر، هم با Android Auto نسخه 7.2 و بالاتر و هم با سیستم عامل Android Automotive OS جدید سازگار است. برای هشدارها، بخش Known Issues را در زیر ببینید.

تغییرات API

  • API آزمایشی setOnContentRefreshListener به الگوهای POI اضافه شد ( I6bf22 )

رفع اشکال

  • رفع نشت حافظه در CarAppService هنگام باز شدن اتصال میزبان خودرو. ( I5c9ca , b/203594731 )
  • CarAppActivity javadoc به‌روزرسانی شد تا شامل موارد مورد نیاز برای حالت راه‌اندازی 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 حاوی این commit ها است.

ویژگی های حاشیه نویسی شده با API سطح 4 از آزمایشی به پایدار ارتقا یافته است، از جمله نقشه ActionStrip s در PlaceListNavigationTemplate و RoutePreviewNavigateTemplate ، تصویر CarIcon در Pane s، QRCodeSignInMethod و توانایی تنظیم نشانه های Action (eg)

ویژگی های جدید

  • در Android Auto نسخه 7.1+، محدودیت مورد برای Pane از 2 به 4 افزایش یافته است.

تغییرات API

  • یک متد آزمایشی 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 حاوی این commit ها است.

همه ویژگی‌های جدید v1.2.0 (API 4+) در حال حاضر آزمایشی هستند و نسخه‌های آینده Android Auto و Android Automotive OS را هدف قرار می‌دهند. برای جزئیات بیشتر به راهنمای توسعه مراجعه کنید.

تغییرات API

  • AutomotiveCarInfo API آزمایشی ساخته شده است. ( Ia13e5 )
  • اضافه شده Car App Library API سطح 4 ( I2a2e7 )
  • API Level 4: پشتیبانی اضافه شده برای تنظیم CarIcon در Pane ( Ifcc12 )
  • API سطح 4: اضافه شدن روش ورود کد QR ( Ib623e )
  • API Level 4: Set/getFlags به Action اضافه شد ( Ic03ab )
  • API Level 4: اضافه شدن پشتیبانی برای جابجایی و بزرگنمایی در PlaceListNavigationTemplate و RoutePreviewNavigationTemplate ( I9d8a3 )

رفع اشکال

  • API سطح 4: مکانیسمی را اضافه کنید تا به برنامه‌ها اجازه دهید به‌روزرسانی‌های مکان را به میزبان خودرو ارسال کنند ( I3bad3 )
  • رفع مشکلی که در آن منطق اعتبار سنجی میزبان مجوز TEMPLATE_RENDERER را به درستی پیدا نمی کرد ( I62618 )

نسخه 1.1.0

نسخه 1.1.0

15 دسامبر 2021

androidx.car.app:app-*:1.1.0 منتشر شد. نسخه 1.1.0 حاوی این commit ها است.

این یک نسخه تثبیت کننده است و هیچ تغییری در مقایسه با v1.1.0-rc01 وجود ندارد. همچنین برای جزئیات بیشتر در مورد ویژگی های جدید کتابخانه برنامه ماشین، یادداشت های انتشار v1.2.0-alpha02 را ببینید.

تغییرات مهم از 1.0.0

  • API Level 2: SignInTemplate و LongMessageTemplate که می توانند برای جریان های ورود به سیستم زمانی که خودرو پارک شده است استفاده شود
  • API Level 2: پشتیبانی از تعامل نقشه در NavigationTemplate
  • API Level 2: پشتیبانی از متن با طول چندگانه به برنامه ها اجازه می دهد تا بسته به اندازه صفحه نمایش خودرو، چندین نسخه از رشته را برای نمایش ارائه دهند.
  • API Level 3: CarHardwareManager که می تواند برای استعلام داده های سخت افزاری خودرو، مانند مدل و ساخت، سطح سوخت و سایر حسگرها استفاده شود.

نسخه 1.1.0-rc01

3 نوامبر 2021

androidx.car.app:app-*:1.1.0-rc01 منتشر شد. نسخه 1.1.0-rc01 حاوی این commit ها است.

این یک نسخه تثبیت‌کننده است و هیچ تغییری در API در مقایسه با v1.1.0-beta01 وجود ندارد. ویژگی‌های آزمایشی جدیدی (سطح API 4) اضافه شده است که برای نسخه‌های آینده Android Auto در نظر گرفته شده است. برای جزئیات بیشتر در مورد APIهای آزمایشی، به یادداشت‌های انتشار 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 (API 2+) کاملاً با Android Auto نسخه 6.7 و بالاتر سازگار هستند. برای جزئیات بیشتر به راهنمای توسعه مراجعه کنید.

تغییرات API

  • Manager حذف شده به عنوان یک رابط عمومی ( Ie381b )
  • اضافه شدن قابلیت تنظیم یک پس‌زمینه مارک سفارشی برای درخواست مجوز ( I74b76 )
  • ScreenManager.getStackSize ( I0b16a ) اضافه شد
  • سازنده ScreenController حذف شد که به طور واضح TestCarContext را می گیرد ( Iefebc )

رفع اشکال

  • اضافه شدن بررسی سطح API هنگام ایجاد CarHardwareManager ( I48f9b )
  • بررسی هایی برای استفاده نامعتبر CarSpan در سراسر API اضافه شد ( I65ae6 )
  • مشکلی را برطرف کرد که در آن اگر یک Screen در حین ایجاد آن به‌عنوان تمام‌شده علامت‌گذاری شود، پشته را در حالت شکسته رها می‌کند ( I81b13 )
  • رفع مشکلی که در آن CarNotificationManager.notify در صورت وجود کنش‌هایی با نمادها در CarAppExtender ( I3633d ) خطایی را برای AutomotiveOS ثبت می‌کند.
  • یک روش دست دادن برای برنامه و میزبان برای ایجاد یک نسخه API اضافه شده است ( I7d6f8 )

نسخه 1.1.0-alpha02

21 جولای 2021

androidx.car.app:app-*:1.1.0-alpha02 منتشر شد. نسخه 1.1.0-alpha02 حاوی این commit ها است.

ویژگی های جدید

  • API Level 3: CarHardwareManager اضافه شده است که می تواند برای استعلام داده های سخت افزاری خودرو، مانند مدل و ساخت، سطح سوخت و سایر حسگرها استفاده شود. در حال حاضر، این ویژگی فقط برای Android Auto نسخه 6.7 و بالاتر در کانال تست باز موجود است. آزمایش این مورد در محیط دسکتاپ به نسخه جدیدی از Desktop Head Unit نیاز دارد که به طور جداگانه منتشر خواهد شد. برای اطلاع از جزئیات زمان عرضه نسخه جدید، در صفحه تست برنامه های اندروید برای اتومبیل ها همراه باشید.
  • راهنمای توسعه و مرجع کتابخانه را برای جزئیات بیشتر و دستورالعمل‌های طراحی در مورد نحوه استفاده از این ویژگی‌ها در میزبان‌های خودرویی که با سطح API 3 سازگار هستند، دنبال کنید.

تغییرات API

  • متدهای چرخه عمر 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 )

رفع اشکال

  • اصلاحات جاوادوک برای سخت افزار ماشین. ( 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 حاوی این commit ها است.

ویژگی های جدید

  • API Level 2: SignInTemplate و LongMessageTemplate جدید که می تواند برای جریان های ورود به سیستم زمانی که خودرو پارک شده است استفاده شود.
  • API Level 2: پشتیبانی از تعامل نقشه جدید در NavigationTemplate
  • API Level 2: پشتیبانی از متن چندطول جدید که به برنامه‌ها اجازه می‌دهد تا بسته به اندازه صفحه‌نمایش خودرو، چندین نسخه از رشته را برای نمایش ارائه کنند.
  • راهنمای توسعه و کتابخانه Javadoc را برای جزئیات بیشتر و دستورالعمل‌های طراحی در مورد نحوه استفاده از این ویژگی‌ها در میزبان‌های خودرویی که با API سطح 2 سازگار هستند، دنبال کنید.

تغییرات API

  • همه روش‌های واسط *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 )
  • کلید ابرداده به روز شده برای تعریف حداقل سطح API خودرو به androidx.car.api.minCarApiLevel ( Ib0d41 )
  • یک API ایجاد کرد که امکان مشاهده وضعیت اتصال خودرو را فراهم می کند ( Ifc935 )
  • اضافه شدن پشتیبانی برای تنظیم یک ضامن برای یک Action ، و اضافه شدن حالت پان نوع Action ( Ica6af )
  • CarNotificationManager برای پشتیبانی از ارسال اعلان در خودرو ایجاد کرد ( I10d7a )
  • ConstraintManager برای ارائه محدودیت های لیست از میزبان اضافه شد ( I8690e )
  • اضافه شدن حالت پان و API نوار عملکرد نقشه در NavigationTemplate ( I77aa6 )
  • اضافه شدن پان و زوم API در SurfaceCallback برای برنامه های ناوبری ( Id5e9d )
  • به روز رسانی CarAppApiLevel به 2 ( IC1540 )
  • اضافه شدن قابلیت درخواست مجوز از CarAppService ( I5421e )
  • اضافه شدن حاشیه نویسی RequiresCarApi(2) به API چند متنی ( Iacb62 )
  • چندین نوع متن مجاز در عنوان الگوی نیم‌فهرست ( Ib8df7 )
  • LongMessageTemplate جدید اضافه شد (به سطح 2 Car API نیاز دارد) ( Ic5cee )

رفع اشکال

  • اندازه تصویر مورد نیاز برای در نظر گرفتن صفحه نمایش بزرگتر خودرو ( I116dc )
  • افزودن بیش از 2 عملکرد در بدنه های الگو ممنوع است ( I32157 )
  • همه ایجاد PendingIntent s در مجموعه پرچم‌های کتابخانه برنامه خودرو را تضمین کرد. ( If84fe , b/186394900 )
  • javadoc به روز شد تا متن Row را به عنوان تازه کردن تغییر دهد ( If3f9c )
  • androidx.activity:activity:1.2.0 اکنون یک وابستگی به api است ( Id1cb9 )
  • SignInTemplate و LongMessageTemplate را ساخته اند تا نیاز به اقدامات فقط پارک شده در بدنه خود داشته باشند و اسناد به روز رسانی را نشان دهند تا نشان دهند آنها فقط زمانی که ماشین پارک شده است نشان داده می شوند ( Iddaa9 )
  • رفع استثنایی که هنگام بیرون آمدن Screen هنگام شروع به وجود می آید ( Ifcf40 , b/184664896 )
  • رنگ متن سفارشی مجاز در ForegroundCarColorSpan ( I69e59 )
  • رفع مشکلی که در آن ON_DESTROY در یک Session پس از ON_DESTROY یک Screen مشاهده می شود ( I52e01 , b/183696617 )
  • به‌روزرسانی جاوادوک در هنگام تنظیم زمان باقی‌مانده TravelEstimate روی زمان ناشناخته مجاز است. ( I99610 , b/183632456 )
  • Action به روز شده برای پشتیبانی از ForegroundColorSpan در عنوان و هر رنگ پس زمینه سفارشی ( I578e4 )
  • اگر پاسخ تماس قبل از اجرای مجری پاک شد، NavigationManagerCallback#onStopNavigation اجرا نکنید ( I7fc5e , b/181143772 )
  • مشکلی را برطرف کرد که برنامه را ملزم به وابستگی صریح به lifecycle-common-java8 ( I8b8c8 ) می کرد.

مسائل شناخته شده

  • در SignInTemplate ، صفحه کلید روی صفحه زمانی که کاربر می‌خواهد ورودی را تأیید کند، به جای نماد «ورود» نماد «جستجو» را نشان می‌دهد. به عنوان یک راه حل، کاربران می توانند به صفحه کلید تلفن دسترسی داشته باشند که وقتی فیلد ورودی در فوکوس است فعال می شود.
  • در Android Auto نسخه 6.5، تماس‌های پان و زوم در SurfaceCallback ممکن است برای برخی از حرکات لمسی به اشتباه فراخوانی شوند.

تست اپلیکیشن ماشین نسخه 1.0.0

نسخه 1.0.0-alpha01

24 مارس 2021

androidx.car.app:app-testing:1.0.0-alpha01 منتشر شد. نسخه 1.0.0-alpha01 حاوی این commit ها است.

این اولین نسخه Jetpack از کتابخانه آزمایشی منبع بسته قبلی است. به نمونه های ما در مورد نحوه استفاده از این کتابخانه در آزمون های خود مراجعه کنید.

ویژگی های جدید

  • کنترل کننده های کلاس های مدل حذف شده اند. گیرنده‌های مدل اکنون بخشی از سطح API عمومی هستند که امکان اعتبارسنجی مقادیر تنظیم‌شده در سازنده‌ها را فراهم می‌کند.
  • CarAppServiceController قبلی با SessionController جدید برای آزمایش منطق مربوط به طول عمر اتصال به هات جایگزین شده است.

نسخه 1.0.0

نسخه 1.0.0

21 آوریل 2021

androidx.car.app:app:1.0.0 منتشر شد. نسخه 1.0.0 حاوی این commit ها است.

ویژگی های اصلی 1.0.0

  • در اوایل آوریل، اعلام کردیم که برنامه‌ها می‌توانند با استفاده از androidx.car.app:app:1.0.0-rc01 در کانال تولید منتشر شوند. Car App Library نسخه 1.0.0 اکنون پایدار است و کاملاً با 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 حاوی این commit ها است.

رفع اشکال

  • رفع یک اشکال شرایط مسابقه که در آن NavigationManagerCallback#onStopNavigation پس از پاک شدن پاسخ تماس فراخوانی می‌شد. این اتفاق در صورتی رخ می‌دهد که پاسخ تماس قبل از اجرای واقعی اجراکننده تماس پاک شود ( I7fc5e , b/181143772 )
  • مشکلی که برنامه را ملزم به وابستگی صریح به lifecycle-common-java8 ( I8b8c8 ) می‌کرد، برطرف شد.
  • رفع یک NullPointerException که زمانی که برنامه یک تماس stopNavigation دریافت می‌کند، هنگامی که قبلاً یک تماس برگشتی را حذف کرده بود، پرتاب می‌شد ( Ib8b89 , b/181143772 )
  • بهبودهایی برای عدم ارسال تماس‌ها به برنامه در صورتی که چرخه عمر آن حداقل در حالت CREATED نباشد ( I86965 , b/179800224 , b/177921120 )
  • مشکلی را برطرف کرد که در آن یک دقیقه API نامعتبر مشخص شده در مانیفست برنامه باعث ایجاد 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 API اضافه شد. ( b/174231592 )

رفع اشکال

  • رفع مشکلی که در آن Screen اشتباه هنگام باز شدن پی در پی صفحه نمایش از سر گرفته می شود. ( b/177590791 )