یادداشت‌های انتشار کیت توسعه نرم‌افزار راننده برای Android

این بخش حاوی یادداشت‌های انتشار برای «کیت توسعه نرم‌افزار راننده» برای Android است.

همچنین ببینید:

• یادداشت‌های انتشار نسخه ۱ کیت توسعه نرم‌افزار ناوبری
• یادداشت‌های انتشار «کیت توسعه نرم‌افزار پیمایش نسخه ۲» و نسخه‌های جدیدتر

نسخه ۷.۱.۰ (۱۴ مه ۲۰۲۶)

تغییرات وابستگی و پیکربندی

• وابستگی‌های Jetpack DataStore اضافه شد: androidx.datastore:datastore-coreنسخه ۱.۱.۷ و androidx.datastore:datastore-guava نسخه ۱.۲.۰.

• نسخه وابستگی Kotlin به v2.3.0 ارتقا یافت.

• نسخه «افزایه Android Gradle» به ۸.۱۳.۲ ارتقا یافت.

• نسخه Gradle به ۸.۱۳ ارتقا یافت.

• نسخه کتابخانه Desugar به ۲.۱.۵ ارتقا یافت.

• محدوده نسخه پشتیبانی‌شده «کیت توسعه نرم‌افزار پیمایش» از [۷.۰، ۷.۳) به [۷.۰، ۸.۰) گسترش یافت.

نسخه ۷.۰.۰ (۵ دسامبر ۲۰۲۵)

تغییرات پیکربندی و وابستگی

• ‫minSdkVersion به API 26 ارتقا یافت.

• ‫targetSdkVersion به API 36 ارتقا یافت.

• نسخه‌های پشتیبانی‌شده «کیت توسعه نرم‌افزار پیمایش» به‌روزرسانی شد و شامل نسخه‌هایی در محدوده v7.0.0 و بالاتر می‌شود.

v6.99.0 (۵ دسامبر ۲۰۲۵)

• بهبودهای داخلی

اعلامیه: توقف پشتیبانی از سطح میانای برنامه‌سازی کاربردی ۲۳، ۲۴، و ۲۵

مطابق با خط‌مشی پشتیبانی از نسخه سیستم‌عامل تلفن همراه، پشتیبانی از Android 6 و 7 (سطح میانای برنامه‌سازی کاربردی ۲۳، ۲۴، و ۲۵) را در نسخه‌های اصلی آتی «کیت توسعه نرم‌افزار راننده» برای Android متوقف می‌کنیم.

از نسخه ۷.۰.۰، «کیت توسعه نرم‌افزار Driver ویژه Android» از حداقل Android 8 (سطح میانای برنامه‌سازی کاربردی ۲۶) پشتیبانی خواهد کرد. نسخه‌های قدیمی‌تر کیت توسعه نرم‌افزار همچنان از Android 6 و 7 پشتیبانی می‌کنند.

اگر وابستگی‌هایتان شماره نسخه را مشخص نکنند، «محیط توسعه یکپارچه» شما جدیدترین نسخه کیت توسعه نرم‌افزار را بار می‌کند و ساخت‌های جدید برنامه‌تان از Android 6 و 7 پشتیبانی نخواهند کرد.

نسخه «کیت توسعه نرم‌افزار درایور برای Android» را در وابستگی‌های ساخت برنامه خود مشخص کنید تا بتوانید زمان افزایش حداقل سیستم‌عامل پشتیبانی‌شده برای نسخه‌های جدید برنامه‌تان را کنترل کنید.

نسخه ۶.۲.۰ (۱۸ ژوئن ۲۰۲۵)

رفع اشکال‌ها

• خرابی NullPointerException هنگام تماس با DriverApi.createInstance() وقتی DriverStatusListener ارائه نشده است رفع شد.

تغییرات پیکربندی و وابستگی

• از نسخه ۶.۲.۰ «کیت توسعه نرم‌افزار راننده» برای Android، برنامه‌ها باید به Kotlin 2.1 ارتقا دهند.

• نسخه‌های محدوده پشتیبانی‌شده «کیت توسعه نرم‌افزار پیمایش» به‌روزرسانی‌شده شامل نسخه ۶.۱.۰ و نسخه‌های بالاتر است.

نسخه ۶.۱.۰ (۱۰ مارس ۲۰۲۵)

رفع اشکال‌ها

• بهبودهای گزارش‌دهی داخلی.

نسخه ۵.۹۹.۱ (۱۰ ژانویه ۲۰۲۵)

رفع اشکال‌ها

