Driver SDK для Android: примечания к выпуску

В этом разделе приведены примечания к выпуску комплекта разработки драйверов для Android.

v7.0.0 (5 декабря 2025 г.)

Изменения зависимостей и конфигурации.

• Обновлена minSdkVersion до API 26.

• Обновлена ​​версия targetSdkVersion до API 36.

• Обновленный SDK навигации поддерживает версии, начиная с v7.0.0.

v6.99.0 (5 декабря 2025 г.)

• Внутренние улучшения

Объявление: Замораживается поддержка API уровней 23, 24 и 25.

В соответствии с политикой поддержки версий мобильных ОС , мы приостанавливаем поддержку Android 6 и 7 (уровни API 23, 24 и 25) в будущих основных версиях Driver SDK для Android.

Начиная с версии 7.0.0, Driver SDK для Android будет поддерживать как минимум Android 8 (уровень API 26). Более ранние версии SDK продолжат поддерживать Android 6 и 7.

Если в зависимостях не указан номер версии, ваша IDE загрузит самую новую версию SDK, и новые сборки вашего приложения не будут поддерживать Android 6 и 7.

Укажите версию Driver SDK для Android в зависимостях сборки вашего приложения, чтобы контролировать, когда будет повышаться минимальная поддерживаемая версия ОС для новых версий вашего приложения.

v6.2.0 (18 июня 2025 г.)

Исправлены ошибки

• Исправлена ​​ошибка NullPointerException приводящая к сбою при вызове DriverApi.createInstance() , если не указан объект DriverStatusListener .

Изменения зависимостей и конфигурации.

• Начиная с версии 6.2.0 Driver SDK для Android, приложениям необходимо обновиться до Kotlin 2.1.

• Обновленный SDK навигации поддерживает версии, начиная с v6.1.0.

v6.1.0 (10 марта 2025 г.)

Исправлены ошибки

• Улучшения в системе внутреннего логирования.

v5.99.1 (10 января 2025 г.)

Исправлены ошибки

• Исправлена ​​ошибка, из-за которой драйверы получали ошибки gRPC с кодом "INTERNAL" и описанием "Panic! This is a bug!" при первом запуске приложения после установки.

v6.0.0 (25 ноября 2024 г.)

Исправлены ошибки

• Исправлена ​​ошибка, из-за которой драйверы получали ошибки gRPC с кодом "INTERNAL" и описанием "Panic! This is a bug!".
• Внутреннее улучшение, направленное на снижение количества ошибок подключения при обновлении местоположения, особенно при переключении устройств между сетями. Это улучшение будет внедряться постепенно (начиная с 0%) после интеграции в релиз.

Обновления API

• Удалён устаревший интерфейс StatusListener .

Изменения зависимостей и конфигурации.

• Удалите зависимость от glide:cronet-integration в файле POM.xml.
• Обновленный SDK навигации поддерживает версии 5.x.
• Начиная с версии 6.0.0 Driver SDK для Android, приложениям необходимо обновиться до Kotlin 2.0.
• Теперь targetSdk соответствует уровню API 34. Это требование распространяется на все приложения, размещаемые в Google Play Store начиная с августа 2024 года. См. раздел «Соответствие требованиям Google Play к уровню API target» .

v5.99.0 (20 сентября 2024 г.)

Исправлены ошибки

• Исправлена ​​ошибка, из-за которой драйверы получали gRPC-ошибки с кодом "INTERNAL" и описанием "Panic! This is a bug!". Это будет внедряться постепенно (начиная с 0%) после интеграции в релиз.
• Внутреннее улучшение, направленное на снижение количества ошибок подключения при обновлении местоположения, особенно при переключении устройств между сетями. Это улучшение будет внедряться постепенно (начиная с 0%) после интеграции в релиз.

Изменения зависимостей и конфигурации.

• Удалите зависимость от glide:cronet-integration в файле POM.xml.

v5.0.0 (12 сентября 2023 г.)

Изменения зависимостей и конфигурации.

• Обновлен SDK навигации до версии 5.x.
• Обновлена minSdkVersion до API 23.
• Обновлена ​​версия Kotlin до 1.9.0.
• Добавлена ​​зависимость от 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, должны включать функцию десахаризации. Инструкции см. на странице https://developer.android.com/studio/write/java8-support#library-desugaring.

Исправлены ошибки

• Исправлена ​​ошибка синхронизации disableLocationTracking.
• Введен новый интерфейс DriverStatusListener, который сообщает о причине в обновлениях статуса исключения.
• Исправлена ​​ошибка, из-за которой водители оставались неподвижными (доступно начиная с версии 4.99.0).

