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

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

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

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

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

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

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

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

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

• Исправлена ​​проблема, из-за которой драйверы получали ошибки gRPC с кодом «ВНУТРЕННИЙ» и «Паника! Это ошибка!» описание.
• Внутреннее улучшение для уменьшения ошибок подключения при обновлении местоположения, особенно когда устройство переключает сети. Это будет внедряться постепенно (начиная с 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 года. См. раздел «Соблюдение требований к целевому уровню API Google Play» .

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

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

• Исправлена ​​проблема, из-за которой драйверы получали ошибки gRPC с кодом «ВНУТРЕННИЙ» и «Паника! Это ошибка!» описание. Это будет внедряться постепенно (начиная с 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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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.
• Понижает минимальный поддерживаемый уровень Android API до 21.

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

Обновления API

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

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

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

Обновления API

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

Изменение API VehicleStops

Объекты VehicleStop теперь ссылаются на список объектов TaskInfo вместо объектов List of Task . Если вам нужно состояние 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.

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 для 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 для Android обязательно зависит от Navigation SDK для Android для основных функций маршрутизации.

Каковы изменения?

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

• Два двоичных файла вместо одного.
• Более четкие определения пакетов для классов Driver SDK для Android.
• Навигационный SDK для Android включает в себя Maps SDK для Android (начиная с Навигационного SDK для Android версии 2).
  • Это позволяет картам и функциям навигации сосуществовать на одной карте (например, рисование полилиний в NavigationView) и снижает использование памяти, поскольку используется одна карта вместо двух.
  • Навигационный SDK для Android 3.0 не имеет полной функциональности с Навигационным 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 v1.x

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, когда SDK сообщает о местоположениях. Это стало результатом улучшений onArrival() , которые были подвержены конфликтам блокировок. При некоторых обстоятельствах нам удалось надежно воспроизвести ошибки ANR и убедиться, что исправления решили проблему. Модифицированное тестовое приложение для создания ошибок ANR работало в течение восьми часов без ошибок после исправления.

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

Функции

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

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

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

Выпуск v1.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 (04 октября 2019 г.)

Обновления API

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

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

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