• مشکلی که در آن رانندگان خطاهای gRPC با کد «INTERNAL» و پیام «Panic! » دریافت می‌کردند برطرف شد. این یک اشکال است!" در اولین راه‌اندازی برنامه پس‌از نصب.

نسخه ۶.۰.۰ (۲۵ نوامبر ۲۰۲۴)

رفع اشکال‌ها

• مشکل دریافت خطاهای gRPC با کد «INTERNAL» و پیام «Panic! توسط رانندگان برطرف شد. این یک اشکال است!" شرح.
• بهبود داخلی برای کاهش خطاهای اتصال به‌روزرسانی مکان به‌ویژه وقتی دستگاه شبکه‌ها را تغییر می‌دهد. پس‌از یکپارچه شدن نسخه پخش، این ویژگی به‌تدریج عرضه خواهد شد (از ۰٪ شروع می‌شود).`

به‌روزرسانی‌های میانای برنامه‌سازی کاربردی

• میانای منسوخ StatusListener برداشته شد.

تغییرات پیکربندی و وابستگی

• وابستگی به glide:cronet-integration را در POM.xml بردارید
• نسخه‌های محدوده پشتیبانی‌شده کیت توسعه نرم‌افزار پیمایش به نسخه 5.x به‌روز شد.
• از نسخه ۶.۰.۰ «کیت توسعه نرم‌افزار راننده» برای Android، برنامه‌ها باید به Kotlin 2.0 ارتقا یابند.
• ‫targetSdk اکنون سطح میانای برنامه‌سازی کاربردی ۳۴ است. این امر برای همه برنامه‌هایی که از اوت ۲۰۲۴ در «فروشگاه Google Play» توزیع می‌شوند الزامی است. برآورده کردن الزامات سطح میانای برنامه‌سازی کاربردی هدف Google Play را ببینید.

نسخه ۵.۹۹.۰ (۲۰ سپتامبر ۲۰۲۴)

رفع اشکال‌ها

• مشکلی که در آن رانندگان خطاهای gRPC با کد «داخلی» و «وحشت! این یک اشکال است!" شرح. پس‌از یکپارچه شدن نسخه پخش، این ویژگی به‌تدریج (از ۰٪) عرضه خواهد شد.
• بهبود داخلی برای کاهش خطاهای اتصال به‌روزرسانی مکان به‌ویژه وقتی دستگاه شبکه‌ها را تغییر می‌دهد. پس‌از یکپارچه شدن نسخه پخش، این ویژگی به‌تدریج عرضه خواهد شد (از ۰٪ شروع می‌شود).`

تغییرات پیکربندی و وابستگی

• وابستگی به glide:cronet-integration را در POM.xml بردارید

نسخه ۵.۰.۰ (۱۲ سپتامبر ۲۰۲۳)

تغییرات پیکربندی و وابستگی

• «کیت توسعه نرم‌افزار پیمایش» به نسخه ۵.x به‌روزرسانی شد.
• ‫minSdkVersion به API 23 ارتقا یافت.
• نسخه Kotlin به 1.9.0 ارتقا یافت.
• وابستگی به اتاق اضافه شد. * برنامه‌هایی که از «کیت توسعه نرم‌افزار راننده» استفاده می‌کنند اکنون باید targetSdkVersion میانای برنامه‌سازی کاربردی ۳۱ یا بالاتر داشته باشند.
• برنامه‌هایی که از «کیت توسعه نرم‌افزار راننده» استفاده می‌کنند اکنون باید از کتابخانه Java 8 پشتیبانی کنند. برای دستورالعمل‌های به‌روزرسانی، https://developer.android.com/studio/write/java8-support را ببینید.
• برنامه‌هایی که از Proguard یا Dexguard استفاده می‌کنند باید به R8 انتقال داده شوند. برای اطلاعات بیشتر، به https://developer.android.com/build/shrink-code مراجعه کنید.
• برنامه‌هایی که از «کیت توسعه نرم‌افزار راننده» استفاده می‌کنند باید «شیرین‌سازی» را فعال کنند. برای دریافت دستورالعمل‌ها، به https://developer.android.com/studio/write/java8-support#library-desugaring مراجعه کنید.

رفع اشکال‌ها

• مشکل همگام‌سازی disableLocationTracking برطرف شد.
• میانای جدید DriverStatusListener معرفی شد که علت را در به‌روزرسانی‌های وضعیت استثنا گزارش می‌کند.
• مشکل رانندگانی که بی‌حرکت می‌ماندند برطرف شد (از نسخه ۴.۹۹.۰ دردسترس است).

نسخه ۴.۹۹.۰ (۹ اوت ۲۰۲۳)