v4.99.0 (9 августа 2023 г.)

• Поддерживается широкий диапазон версий зависимостей NavSDK. ** Поддерживаются версии от v4.5.0 до (но не включая) v5.0.0.
• Предотвратить автоматическое уменьшение расчетного времени прибытия (ETA) в неподвижном состоянии транспортного средства. Это изменение внедряется постепенно в экспериментальном режиме, поэтому не во всех приложениях оно будет применено одновременно.

v4.5.0 (12 мая 2023 г.)

• Обновите зависимость Navigation SDK до версии 4.5. Обратите внимание, что идентификаторы группы и артефакта для Navigation SDK изменились.

v4.4.3 (20 марта 2023 г.)

Изменение зависимости

• Обновите зависимость Navigation SDK до версии 4.4.1.

v4.4.2 (15 февраля 2023 г.)

Исправлены ошибки

• Улучшено время восстановления сети при возникновении временных проблем с подключением в SDK. Это экспериментальное исправление.

• Отклонять запросы UpdateVehicle , содержащие только "сырое" местоположение.

• Исправлена ​​ошибка состояния гонки в API ALPHA "Обзор маршрута".

v4.4.1 (18 ноября 2022 г.)

Исправлены ошибки

• Исправлена ​​ошибка в логике загрузки данных о трафике.

Дополнительные изменения

• Внутренние улучшения в заголовках запросов и отчетности по кодам состояния.

v4.4.0 (21 сентября 2022 г.)

Исправлены ошибки

• Исправлена ​​ошибка, из-за которой уведомление "Поездка с Google Maps" не удалялось, если экземпляр API не был очищен.

Изменение зависимости

• Обновите зависимость Navigation SDK до версии 4.2.2.

v4.3.0 (24 августа 2022 г.)

Внутренние улучшения.

Анонс: Поддержка заморозки для Android 5 (21 июля 2022 г.)

В нашей последней версии SDK (v4.2.0) мы предоставляем дополнительный год поддержки приложений, работающих на Android 5, как для уровней API 21, так и для 22.

Что это значит:

• SDK навигации и SDK драйверов, работающие в ваших приложениях Android, будут поддерживать как минимум Android 5 (уровень API 21) до 30 июня 2023 года.
• После 30 июня 2023 года мы будем поддерживать только Android API уровней 23 и выше. Другими словами, мы прекратим поддержку Android API уровней 21 и 22 во всех версиях SDK после этой даты. Это означает, что ошибки, связанные с Android 21 или 22 в любой версии SDK (включая 4.x), не будут исправлены, и мы не гарантируем корректную работу SDK.

Данное уведомление отменяет уведомление о приостановке поддержки Android 21 и 22 от 21 июня 2021 года, а также уведомление о приостановке поддержки Android 23, 24 и 25 от 18 октября 2021 года.

v4.2.0 (8 июня 2022 г.)

Изменение зависимости

• Обновите зависимость Nav SDK до версии 4.1.3.
• Понижает минимальный поддерживаемый уровень API Android до 21.

v4.1.0 (28 апреля 2022 г.)

Обновления API

• Свойство parentId объекта Task переименовано в trackingId . Старое свойство пока ещё существует, но устарело.

v4.0.0 (29 ноября 2021 г.)

Минимальный поддерживаемый уровень API Android для этой версии — 23.

Обновления API

В этом релизе в комплект поставки Driver SDK для Android внесены следующие изменения.

Изменение API VehicleStops

Теперь объекты VehicleStop ссылаются на список объектов TaskInfo вместо списка объектов Task . Если вам необходимо отслеживать состояние задачи, рекомендуется делать это в коде вашего приложения.

• Добавлен новый класс: TaskInfo

• Функция getTasks из VehicleStop заменена функцией getTaskInfoList .

• Функция setTasks из VehicleStop.Builder заменена функцией setTaskInfoList .

мониторинг аварий

Для повышения стабильности SDK добавлена ​​функция мониторинга и отчетности о сбоях. Эта функция включена по умолчанию, но вы можете отключить ее, вызвав setAbnormalTerminationReportingEnabled() и передав ему значение false перед инициализацией SDK.

• В DriverApi добавлена ​​функция setAbnormalTerminationReportingEnabled .

Async getRemainingVehicleStops

• Изменена функция getRemainingVehicleStops класса DeliveryVehicleReporter : теперь она возвращает объект Future<List<VehicleStop>> вместо List<VehicleStop>.

