درایور SDK برای یادداشت‌های انتشار اندروید

این بخش شامل یادداشت‌های انتشار برای Driver SDK برای اندروید است.

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

مطابق با سیاست پشتیبانی از نسخه سیستم‌عامل موبایل ، ما پشتیبانی از اندروید ۶ و ۷ (سطح API 23، 24 و 25) را در نسخه‌های اصلی آتی Driver SDK برای اندروید متوقف می‌کنیم.

نسخه‌های درایور SDK برای اندروید که از سه‌ماهه چهارم سال ۲۰۲۵ منتشر می‌شوند، حداقل از اندروید ۸ (سطح API ۲۶) پشتیبانی می‌کنند. نسخه‌های قبلی SDK همچنان از اندروید ۶ و ۷ پشتیبانی خواهند کرد.

اگر وابستگی‌های شما شماره نسخه را مشخص نکنند، IDE شما جدیدترین نسخه SDK را بارگذاری می‌کند و نسخه‌های جدید برنامه شما از اندروید ۶ و ۷ پشتیبانی نمی‌کنند.

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

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

رفع اشکالات

  • رفع مشکل خطای NullPointerException هنگام فراخوانی DriverApi.createInstance() زمانی که DriverStatusListener ارائه نشده بود.

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

  • با شروع نسخه ۶.۲.۰ از Driver SDK برای اندروید، برنامه‌ها باید به Kotlin 2.1 ارتقا یابند.

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

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

رفع اشکالات

  • بهبودهای ثبت وقایع داخلی.

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

رفع اشکالات

  • مشکلی که باعث می‌شد درایورها در اولین اجرای برنامه پس از نصب، خطاهای gRPC با کد "INTERNAL" و توضیح "Panic! This is a bug!" دریافت کنند، برطرف شد.

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

رفع اشکالات

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

به‌روزرسانی‌های API

  • رابط منسوخ شده‌ی StatusListener حذف شد.

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

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

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

رفع اشکالات

  • مشکلی که باعث می‌شد درایورها خطاهای gRPC با کد "INTERNAL" و توضیح "Panic! This is a bug!" دریافت کنند، برطرف شد. این مشکل به تدریج (با شروع از 0%) پس از انتشار نسخه جدید، برطرف خواهد شد.
  • بهبود داخلی برای کاهش خطاهای اتصال به‌روزرسانی موقعیت مکانی، به‌ویژه هنگام تغییر شبکه دستگاه. این قابلیت پس از انتشار نهایی، به‌تدریج (از ۰٪ شروع می‌شود) اعمال خواهد شد.

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

  • وابستگی به glide:cronet-integration در POM.xml حذف کنید

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

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

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

رفع اشکالات

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

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

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

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

  • وابستگی Navigation SDK را به نسخه ۴.۵ به‌روزرسانی کنید. توجه داشته باشید که شناسه‌های گروه و مصنوعات برای Navigation SDK تغییر کرده‌اند.

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

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

  • وابستگی SDK ناوبری را به نسخه ۴.۴.۱ ارتقا دهید.

نسخه ۴.۴.۲ (۱۵ فوریه ۲۰۲۳)

رفع اشکالات

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

  • درخواست‌های UpdateVehicle که فقط شامل یک مکان "خام" هستند را حذف کنید.

  • رفع مشکل شرایط مسابقه در رابط برنامه‌نویسی کاربردی آلفای «مرور مسیر».

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

رفع اشکالات

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

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

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

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

رفع اشکالات

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

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

  • وابستگی SDK ناوبری را به نسخه ۴.۲.۲ ارتقا دهید.

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

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

اطلاعیه: پشتیبانی از فریز کردن برای اندروید ۵ (۲۱ ژوئیه ۲۰۲۲)

برای آخرین نسخه SDK ما (نسخه ۴.۲.۰)، ما یک سال پشتیبانی اضافی برای برنامه‌هایی که روی اندروید ۵ اجرا می‌شوند، برای هر دو سطح API ۲۱ و ۲۲ ارائه می‌دهیم.

این یعنی چی:

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