• از طیفی از نسخه‌ها برای وابستگی NavSDK پشتیبانی کنید. ** از نسخه ۴.۵.۰ تا (اما نه شامل) نسخه ۵.۰.۰ پشتیبانی می‌کند.
• جلوگیری از کاهش خودکار زمان تخمینی رسیدن وقتی خودرو ساکن است. این تغییر به‌تدریج به‌عنوان یک آزمایش عرضه می‌شود، بنابراین همه برنامه‌ها این تغییر را به‌طور هم‌زمان مشاهده نخواهند کرد.

نسخه ۴.۵.۰ (۱۲ مه ۲۰۲۳)

• وابستگی کیت توسعه نرم‌افزار پیمایش را به نسخه ۴.۵ به‌روز کنید. توجه داشته باشید که شناسه گروه و شناسه آرتیفکت برای «کیت توسعه نرم‌افزار پیمایش» تغییر کرده است.

نسخه ۴.۴.۳ (۲۰ مارس ۲۰۲۳)

تغییر وابستگی

• وابستگی «کیت توسعه نرم‌افزار پیمایش» را به نسخه ۴.۴.۱ ارتقا دهید.

‫v4.4.2 (۱۵ فوریه ۲۰۲۳)

رفع اشکال‌ها

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

• ‫UpdateVehicle درخواست را که فقط حاوی مکان «خام» است کنار بگذارید.

• رفع مشکل وضعیت مسابقه در «نمای کلی مسیر» ALPHA API.

نسخه ۴.۴.۱ (۱۸ نوامبر ۲۰۲۲)

رفع اشکال‌ها

• اشکالی در منطق بارگذاری ترافیک برطرف شد.

تغییرات اضافی

• بهبودهای داخلی در سرایندهای درخواست و گزارش کد وضعیت.

نسخه ۴.۴.۰ (۲۱ سپتامبر ۲۰۲۲)

رفع اشکال‌ها

• اشکالی که مانع از برداشته شدن اعلان «رانندگی با Google Maps» می‌شد، درصورتی‌که نمونه API پاک نشده بود، برطرف شد.

تغییر وابستگی

• وابستگی «کیت توسعه نرم‌افزار پیمایش» را به نسخه ۴.۲.۲ ارتقا دهید.

نسخه ۴.۳.۰ (۲۴ اوت ۲۰۲۲)

بهبودهای داخلی.

اعلامیه: توقف پشتیبانی از Android 5‏ (۲۱ ژوئیه ۲۰۲۲)

برای جدیدترین نسخه کیت توسعه نرم‌افزار ما (نسخه ۴.۲.۰)، یک سال پشتیبانی اضافی برای برنامه‌هایی که در Android 5 اجرا می‌شوند، هم برای سطح میانای برنامه‌سازی کاربردی ۲۱ و هم ۲۲ ارائه می‌دهیم.

معنی این چیست:

• «کیت توسعه نرم‌افزار پیمایش» و «کیت توسعه نرم‌افزار راننده» که در برنامه‌های Android شما اجرا می‌شوند تا ۳۰ ژوئن ۲۰۲۳ از حداقل Android 5 (سطح ای‌پی‌آی ۲۱) پشتیبانی خواهند کرد.
• پس‌از ۳۰ ژوئن ۲۰۲۳، فقط از سطوح Android API 23 و بالاتر پشتیبانی خواهیم کرد. به‌عبارت دیگر، پس‌از آن تاریخ، پشتیبانی از سطوح میانای برنامه‌سازی کاربردی Android 21 و 22 را در همه نسخه‌های کیت توسعه نرم‌افزار متوقف خواهیم کرد. این یعنی اشکالات مربوط به Android 21 یا 22 در هر نسخه کیت توسعه نرم‌افزار (ازجمله 4.x) برطرف نخواهد شد و تضمین نمی‌کنیم که کیت‌های توسعه نرم‌افزار عملکرد درستی داشته باشند.

این اطلاعیه بر اطلاعیه توقف پشتیبانی از Android 21 و 22 مورخ ۲۱ ژوئن ۲۰۲۱ و توقف پشتیبانی از Android 23،‏ 24، و 25 مورخ ۱۸ اکتبر ۲۰۲۱ اولویت دارد.

نسخه ۴.۲.۰ (۸ ژوئن ۲۰۲۲)

تغییر وابستگی

• وابستگی «کیت توسعه نرم‌افزار پیمایش» را به نسخه ۴.۱.۳ ارتقا دهید.
• حداقل سطح ای‌پی‌آی Android پشتیبانی‌شده را به ۲۱ تنزل می‌دهد.

نسخه ۴.۱.۰ (۲۸ آوریل ۲۰۲۲)