Аутентификация

Удалены ненужные свойства из интерфейса AuthTokenContext . ServiceType устарел. Теперь вам нужно получать только утверждения для включенного идентификатора транспортного средства и идентификатора задачи, вместо того чтобы полагаться на ServiceType .

• Удалён ServiceType из AuthTokenContext .

• getServiceType() удален из AuthTokenContext .

• Удален setServiceType из AuthTokenContext.Builder .

18 октября 2021 г. — Замораживание поддержки API уровней 23, 24 и 25.

v3.0.4 (28 июля 2021 г.)

Функции

В этом релизе Driver SDK официально отделен от Navigation SDK. Подробности см. в руководстве по миграции .

Обновления API

Добавлены следующие методы:

`RidesharingDriverApi.getDriverSdkVersion()`

Стабилизация и исправление ошибок

Сообщайте об ошибках PERMISSION_DENIED а не классифицируйте их как ошибки подключения.

Объявление об устаревании (21 июня 2021 г.)

В этом объявлении описывается прекращение поддержки Driver SDK для Android и Navigation SDK для Android, начиная с указанной выше даты. Это объявление также было разослано в качестве обязательного сервисного уведомления (MSA) затронутым клиентам.

Nav/Driver SDK для Android будет преобразован в Navigation SDK for Android v3.x и Driver SDK for Android v3.x для Android (разделенные бинарные файлы).

Чтобы упростить интеграцию с клиентами и ускорить разработку полезных функций, мы разделяем Navigation SDK для Android и Driver SDK для Android на два разных исполняемых файла:

• Навигационный SDK для Android, который обеспечит водителям функциональность навигации/прокладки маршрута.
• Driver SDK для Android, который позволит вам использовать веб-сервисы Fleet Engine с сохранением состояния для отслеживания хода поездки или выполнения задачи, а также распределения ресурсов.

Обратите внимание, что для основных функций маршрутизации Driver SDK for Android является обязательным компонентом Navigation SDK for Android.

Какие произошли изменения?

Основные изменения в версии 3:

• Два двоичных числа вместо одного.
• Более понятные определения пакетов для классов Driver SDK для Android.
• В состав Navigation SDK для Android входит Maps SDK для Android (начиная с версии Navigation SDK для Android v2).
  • Это позволяет картам и навигационным элементам сосуществовать на одной карте (например, рисовать полилинии на NavigationView) и снижает потребление памяти, поскольку используется одна карта вместо двух.
  • В Navigation SDK для Android 3.0 отсутствует полная функциональная совместимость с Navigation SDK для Android, но версия 3.2 решит большинство проблем. Подробнее см. раздел «Что я могу сделать и когда?» .
• Ведение журналов позволит нам легче отлаживать проблемы, с которыми вы можете столкнуться.

В версии 3 также были удалены следующие методы, которые ранее были помечены как устаревшие и для которых уже существует альтернативное решение:

• Следующие методы Nav/Driver SDK были объявлены устаревшими в версии 1.16, выпущенной 10 августа 2020 года, и удалены в версии 3.0:
  • Waypoint#fromLatLng(*)
  • Waypoint#fromPlaceId(*)
  • Navigator#startGuidance(resumeIntent)
  • NavigationApi#initForegroundServiceManager(*)
• Для полноты картины и ясности отметим, что при переходе с версии 1 на версию 2 был удален ряд методов. Большинство из них представляли собой объединение дублирующихся классов между Navigation SDK для Android и Maps SDK для Android. Для лучшего понимания этих изменений, пожалуйста, ознакомьтесь с руководством по миграции .

Устаревшие версии 1.x: Driver SDK для Android и Navigation SDK для Android.

Nav/Driver SDK v1 был выпущен в 2018 году, и, поскольку скоро выйдут наши версии v3, пришло время отказаться от поддержки v1, чтобы избежать нецелесообразности поддержки множества основных версий.

Сэкономленное время, которое мы получим благодаря отсутствию необходимости поддерживать эту дополнительную версию, позволит нам лучше поддерживать последнюю основную версию и разрабатывать больше функций, важных для наших клиентов.

Таким образом, Nav/Driver SDK v1.x устарел и больше не будет поддерживаться после 21 июня 2022 года.

Пожалуйста, уделите немного времени, чтобы ознакомиться с тем, как работают устаревшие функции в версиях SDK .

Поддержка SDK для навигации и управления драйверами в Android 21 и 22 прекращена.