این اطلاعیه، اطلاعیه توقف پشتیبانی اندروید ۲۱ و ۲۲ از ۲۱ ژوئن ۲۰۲۱ و توقف پشتیبانی اندروید ۲۳، ۲۴ و ۲۵ از ۱۸ اکتبر ۲۰۲۱ را لغو می‌کند.

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

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

  • وابستگی Nav SDK را به نسخه ۴.۱.۳ ارتقا دهید.
  • حداقل سطح پشتیبانی‌شده‌ی API اندروید را به ۲۱ کاهش می‌دهد.

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

به‌روزرسانی‌های API

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

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

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

به‌روزرسانی‌های API

برای این نسخه، درایور SDK برای اندروید با تغییرات زیر به‌روزرسانی شده است.

تغییر API مربوط به VehicleStops

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

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

  • تابع getTasks مربوط به VehicleStop با تابع getTaskInfoList جایگزین شد.

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

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

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

توقف‌های وسیله نقلیه باقی‌مانده (VehicleStops) در حالت ناهمگام (async)

احراز هویت

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

۱۸ اکتبر ۲۰۲۱ - پشتیبانی از فریز کردن برای API سطح ۲۳، ۲۴ و ۲۵

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

در پاسخ به تغییرات در وابستگی‌های داخلی ما، از سه‌ماهه سوم سال ۲۰۲۲، اندروید API سطح ۲۳، ۲۴ و ۲۵ (اندروید ۶، ۷.۰ و ۷.۱) در نسخه‌های جدید کیت‌های توسعه نرم‌افزار (SDK) ناوبری و درایور برای اندروید پشتیبانی نخواهند شد.

کیت‌های توسعه نرم‌افزار (SDK) ناوبری و درایور برای نسخه‌های اندروید که از سه‌ماهه سوم سال 2022 منتشر می‌شوند، فقط از دستگاه‌هایی پشتیبانی می‌کنند که حداقل از رابط برنامه‌نویسی اندروید سطح 26 استفاده می‌کنند.

نسخه‌های برنامه ساخته شده با نسخه ۴.x یا پایین‌تر از SDKهای ناوبری و درایور برای اندروید، همچنان روی دستگاه‌هایی که API اندروید سطح ۲۵ و پایین‌تر را اجرا می‌کنند، کار خواهند کرد.

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

ویژگی‌ها

با این نسخه، SDK درایور رسماً از SDK ناوبری جدا شده است. برای جزئیات بیشتر به راهنمای مهاجرت مراجعه کنید.

به‌روزرسانی‌های API

متدهای زیر اضافه شد:

`RidesharingDriverApi.getDriverSdkVersion()`

پایداری و رفع اشکالات

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

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

این اطلاعیه، منسوخ شدن درایور SDK برای اندروید و ناوبری SDK برای اندروید را از تاریخ ذکر شده در بالا شرح می‌دهد. این اطلاعیه همچنین به عنوان یک اطلاعیه اجباری سرویس (MSA) برای مشتریان آسیب‌دیده ارسال شده است.

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

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

لطفاً توجه داشته باشید که درایور SDK برای اندروید برای عملکردهای اصلی مسیریابی، وابستگی الزامی به Navigation SDK برای اندروید دارد.

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

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

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

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

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

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

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

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

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

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

اطلاعیه لغو شده را بخوانید

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

  • نسخه‌های برنامه‌ای که با نسخه‌های قدیمی‌تر از v4.x ساخته شده‌اند، همچنان روی دستگاه‌های اندروید ۲۱ و ۲۲ کار خواهند کرد. برنامه‌های درایور شما که SDK های فعلی ما را ادغام کرده‌اند، روی دستگاه‌هایی که اندروید ۲۱+ را اجرا می‌کنند، همچنان کار خواهند کرد. این مانند قبل است.
  • نسخه‌های برنامه ساخته شده با Driver SDK برای اندروید و Navigation SDK برای اندروید نسخه ۴.x (که برای سه ماهه چهارم ۲۰۲۱ در نظر گرفته شده است، ممکن است تغییر کند) و پس از آن، قابل نصب بر روی دستگاه‌هایی با اندروید ۲۱ و ۲۲ نخواهند بود. نسخه ۴.x با حداقل اندروید ۶.۰ (سطح API ۲۳) اجرا می‌شود، بنابراین نسخه‌های برنامه شما که با نسخه ۴.x که در راه است، ساخته می‌شوند، فقط توسط رانندگانی با دستگاه‌هایی با اندروید ۲۳+ قابل دریافت هستند. مجدداً تأکید می‌کنم، این بدان معناست که هم تغییرات مربوط به SDK ما و هم هرگونه تغییری که در برنامه ایجاد کرده‌اید، به رانندگانی با دستگاه‌هایی با اندروید ۲۱ و ۲۲ نمی‌رسد.

