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

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

7.99.0 (11 ноября 2026 г.)

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

• Исправлена ошибка, из-за которой попытки установить защищенное подключение к Fleet Engine могли оставаться в состоянии ожидания неопределенное время, если промежуточный прокси-сервер оператора связи зависал во время настройки подключения. Это препятствовало обновлению статуса поездки и отслеживанию транспортных средств в некоторых мобильных сетях. Теперь Driver SDK принудительно применяет тайм-аут подключения и автоматически восстанавливает работу при новом подключении.

• Исправлены утечки потоков и исполнителей при вызове DriverApi.clearInstance() (исполнители FleetEngineEventHandler, FusedLocationWriter и DriverApi).

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

• Зависимости Jetpack DataStore (androidx.datastore:datastore-core и androidx.datastore:datastore-guava) обновлены до версии 1.2.1.

• Зависимость Kotlin обновлена до версии 2.4.0.

• Диапазон поддерживаемых версий Navigation SDK изменен на [7.9.0, 8.0.0).

7.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, 7.3) до [7.0, 8.0).

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

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

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

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

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

6.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 г.)

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

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

5.99.1 (10 января 2025 г.)

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

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

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

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

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

Обновления API

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

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

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

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

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

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

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

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

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

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

• Navigation 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).

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

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

4.5.0 (12 мая 2023 г.)

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

4.4.3 (20 марта 2023 г.)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

4.3.0 (24 августа 2022 г.)

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

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

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

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

• Navigation SDK и Driver SDK, работающие в ваших приложениях Android, будут поддерживать Android 5 (API уровня 21) до 30 июня 2023 года.
• После 30 июня 2023 года мы будем поддерживать только уровни API Android 23 и выше. Другими словами, после этой даты мы прекратим поддержку Android с уровнями 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.
• Минимальный поддерживаемый уровень Android API понижен до 21.

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

Обновления API

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

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

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

Обновления API

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

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

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

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

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

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

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

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

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

Асинхронный метод getRemainingVehicleStops

• Функция getRemainingVehicleStops класса DeliveryVehicleReporter теперь возвращает 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 также удалены следующие методы, которые ранее были помечены как устаревшие и для которых уже существует альтернативное решение:

• Следующие методы Navigation SDK и 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

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

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

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

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

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

Версия 1.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, работало восемь часов без сбоев.

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

Функции

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

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

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

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

Функции

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

v1.13.0

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

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

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

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

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

Версия 1.11.6 (4 октября 2019 г.)

Обновления API

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

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

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