به‌روزرسانی‌های میانای برنامه‌سازی کاربردی

• نام دارایی Task شیء parentId به trackingId تغییر کرد. دارایی قدیمی فعلاً هنوز وجود دارد اما منسوخ شده است.

نسخه ۴.۰.۰ (۲۹ نوامبر ۲۰۲۱)

حداقل سطح API Android پشتیبانی‌شده برای این نسخه ۲۳ است.

به‌روزرسانی‌های میانای برنامه‌سازی کاربردی

برای این نسخه، «کیت توسعه نرم‌افزار راننده» برای Android با تغییرات زیر به‌روز شده است.

تغییر VehicleStops API

VehicleStop شیء اکنون به‌جای «فهرست اشیاء Task » به «فهرست اشیاء TaskInfo » ارجاع می‌دهند. اگر به وضعیت «تکلیف» نیاز دارید، توصیه می‌شود آن را در کد برنامه‌تان پیگیری کنید.

• کلاس جدیدی اضافه شد: TaskInfo

• تابع getTasks VehicleStop با تابع getTaskInfoList جایگزین شد.

• تابع setTasks مربوط به VehicleStop.Builder با تابع setTaskInfoList جایگزین شد.

نظارت بر خرابی

پایش و گزارش خرابی برای کمک به بهبود پایداری کیت توسعه نرم‌افزار اضافه شده است. این ویژگی به‌طور پیش‌فرض فعال است، اما اگر قبل‌از مقداردهی اولیه کیت توسعه نرم‌افزار، setAbnormalTerminationReportingEnabled() را فراخوانی کنید و مقدار false را به آن منتقل کنید، می‌توانید آن را غیرفعال کنید.

• تابع setAbnormalTerminationReportingEnabled به DriverApi اضافه شد.

Async getRemainingVehicleStops

• عملکرد DeliveryVehicleReporter getRemainingVehicleStops به‌جای List<VehicleStop> به Future<List<VehicleStop>> تغییر کرد.

اصالت‌سنجی

ویژگی‌های غیرضروری از میانای AuthTokenContext برداشته شد. ‫ServiceType منسوخ شده است. اکنون فقط باید برای شناسه خودرو و شناسه تکلیف درج‌شده ادعای مالکیت دریافت کنید، به‌جای اینکه به ServiceType تکیه کنید.

• ‫ServiceType از AuthTokenContext برداشته شد.

• ‫getServiceType() از AuthTokenContext برداشته شد.

• ‫setServiceType از AuthTokenContext.Builder برداشته شد.

‫۱۸ اکتبر ۲۰۲۱ - توقف پشتیبانی از «سطح میانای برنامه کاربردی ۲۳، ۲۴، و ۲۵»

احتیاط: این اطلاعیه باطل شده است. لطفاً اعلامیه به‌روزشده را در ۲۱ ژوئیه ۲۰۲۲ ببینید.

اعلامیه ۱۸ اکتبر را بخوانید

در پاسخ به تغییرات در وابستگی‌های داخلی ما، «سطح API Android 23»، 24، و 25 (Android 6،‏ 7.0، و 7.1) در نسخه‌های جدید «کیت‌های توسعه نرم‌افزار Navigation و Driver برای Android» از سه‌ماهه سوم سال ۲۰۲۲ پشتیبانی نخواهند شد.

«کیت‌های توسعه نرم‌افزار ناوبری و راننده» برای نسخه‌های Android که از سه‌ماهه سوم سال ۲۰۲۲ منتشر می‌شوند فقط از دستگاه‌هایی پشتیبانی می‌کنند که حداقل از «سطح Android API 26» استفاده می‌کنند.

نسخه‌های برنامه که با نسخه ۴.x یا پایین‌تر از «کیت‌های توسعه نرم‌افزار ناوبری و راننده» برای Android ساخته شده‌اند در دستگاه‌هایی که از «سطح API‏ ۲۵» و پایین‌تر Android استفاده می‌کنند همچنان کار خواهند کرد.

نسخه ۳.۰.۴ (۲۸ ژوئیه ۲۰۲۱)

ویژگی‌ها

با این نسخه، «کیت توسعه نرم‌افزار راننده» به‌طور رسمی از «کیت توسعه نرم‌افزار پیمایش» جدا می‌شود. برای جزئیات، راهنمای انتقال را ببینید.

به‌روزرسانی‌های میانای برنامه‌سازی کاربردی

روش‌های زیر اضافه شد:

‫`RidesharingDriverApi.getDriverSdkVersion()`

پایداری و رفع اشکال‌ها

