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

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

v7.1.0 (14 мая 2026 г.)

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

• Добавлены зависимости Jetpack DataStore: androidx.datastore:datastore-coreверсия 1.1.7 и androidx.datastore:datastore-guavaверсия 1.2.0.

• Версия зависимости Kotlin обновлена до 2.3.0.

• Обновлена версия плагина Android Gradle до 8.13.2.

• Версия Gradle обновлена до 8.13.

• Версия библиотеки Desugar обновлена до 2.1.5.

• Расширен диапазон поддерживаемых версий Navigation SDK: теперь это [7.0, 8.0), а не [7.0, 7.3).

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

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

• Версия minSdkVersion обновлена до API 26.

• Обновление targetSdkVersion до API 36.

• Обновлены поддерживаемые версии Navigation SDK, начиная с 7.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 в зависимостях сборки приложения, чтобы контролировать, когда вы повышаете минимальную поддерживаемую ОС для новых версий приложения.

6.2.0 (18 июня 2025 г.)

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

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

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

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

• Обновлены поддерживаемые версии Navigation SDK, начиная с версии 6.1.0.

6.1.0 (10 марта 2025 г.)

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

• Улучшено ведение внутренних журналов.

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

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

• Исправлена проблема, из-за которой водители получали ошибки gRPC с кодом "INTERNAL" и сообщением "Panic! Описание "Это ошибка!" при первом запуске приложения после установки.

6.0.0 (25 ноября 2024 г.)

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

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

Обновления API

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

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

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

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

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

• Устранена проблема, из-за которой водители получали ошибки gRPC с кодом "INTERNAL" и сообщением "Panic! Это ошибка!" После интеграции выпуска будет постепенно увеличиваться процент пользователей, которым будет доступна эта функция (начиная с 0%).
• Внутренние улучшения, направленные на уменьшение количества ошибок подключения при обновлении данных о местоположении, особенно при переключении между сетями. После интеграции выпуска будет постепенно развертываться (начиная с 0%).

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

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

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

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

• Обновлен Navigation SDK до версии 5.x.
• Обновлен API minSdkVersion до версии 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).

4.99.0 (9 августа 2023 г.)

• Поддержка разных версий зависимости NavSDK. ** Поддерживаются версии 4.5.0 и более поздние, но не 5.0.0.
• Не допускать уменьшения расчетного времени прибытия, когда автомобиль стоит на месте. Это изменение внедряется постепенно в рамках эксперимента, поэтому оно будет доступно не во всех приложениях одновременно.

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

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

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

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

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

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

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

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

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

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

4.4.1 (18 ноября 2022 г.)

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

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

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

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

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

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

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

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

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

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

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

Объявление: прекращение поддержки Android 5 (21 июля 2022 г.)

Мы продлили поддержку приложений, работающих на Android 5, ещё на год. Это относится к уровням API 21 и 22.

Это означает следующее:

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

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

4.2.0 (8 июня 2022 г.)

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

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

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

Обновления API

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

4.0.0 (29 ноября 2021 г.)

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

Обновления API

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

Изменение в VehicleStops API

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

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

• Функция getTasks пользователя VehicleStop заменена на функцию getTaskInfoList.

• Функция setTasks пользователя VehicleStop.Builder заменена на функцию setTaskInfoList.

Отслеживание сбоев

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

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

Async getRemainingVehicleStops

• Функция DeliveryVehicleReportergetRemainingVehicleStops теперь возвращает Future<List<VehicleStop>>, а не List<VehicleStop>.

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

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

• Пользователь ServiceType удален из группы AuthTokenContext.

• Пользователь getServiceType() удален из чат-группы AuthTokenContext.

• Пользователь setServiceType удален из группы AuthTokenContext.Builder.

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

Версия 3.0.4 (28 июля 2021 г.)

Функции

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

Обновления API

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

`RidesharingDriverApi.getDriverSdkVersion()`

Повышена стабильность, исправлены ошибки.

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

Объявление о прекращении поддержки (21 июня 2021 г.)

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

Nav/Driver SDK для Android будет разделен на Navigation SDK для Android версии 3.x и Driver SDK для Android версии 3.x (отдельные двоичные файлы).

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

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

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

Какие изменения произойдут?

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

• Два файла вместо одного.
• Более понятные определения пакетов для классов Driver SDK для Android.
• В Navigation SDK для Android входит Maps SDK для Android (начиная с версии 2).
  • Это позволяет использовать на одной карте как функции работы с картой, так и функции навигации (например, рисовать ломаные линии на 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. Чтобы лучше понять эти изменения, ознакомьтесь с руководством по переходу.

Прекращение поддержки Driver SDK для Android и Navigation SDK для Android версии 1.x

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

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

Поэтому поддержка Nav/Driver SDK версии 1.x прекращена 21 июня 2022 года.

Узнайте, как работает прекращение поддержки версий SDK.

Прекращение поддержки Navigation SDK и Driver SDK для Android 21 и 22

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

Обновления API

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

Повышена стабильность, исправлены ошибки.

• Исправлен сбой среды выполнения gRPC.

v1.15.2

Функции

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

Повышена стабильность, исправлены ошибки.

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

Версия 1.15.1 (12 мая 2020 г.)

Функции

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

Повышена стабильность, исправлены ошибки.

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

Версия 1.15.0 (23 марта 2019 г.)

Функции

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

Повышена стабильность, исправлены ошибки.

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

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

Функции

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

v1.13.0

Повышена стабильность, исправлены ошибки.

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

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

Повышена стабильность, исправлены ошибки.

• Теперь после того, как для определенного пункта назначения сработает триггер onArrival(), уведомления о местоположении продолжат обновляться.
• Уведомление по умолчанию (постоянная строка в режиме Free Nav) соответствует цветовой схеме, заданной для уведомлений навигатора. Подробнее о постоянных уведомлениях…
• Устранена проблема, из-за которой задержка в уведомлении о местоположении могла привести к ложному обновлению местоположения, что вызывало такие артефакты, как прямая линия в начале маршрута.

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

Обновления API

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

Повышена стабильность, исправлены ошибки.

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