v1.15.3 (9 октября 2020 г.)

Обновления API

• Теперь Driver SDK подписывается на обновления информации о дорожной ситуации в Navigation SDK, которые отправляются в API Fleet Engine.

Стабилизация и исправление ошибок

• Исправлена ​​ошибка, приводившая к сбою в работе gRPC.

v1.15.2

Функции

Добавлена ​​возможность отключения постоянных уведомлений. Если отправка данных о местоположении остановлена ​​в экземпляре Fleet Engine, навигация в Navigator также прекращается, все обработчики событий навигации отменяются, а NavigationFragment или NavigationView приостанавливаются.

Стабилизация и исправление ошибок

• Исправлена ​​ошибка, из-за которой возникало исключение при очистке экземпляра Fleet Engine.

v1.15.1 (12 мая 2020 г.)

Функции

Предварительный анализ данных версии 1.15.0 показал значительные улучшения в стабильном отображении местоположения (уменьшение количества «застрявших» местоположений). Это исправление позволяет продолжить работу над улучшенным отображением местоположения. Проблема с ANR не была связана с этими улучшениями.

Стабилизация и исправление ошибок

• Исправлена ​​ошибка, из-за которой в потребительском приложении иногда отображалась прямая линия в начале маршрута.
• Исправлена ​​ошибка, которая могла привести к ANR (Account-Resources) при передаче данных о местоположении из SDK. Это было вызвано улучшениями в onArrival() , которые могли привести к конфликтам блокировок. Нам удалось надежно воспроизвести ошибки ANR при определенных условиях и убедиться, что исправления устранили проблему. Модифицированное тестовое приложение, генерирующее ошибки ANR, работало восемь часов без сбоев после исправления.

v1.15.0 (23 марта 2019 г.)

Функции

• Введено отображение статуса навигационных указаний в начале, при отклонении от маршрута и при прибытии для улучшения отслеживания местоположения транспортного средства.
• Добавлена ​​возможность продолжать получать точки привязки к дорогам независимо от состояния навигации.
• Добавлена ​​дополнительная информация о местах, где ранее были сделаны снимки дорог, например, о точности.

Стабильность и исправление ошибок

• Увеличен параметр minSdkVersion для navsdk до 19.
• Исправлена ​​ошибка, из-за которой имена путевых точек в формате широта/долгота не учитывались при сбое обратного геокодирования на стороне сервера.

Выпущена версия 1.14.2 (2 февраля 2019 г.)

Функции

• Предотвращает отправку DriverSDK местоположений 0,0 в Fleet Engine (более качественный ввод данных о местоположении при совместном использовании маршрутов и распределении мест).
• Дополнительная система логирования для улучшения решения проблем с зависанием местоположения и уменьшения количества резервных вариантов при совместном использовании маршрутов.
• Повторные вызовы функции setLocationReportingInterval() следует игнорировать, если интервал не изменяется.
• Обновлена ​​документация Java для метода setReportingInterval() с целью предотвращения частого повторного вызова этого метода относительно используемых интервалов.
• Повышена надежность определения местоположения по API 29.

v1.13.0

Стабилизация и исправление ошибок

• Добавляет зависимость от okhttp, которую клиентам придётся добавить в свои сборки Gradle.

v1.11.7 (18 октября 2019 г.)

Стабилизация и исправление ошибок

• Теперь обновление местоположения продолжается и после срабатывания метода onArrival() для заданного пункта назначения.
• Уведомление по умолчанию (постоянная строка в режиме свободной навигации) соответствует цветовой схеме, установленной для уведомлений навигации. Для получения дополнительной информации см. раздел «Общие постоянные уведомления» .
• Исправлена ​​проблема, из-за которой задержка обновления местоположения могла привести к ложному обновлению местоположения, вызывая такие искажения, как прямая линия в начале маршрута.

v1.11.6 (4 октября 2019 г.)

Обновления API

• Внесен ряд изменений, обеспечивающих быстрое возобновление обновления местоположения в Driver SDK после сбоя сети. После восстановления сетевого соединения обновление местоположения возобновится при следующем запланированном обновлении.

Стабилизация и исправление ошибок

• setVehicleState() теперь возвращает управление немедленно. Обновление FleetEngine теперь происходит в фоновом потоке. Устранена проблема с зависанием приложения (ANR).
• Исправлена ​​ошибка, из-за которой маршруты совместных поездок отображались в виде прямой линии в более старых версиях Consumer SDK. Гарантируется, что Driver SDK не добавляет к маршруту разовые промежуточные точки.