نسخه‌های Navigation SDK برای اندروید نسخه ۳ و Driver SDK برای اندروید نسخه ۳ که باید به آنها ارتقا دهید، به همراه زمان انتشار آنها در جدول زیر توضیح داده شده است.

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

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

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

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

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

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

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

اگر در حال حاضر در ... هستید آیا از این ظرفیت‌ها استفاده می‌کنید؟ برای ارتقا همین الان برای ارتقا در سپتامبر 2021 لینک‌های مهاجرت
نسخه ۱.x
(از قابلیت FleetEngine.java / Driver استفاده نمی‌کند )
خیر NavSDK نسخه ۳.۰ راهنما
بله هیچ گزینه‌ای وجود ندارد NavSDK 3.x
نسخه ۱.x
(با استفاده از قابلیت FleetEngine.java / درایور)
خیر هیچ گزینه‌ای وجود ندارد NavSDK 3.x +
درایور SDK 3.x
راهنمای بالا، به علاوه راهنمای مهاجرت به نسخه ۳.۰ درایور که در زمان انتشار موجود است.
بله

توصیه می‌کنیم قبل از ادغام Driver SDK برای اندروید و Navigation SDK برای اندروید نسخه v4.x و بالاتر در برنامه درایور خود، به رانندگان خود که دستگاه‌هایشان با اندروید ۲۱ و ۲۲ است، اطلاع دهید تا سیستم عامل خود را به نسخه جدیدتر اندروید (حداقل اندروید ۶.۰) ارتقا دهند.

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

به‌روزرسانی‌های API

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

پایداری و رفع اشکالات

  • مشکل کرش شدن gRPC در زمان اجرا برطرف شد.

نسخه ۱.۱۵.۲

ویژگی‌ها

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

پایداری و رفع اشکالات

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

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

ویژگی‌ها

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

پایداری و رفع اشکالات

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

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

ویژگی‌ها

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

پایداری و رفع اشکالات

  • نسخه minSdk برای navsdk به ۱۹ افزایش یافت.
  • اشکالی که باعث می‌شد نام‌های lat/lng Waypoint در صورت عدم موفقیت در ژئوکدینگ معکوس سمت سرور، شناسایی نشوند، برطرف شد.

نسخه ۱.۱۴.۲ منتشر شد (۲ فوریه ۲۰۱۹)

ویژگی‌ها

  • از ارسال صفر تا صد مکان توسط DriverSDK به Fleet Engine جلوگیری می‌کند (ورودی‌های بهتر اشتراک‌گذاری سفر و تخصیص مکان).
  • ثبت وقایع اضافی برای بهبود مشکلات مربوط به موقعیت مکانی گیر کرده و کاهش خطاهای احتمالی در اشتراک‌گذاری سفر.
  • فراخوانی‌های مکرر تابع setLocationReportingInterval() را نادیده بگیرید، مگر اینکه بازه زمانی تغییر کند.
  • javadocs برای متد setReportingInterval() به‌روزرسانی شد، با هدف جلوگیری از فراخوانی مکرر این متد با نرخ بالا نسبت به فواصل زمانی مورد استفاده.
  • قابلیت اطمینان موقعیت مکانی API 29 بهبود یافته است.

نسخه ۱.۱۳.۰

پایداری و رفع اشکالات

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

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

پایداری و رفع اشکالات

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

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

به‌روزرسانی‌های API

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

پایداری و رفع اشکالات

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