به‌جای طبقه‌بندی کردن PERMISSION_DENIED خطا به‌عنوان خطاهای اتصال، آن‌ها را گزارش کنید.

اعلامیه منسوخ شدن (۲۱ ژوئن ۲۰۲۱)

این اعلامیه منسوخ شدن «کیت توسعه نرم‌افزار راننده» برای Android و «کیت توسعه نرم‌افزار ناوبری» برای Android را از تاریخ ذکرشده در بالا شرح می‌دهد. این اعلان به‌صورت «اعلان خدمات اجباری» (MSA) نیز برای مشتریان تحت‌تأثیر قرارگرفته ارسال شد.

کیت توسعه نرم‌افزار Nav/Driver برای Android به کیت توسعه نرم‌افزار ناوبری برای Android نسخه ۳.x و کیت توسعه نرم‌افزار Driver برای Android نسخه ۳.x برای Android (باینری‌های تقسیم‌شده) تبدیل خواهد شد

برای ساده کردن ادغام مشتری و تسریع توانایی خود در ارائه ویژگی‌های مفید، «کیت توسعه نرم‌افزار پیمایش برای Android» و «کیت توسعه نرم‌افزار راننده برای Android» را به دو باینری متفاوت تقسیم می‌کنیم:

• کیت توسعه نرم‌افزار پیمایش برای Android، که عملکرد پیمایش/مسیریابی را برای رانندگان شما فراهم می‌کند.
• کیت توسعه نرم‌افزار راننده برای Android که به شما امکان می‌دهد از سرویس‌های وب باحالت Fleet Engine برای پیشرفت و تخصیص سفر یا تکلیف استفاده کنید.

لطفاً توجه داشته باشید که «کیت توسعه نرم‌افزار راننده برای Android» برای عملکردهای اصلی مسیریابی به «کیت توسعه نرم‌افزار پیمایش برای Android» وابستگی الزامی دارد.

تغییرات چیست؟

تغییرات عمده در نسخه ۳ عبارتند از:

• به‌جای یک باینری، دو باینری.
• تعاریف بسته واضح‌تر برای کلاس‌های «کیت توسعه نرم‌افزار راننده» ویژه Android.
• کیت توسعه نرم‌افزار ناوبری برای Android شامل کیت توسعه نرم‌افزار Maps برای Android به‌عنوان بخشی از بسته‌بندی است (از کیت توسعه نرم‌افزار ناوبری برای Android نسخه ۲).
  • این کار باعث می‌شود ویژگی‌های نقشه و ناوبری بتوانند در یک نقشه باهم وجود داشته باشند (مثلاً رسم چندخطی در NavigationView) و مصرف حافظه را کاهش می‌دهد زیرا به‌جای دو نقشه، از یک نقشه استفاده می‌شود.
  • «کیت توسعه نرم‌افزار پیمایش برای Android 3.0» با «کیت توسعه نرم‌افزار پیمایش برای Android» برابری ویژگی کامل ندارد، اما نسخه ۳.۲ بیشتر مشکلات را در اینجا برطرف خواهد کرد. برای جزئیات بیشتر، چه کاری می‌توانم انجام دهم و چه زمانی؟ را ببینید.
• ثبت کردن این اطلاعات به ما کمک می‌کند تا اشکال‌زدایی مشکلاتی را که ممکن است با آن‌ها مواجه شوید راحت‌تر انجام دهیم.

روش‌های زیر نیز در نسخه ۳ برداشته شده‌اند، زیرا قبلاً به‌عنوان منسوخ‌شده علامت‌گذاری شده بودند و راه‌حل جایگزینی برای آن‌ها وجود دارد:

• روش‌های زیر از «کیت توسعه نرم‌افزار ناوبری/راننده» در نسخه ۱.۱۶ که در ۱۰ اوت ۲۰۲۰ منتشر شد منسوخ شدند و در نسخه ۳.۰ برداشته شدند:
  • Waypoint#fromLatLng(*)
  • Waypoint#fromPlaceId(*)
  • Navigator#startGuidance(resumeIntent)
  • NavigationApi#initForegroundServiceManager(*)
• برای کامل بودن و شفافیت، توجه داشته باشید که تعدادی از روش‌ها در گذار از نسخه ۱ به نسخه ۲ برداشته شده است. بیشتر این موارد ادغام کلاس‌های تکراری بین «کیت توسعه نرم‌افزار پیمایش برای Android» و «کیت توسعه نرم‌افزار Maps برای Android» بود. لطفاً برای درک بهتر این تغییرات، راهنمای انتقال را ببینید.

منسوخ شدن Driver SDK برای Android و Navigation SDK برای Android نسخه ۱.x

«کیت توسعه نرم‌افزار ناوبری/راننده نسخه ۱» در سال ۲۰۱۸ منتشر شد و با انتشار قریب‌الوقوع نسخه‌های ۳ ما، زمان آن رسیده است که نسخه ۱ را منسوخ کنیم تا از ناپایداری پشتیبانی از نسخه‌های اصلی متعدد جلوگیری کنیم.

زمانی که با عدم پشتیبانی از این نسخه اضافی صرفه‌جویی می‌شود به ما امکان می‌دهد از جدیدترین نسخه اصلی بهتر پشتیبانی کنیم و ویژگی‌های بیشتری بسازیم که برای مشتریانمان مهم است.

بنابراین، Nav/Driver SDK v1.x اکنون منسوخ شده است و دیگر پس‌از ۲۱ ژوئن ۲۰۲۲ نگهداری نخواهد شد.

لطفاً کمی وقت بگذارید و ببینید منسوخ شدن نسخه‌های کیت توسعه نرم‌افزار چگونه کار می‌کند.

پایان پشتیبانی از Navigation and Driver SDK Android 21 و 22

احتیاط: این اطلاعیه باطل شده است. لطفاً اعلامیه به‌روزشده را در ۲۱ ژوئیه ۲۰۲۲ ببینید.

خواندن اعلامیه لغوشده

نسخه ۴.۰ آتی «کیت توسعه نرم‌افزار پیمایش برای Android» و «کیت توسعه نرم‌افزار راننده برای Android» از حداقل [Android 6.0 (سطح میانای برنامه‌سازی کاربردی ۲۳)](https://developer.android.com/studio/releases/platforms#6.0){: .external} پشتیبانی خواهد کرد. درحال‌حاضر، حداقل نسخه پشتیبانی‌شده Android 5.0 (سطح میانای برنامه‌سازی کاربردی ۲۱) است. پیش‌بینی می‌کنیم نسخه ۴.۰ را در سه‌ماهه چهارم سال ۲۰۲۱ منتشر کنیم. این یعنی:

• نسخه‌های برنامه ساخته‌شده با نسخه‌های قدیمی‌تر از v4.x همچنان در دستگاه‌های Android 21 و 22 کار خواهند کرد. برنامه‌های راننده شما که کیت‌های توسعه نرم‌افزار فعلی ما را یکپارچه کرده‌اند، همچنان در دستگاه‌های دارای Android 21+ کار خواهند کرد. این همانند قبل است.
• نسخه‌های برنامه ساخته‌شده با Driver SDK for Android و Navigation SDK for Android نسخه ۴.x (هدف‌گذاری‌شده برای سه‌ماهه چهارم ۲۰۲۱، ممکن است تغییر کند) و نسخه‌های بعدی نمی‌توانند در دستگاه‌های دارای Android 21 و ۲۲ نصب شوند. نسخه ۴.x حداقل در Android 6.0 (سطح میانای برنامه‌سازی کاربردی ۲۳) اجرا می‌شود، بنابراین نسخه‌های برنامه شما که با نسخه ۴.x آتی ساخته شده‌اند فقط توسط رانندگانی که دستگاه‌هایشان دارای Android 23+ است قابل دریافت هستند. تکرار می‌کنیم که این یعنی هم تغییرات مربوط به کیت توسعه نرم‌افزار ما و هم هرگونه تغییرات برنامه‌ای که شما ایجاد کرده‌اید به رانندگانی که دستگاه‌هایشان دارای Android 21 و ۲۲ است نمی‌رسد.

نسخه‌های «کیت توسعه نرم‌افزار پیمایش برای Android نسخه ۳» و «کیت توسعه نرم‌افزار راننده برای Android نسخه ۳» که می‌خواهید به آن‌ها ارتقا دهید در جدول زیر به‌همراه زمان دردسترس قرار گرفتن آن‌ها توضیح داده شده است.

از کدام ویژگی‌های پلاتفرم Driver استفاده می‌کنید؟	آیا از این قابلیت‌ها استفاده می‌کنید؟	سپس اولین نسخه‌های دردسترس که باید به آن‌ها ارتقا دهید عبارت‌اند از…	دردسترس بودن موردانتظار (ممکن است تغییر کند)	پیوندهای انتقال
فقط پیمایش (روش‌های NavSDK)	نه	NavSDK v3.0.1	اکنون	راهنما
	بله	NavSDK نسخه ۳.۵ (پیش‌بینی‌شده)	سپتامبر ۲۰۲۱
ناوبری و ردیابی موتور ناوگان (روش‌های NavSDK و DriverSDK)	نه	Nav SDK v3.0 و Driver SDK v3.0		راهنمای انتقال Driver v3.0 در زمان انتشار دردسترس است
	بله	NavSDK v3.x و DriverSDK v3.0

برای ادامه استفاده از روش‌های برداشته‌شده، می‌توانید در نسخه ۱.x بمانید، اما پس‌از ۲۱ ژوئن ۲۰۲۲ انتظار پشتیبانی یا نگهداری نداشته باشید (بخش بعدی را ببینید).

توصیه می‌کنیم به نسخه ۳.x مهاجرت کنید. این یعنی:

* آخرین نسخه v1.x در سه‌ماهه چهارم سال ۲۰۲۱ منتشر خواهد شد (و بنابراین v1 از آن زمان «ویژگی منجمد» خواهد شد).

* این نسخه آخر می‌تواند تا ۶ ماه پس‌از آن، یعنی تا ۲۱ ژوئن ۲۰۲۲، وصله شود. پس‌از این زمان، دیگر نمی‌توانیم به درخواست‌های ویژگی یا اشکال برای نسخه ۱.x پاسخ دهیم.

لطفاً لحظه‌ای زمان بگذارید و جدول زیر و [راهنمای انتقال](/maps/documentation/navigation-sdk-android/v2/migration) را بررسی کنید تا بتوانید این تغییرات را مدیریت کنید.

تا چه زمانی چه کاری می‌توانم انجام دهم؟

اگر درحال‌حاضر در… هستید	آیا از این قابلیت‌ها استفاده می‌کنید؟	برای ارتقا دادن	برای ارتقا دادن در سپتامبر ۲۰۲۱	پیوندهای انتقال
نسخه ۱.x (از FleetEngine.java / کارآمدی «راننده» استفاده نمی‌کند)	نه	NavSDK v3.0		راهنما
	بله	بدون گزینه	NavSDK 3.x
v1.x (using FleetEngine.java / Driver functionality)	نه	بدون گزینه	NavSDK 3.x + DriverSDK 3.x	راهنمای بالا، به‌علاوه راهنمای انتقال «نسخه ۳.۰ درایور» که در زمان انتشار دردسترس است.
	بله

توصیه می‌کنیم قبل‌از اینکه «کیت توسعه نرم‌افزار راننده برای Android» و «کیت توسعه نرم‌افزار ناوبری برای Android» نسخه v4.x و بالاتر را در برنامه راننده خود ادغام کنید، به رانندگانی که دستگاه‌هایشان از Android 21 و 22 استفاده می‌کنند اطلاع دهید که به نسخه جدیدتری از Android (حداقل Android 6.0) ارتقا دهند.

نسخه ۱.۱۵.۳ (۹ اکتبر ۲۰۲۰)

به‌روزرسانی‌های میانای برنامه‌سازی کاربردی

• اکنون Driver SDK برای به‌روزرسانی‌های ترافیک در Navigation SDK مشترک می‌شود، که به Fleet Engine API ارسال می‌شوند.

پایداری و رفع اشکال‌ها

• ازکارافتادگی زمان اجرای gRPC برطرف شد.

v1.15.2

ویژگی‌ها

امکان توقف اعلان ماندگار اضافه شد. اگر گزارش مکان در نمونه Fleet Engine متوقف شود، راهنمایی در Navigator متوقف می‌شود، همه شنوندگان ناوبری لغو ثبت می‌شوند، و NavigationFragment یا NavigationView موقتاً متوقف می‌شود.

پایداری و رفع اشکال‌ها

• اشکالی که باعث می‌شد اگر نمونه Fleet Engine پاک شود استثنایی ایجاد شود برطرف شد.

نسخه ۱.۱۵.۱ (۱۲ مه ۲۰۲۰)

ویژگی‌ها

تجزیه‌وتحلیل مقدماتی داده‌های نسخه ۱.۱۵.۰ نشان داد که گزارش مکان پایدار بهبود چشمگیری داشته است (کاهش مکان‌های «گیرکرده»). این وصله اصلاحی به گزارش مکان بهبودیافته اجازه می‌دهد ادامه یابد. مشکل ANR به این بهبودها مربوط نبود.

پایداری و رفع اشکال‌ها

• اشکالی برطرف شد که گاهی باعث می‌شد خط مستقیمی در ابتدای مسیر در برنامه مصرف‌کننده نشان داده شود.
• اشکالی که می‌توانست منجر به ANR هنگام گزارش مکان‌ها توسط کیت توسعه نرم‌افزار شود برطرف شد. این وضعیت ناشی از onArrival() بهبود بود که مستعد رقابت قفل بود. تحت برخی شرایط توانستیم خطاهای ANR را به‌طور قابل‌اعتمادی بازتولید کنیم و توانستیم تأیید کنیم که اصلاحات مشکل را حل کرده است. برنامه آزمایشی اصلاح‌شده برای تولید خطاهای ANR پس‌از رفع مشکل به‌مدت هشت ساعت بدون خطای ANR اجرا شد.

نسخه ۱.۱۵.۰ (۲۳ مارس ۲۰۱۹)

ویژگی‌ها

• وضعیت راهنمایی ناوبری در رویدادهای شروع، خارج از مسیر، و رسیدن معرفی شد تا ردیابی مکان خودرو بهبود یابد.
• امکان ادامه دریافت مکان‌های منطبق با جاده مستقل از وضعیت ناوبری اضافه شد.
• اطلاعات بیشتری درباره مکان‌های پیش‌از چسبیدن به جاده، مانند دقت، اضافه شد.

پایداری و رفع اشکال‌ها

• ‫minSdkVersion برای navsdk به ۱۹ افزایش یافت.
• اشکالی که باعث می‌شد وقتی زمین‌کدیابی معکوس سمت سرور ناموفق است، نام‌های «نقطه‌مسیر» طول/عرض جغرافیایی رعایت نشود برطرف شد.

نسخه پخش v1.14.2 (۲ فوریه ۲۰۱۹)

ویژگی‌ها

• ‫DriverSDK را از ارسال مکان‌های ۰،۰ به Fleet Engine منع می‌کند (ورودی‌های مکان تخصیص و هم‌رسانی سفر بهتر).
• گزارش‌گیری بیشتر برای بهبود مشکلات مکان ثابت و کاهش جایگزین‌ها برای هم‌رسانی مسیر.
• تماس‌های مکرر با setLocationReportingInterval() نادیده گرفته می‌شود، مگراینکه فاصله زمانی تغییر کند.
• javadocهای به‌روزشده برای روش setReportingInterval() با هدف بازداشتن از فراخوانی مکرر این روش با نرخ بالا نسبت به فاصله‌های زمانی استفاده‌شده.
• اطمینان‌پذیری مکان Api 29 بهبود یافت.

v1.13.0

بهبود پایداری و رفع اشکال‌ها

• وابستگی به okhttp را اضافه می‌کند که مشتریان باید به ساخت‌های gradle خود اضافه کنند.

نسخه ۱.۱۱.۷ (۱۸ اکتبر ۲۰۱۹)

بهبود پایداری و رفع اشکال‌ها

• اکنون به‌روزرسانی‌های مکان پس‌از فعال شدن onArrival() برای مقصد مشخص‌شده ادامه می‌یابد.
• اعلان پیش‌فرض (رشته‌ای ثابت در حالت «پیمایش آزاد») با آرایش رنگ‌های تنظیم‌شده برای اعلان‌های پیمایش مطابقت دارد. برای اطلاعات بیشتر، به اعلان‌های دائمی مشترک مراجعه کنید.
• مشکلی برطرف شد که در آن رویداد به‌روزرسانی مکان با تأخیر می‌توانست باعث به‌روزرسانی مکان نادرست شود و مصنوعاتی مانند خط مستقیم در ابتدای مسیر ایجاد کند.

نسخه ۱.۱۱.۶ (۴ اکتبر ۲۰۱۹)

به‌روزرسانی‌های میانای برنامه‌سازی کاربردی

• مجموعه‌ای از تغییرات را معرفی کردیم که تضمین می‌کند «کیت توسعه نرم‌افزار راننده» به‌روزرسانی‌های مکان را به‌سرعت پس‌از خرابی شبکه ازسر می‌گیرد. پس‌از اینکه اتصال شبکه دوباره برقرار شد، به‌روزرسانی‌های مکان در به‌روزرسانی مکان زمان‌بندی‌شده بعدی دوباره شروع می‌شود.

بهبود پایداری و رفع اشکال‌ها

• اکنون setVehicleState() بلافاصله برمی‌گردد. به‌روزرسانی FleetEngine اکنون در یک رشته پس‌زمینه انجام می‌شود. مشکل «برنامه پاسخ نمی‌دهد» (ANR) را برطرف می‌کند.
• مشکلی برطرف شد که باعث می‌شد مسیرهای هم‌رسانی سفر بااستفاده از نسخه‌های قدیمی‌تر «کیت توسعه نرم‌افزار مصرف‌کننده» به‌صورت خط مستقیم نمایش داده شود. اطمینان حاصل می‌کند که هیچ نقطه‌مسیر یک‌باره‌ای توسط Driver SDK به مسیر اضافه نشود.