--- metadata: - name: generator content: Diplodoc Platform v5.54.2 alternate: - https://appmetrica.yandex.com/docs/en/sdk/android/changelog-android.md - https://appmetrica.yandex.com/docs/ru/sdk/android/changelog-android.md - href: ru/sdk/android/changelog-android.md type: text/markdown title: Markdown version - href: ../../llms.txt type: text/markdown title: llms.txt --- > **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.com/docs/ru/llms.txt # История изменений ## AppMetrica SDK ### Версия 8.5.0 {#s-8-5-0} Релиз 29 июля 2026 г. - Добавлена возможность указывать собственный хост в `AppMetricaLibraryAdapter`. - Добавлены методы `AppMetrica.clearErrorEnvironment`, `AppMetricaYandex.clearErrorEnvironment` и `IReporter.clearErrorEnvironment` для очистки error environment. - Добавлена поддержка error environment для вторичного репортера через `IReporter.putErrorEnvironmentValue`, `ReporterConfig.Builder.withErrorEnvironmentValue` и `ReporterYandexConfig.Builder.withErrorEnvironmentValue`. - `ServiceScreenshotCaptor` удален из механизма обнаружения скриншотов. - Минимальная поддерживаемая версия OkHttp повышена до `4.12.0`. ### Версия 8.4.1 {#s-8-4-1} Релиз 18 июля 2026 г. - Исправлена отправка данных для пустых сессий. ### Версия 8.4.0 {#s-8-4-0} Релиз 16 июля 2026 г. - Добавлен новый модуль `io.appmetrica.analytics:analytics-product-flow` и API для [трекинга продуктовых сценариев и офферных событий](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-product-flow.md). Подробнее о подходе — в статье [Офферные события в продуктовых сценариях](https://appmetrica.yandex.com/docs/ru/data-collection/offers.md). - Исправлено применение `ReporterConfig.Builder.withAppEnvironmentValue` к вторичному репортеру при создании. - Исправлено возможное падение при вызове `registerReceiver`. - Инициализация регулярного выражения для разбиения длинных строк в логгере отложена до первого использования. ### Версия 8.3.2 {#s-8-3-2} Релиз 10 августа 2026 г. - Исправлено скользящее накопление idle-соединений OkHttp из-за создания нового `OkHttpClient` для каждого сетевого запроса: клиенты теперь переиспользуют общий `ConnectionPool` и `Dispatcher`. ### Версия 8.3.1 {#s-8-3-1} Релиз 18 июля 2026 г. - Исправлена отправка данных для пустых сессий. ### Версия 8.3.0 {#s-8-3-0} Релиз 5 июня 2026 г. - Поддержан [автосбор Ad Revenue из AppLovin MAX v12](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#send-adrevenue-simple-integration-applovin-max). Подробнее о модулях — в разделе [Список модулей](https://appmetrica.yandex.com/docs/ru/sdk/android/android-modules.md). ### Версия 8.2.0 {#s-8-2-0} Релиз 5 мая 2026 г. - Добавлено получение [install referrer из RuStore](https://appmetrica.yandex.com/docs/ru/mobile-tracking/technology.md#install-referrer). - Добавлен новый модуль `io.appmetrica.analytics:analytics-ad-revenue-other` для сбора [Ad Revenue данных из иных источников](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#send-adrevenue-manual-integration). - Исправлена проблема, которая могла приводить к тому, что [`profileId`](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#send-profile-id) не применялся при активации AppMetrica SDK. Проблема могла возникнуть при одновременном использовании AppMetrica SDK и Yandex Ads SDK. ### Версия 8.1.0 {#s-8-1-0} Релиз 13 апреля 2026 г. - Исправлен возможный deadlock `main (blocked):tid=1 at io.appmetrica.analytics.impl.D4.a(SourceFile:18)`. - Очистка событий и сессий после отправки происходят в рамках одной транзакции базы данных. - Устранена потенциальная проблема, при которой события могли отправляться не в хронологическом порядке из-за неатомарного чтения из БД. - Исправлена проблема, из-за которой крэш мог отображаться в неверной версии приложения. Проблема затрагивала случаи, когда происходило несколько крэшей подряд. - Изменен подход к определению timestamp крэша. Ранее время крэша могло определяться на основании timestamp последнего отправленного события. - Скорректирована логика отправки [install referrer](https://appmetrica.yandex.com/docs/ru/mobile-tracking/technology.md#install-referrer): теперь install referrer отправляется из источника, который совпадает с установщиком приложения. - Оптимизирована запись данных на диск: переход на буферизированную запись существенно сокращает количество IO-операций и объем записываемых данных. - Обновлены SQL-запросы в слое работы с базой данных: форматированные строки некоторых запросов заменены на параметризованные запросы — это должно повысить эффективность работы с базой данных и устранить срабатывание детекторов, обнаруживающих SQL-injection. - Исправлен `StrictModeHelper$ViolationException: UnsafeIntentLaunchViolation: Launch of unsafe intent: Intent { act=io.appmetrica.analytics.IAppMetricaService...` при подключении к сервису AppMetrica. - Исправлен `StrictModeHelper$ViolationException: DiskReadViolation at io.appmetrica.analytics.impl.Ve.a(SourceFile:4)` при запуске сервиса AppMetrica SDK. - Исправлена возможная неконсистентность `UUID` в некоторых краевых случаях (обновление SDK через несколько мажорных версий): в API отдавался `UUID`, который отличался от `UUID`, отправляемого с событиями. - Увеличен `targetSdkVersion` и `compileSdkVersion` до `36`. - Обновлена версия `org.jetbrains.kotlin:kotlin-stdlib` до `1.9.25`. - Обновлена версия JVM target до `1.8`. - Восстановлена обработка колбеков основного сервиса на фоновом потоке, что должно исправить ANR: `at io.appmetrica.analytics.impl.p5.d`, `at io.appmetrica.analytics.impl.b4.a`, `at io.appmetrica.analytics.impl.tb.c`. - Оптимизировано получение [рекламных идентификаторов](https://appmetrica.yandex.com/docs/ru/sdk/android/get-ad-id.md). - Если значение `deviceId` доступно, то вызов `AppMetrica.getDeviceID()` возвращает его без активации. Иначе возвращается `null`. Подробнее о получении идентификаторов — в [документации](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#get-ids). ### Версия 8.0.1 {#s-8-0-1} Релиз 5 апреля 2026 г. - Исправлен возможный deadlock `main (blocked):tid=1 at io.appmetrica.analytics.impl.D4.a(SourceFile:18)`. - Восстановлена обработка колбеков основного сервиса на фоновом потоке, что должно исправить ANR: `at io.appmetrica.analytics.impl.p5.d`, `at io.appmetrica.analytics.impl.b4.a`, `at io.appmetrica.analytics.impl.tb.c`. ### Версия 7.14.3 {#s-7-14-3} Релиз 5 апреля 2026 г. - Восстановлена обработка колбеков основного сервиса на фоновом потоке, что должно исправить ANR: `at io.appmetrica.analytics.impl.p5.d`, `at io.appmetrica.analytics.impl.b4.a`, `at io.appmetrica.analytics.impl.tb.c`. ### Версия 7.14.2 {#s-7-14-2} Релиз 3 марта 2026 г. - Исправлено предупреждение `StrictModeHelper$ViolationException: UnsafeIntentLaunchViolation: Launch of unsafe intent: Intent { act=io.appmetrica.analytics.IAppMetricaService...` при подключении к сервису AppMetrica. - Исправлено предупреждение `StrictModeHelper$ViolationException: DiskReadViolation at io.appmetrica.analytics.impl.Ve.a(SourceFile:4)` при запуске сервиса AppMetrica SDK. ### Версия 8.0.0 {#s-8-0-0} Релиз 1 января 2026 г. - Переработана реализация сетевых запросов. По-умолчанию они происходят с использованием OkHttp. При необходимости использовать старую реализацию сетевых запросов сделайте exclude модуля `io.appmetrica.analytics:analytics-network-okhttp` и подключите `io.appmetrica.analytics:analytics-network-legacy`. - Удален метод `AppMetrica.reportReferralUrl`. - Добавлен модуль `io.appmetrica.analytics:analytics-apphud-v3` для работы с AppHud SDK с версией `3.0.0` и больше. Подробности в статье [AppMetrica и Apphud](https://appmetrica.yandex.com/docs/ru/data-collection/apphud/apphud-about.md). ### Версия 7.14.1 {#s-7-14-1} Релиз 28 декабря 2025 г. - Исправлена автоматическая очистка БД событий при достижении лимита, если отключена отправка данных. - Добавлена realtime-отправка данных в модуле [`analytics-id-sync`](https://appmetrica.yandex.com/docs/ru/sdk/android/android-modules.md). ### Версия 7.14.0 {#s-7-14-0} Релиз 26 ноября 2025 г. - Поддержан [автосбор Ad Revenue из IronSource v9](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#send-adrevenue-automatic-integration-ironsource). - Добавлена [возможность отправлять first-party данные в аттрибутах пользовательского профиля](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#send-attribute-profile-1pd). - Добавлена возможность переопределить путь для сохранения основных файлов баз данных через системное свойство `ro.yndx.metrica.db.dir`. Эта возможность может быть использована производителями устройств с небольшим объемом памяти для оптимизации использования памяти. - Компоненты BroadcastReceiver, используемые в SDK, будут вызываться сразу на фоновом потоке. - Исправлено возможное падение `java.util.ConcurrentModificationException at io.appmetrica.analytics.impl.Hr.a(SourceFile:15)`. - Исправлен возможный ANR `at io.appmetrica.analytics.impl.vn.uncaughtException(SourceFile:19)`. - Исправлен возможный ANR `at io.appmetrica.analytics.internal.AppMetricaService.onCreate(AppMetricaService.java:44)`. ### Версия 7.13.0 {#s-7-13-0} Релиз 17 октября 2025 г. - Добавлен новый опциональный модуль [`analytics-id-sync`](https://appmetrica.yandex.com/docs/ru/sdk/android/android-modules.md). Данный модуль предоставляет инфраструктуру для работы с несколькими поставщиками идентификаторов пользователей, обеспечивая анонимный таргетинг на аудиторию и объединение идентификаторов при сохранении конфиденциальности пользователя. Это повышает общую эффективность работы в кроссплатформенном окружении. - Добавлен новый опциональный модуль [`analytics-billing`](https://appmetrica.yandex.com/docs/ru/sdk/android/android-modules.md). Данный модуль инкапсулирует всю функциональность по [автоматическому сбору сведений об inapp-покупках](https://appmetrica.yandex.com/docs/ru/data-collection/about-revenue.md) и позволяет полностью исключить ее из приложения, сделав `exclude` данного модуля. - Исправлен возможный крэш `java.lang.NullPointerException: Attempt to invoke virtual method 'void io.appmetrica.analytics.impl.I5.e()' on a null object reference at io.appmetrica.analytics.impl.ef.onWaitFinished(:13)`. ### Версия 7.12.0 {#s-7-12-0} Релиз 4 сентября 2025 г. - Изменена зависимость iron source на `com.unity3d.ads-mediation:mediation-sdk` рамках сбора [Ad Revenue](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#send-adrevenue) данных. - Обновлен [список версий зависимостей](https://github.com/appmetrica/appmetrica-sdk-android/blob/main/dependencies_versions.yaml), с которыми проверена совместимость. ### Версия 7.11.0 {#s-7-11-0} Релиз 21 августа 2025 г. - Добавлена полноценная поддержка библиотеки Google Play Billing Library v8. Подробнее об [отправке Revenue](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#send-revenue) и [In-App покупках](https://appmetrica.yandex.com/docs/ru/data-collection/about-revenue.md). - Улучшено определение [типа устройства](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#device-type) для TV. - Исправлено вероятное падение `java.lang.NullPointerException: Attempt to invoke virtual method void io.appmetrica.analytics.impl.x5.d() on a null object reference at io.appmetrica.analytics.impl.xe.a`. ### Версия 7.10.0 {#s-7-10-0} Релиз 11 июля 2025 г. - Добавлено ограничение отправки любых сетевых запросов из SDK при [отключении отправки статистики](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#stat). Ранее мог отправлятся сетевой запрос, получающий конфигурацию SDK. - Исправлена проблема, которая могла приводить к тому, что сессия не завершалась после крэша. - Исправлен возможный крэш `java.lang.NoSuchMethodError: No virtual method enablePendingPurchases` при использовании библиотеки Google Play Billing v8 library. На текущий момент автоматический сбор покупок из Google Play Billing v8 не работает. Полноценная поддержка будет добавлена в будущих версиях. - Зависимость Google Play Services Ads Identifiers была понижена до версии `com.google.android.gms:play-services-ads-identifier:18.1.0` для предотвращения возможного крэша `java.lang.NoClassDefFoundError: com.google.android.gms.ads.identifier.zzd` в версии 18.2.0 на устройствах с Android 6 и ниже. - Обновлена зависимость AppHud SDK to `com.apphud:ApphudSDK-Android:2.9.2`. ### Версия 7.9.0 {#s-7-9-0} Релиз 8 мая 2025 г. - Основные компоненты AppMetrica SDK перенесены в основной процесс приложения. Теперь AppMetrica SDK полностью работает в основном процессе приложения. Отказ от отдельного процесса снимает возможные интеграционные проблемы с другими библиотеками вроде Firebase Perfomance. - Добавлена поддержка для будущего автосбора ad revenue данных из плагинов. - Исправлены возможные ANR: - `at com.android.billingclient.api.BillingClientImpl.zzaJ(BillingClientImpl.java:1)` ([issue#19](https://github.com/appmetrica/appmetrica-sdk-android/issues/19)). - `at io.appmetrica.analytics.impl.Uf.onInstallReferrerSetupFinished(Uf.java:3)` ([issue#20](https://github.com/appmetrica/appmetrica-sdk-android/issues/20)). ### Версия 7.8.0 {#s-7-8-0} Релиз 10 апреля 2025 г. - Добавлен опциональный модуль `io.appmetrica.analytics:analytics-screenshot`. Он отслеживает создание пользователем скриншота. При этом отправляется клиентское событие `appmetrica_system_event_screenshot`. Для корректной работы нужно добавить в AndroidManifest.xml разрешение [android.permission.DETECT_SCREEN_CAPTURE](https://developer.android.com/reference/android/Manifest.permission#DETECT_SCREEN_CAPTURE). Подробнее о модуле — в разделе [Список модулей](https://appmetrica.yandex.com/docs/ru/sdk/android/android-modules.md). - Исправлена проблема дублирования автособранных данных об inapp-покупках. - Исправлена проблема автоматического сбора сведений об очень старых inapp-покупках, которые могли засчитаться текущей датой и исказить отчет. - **Обновление совместимых зависимостей:** - Google Play Services Location до `com.google.android.gms:play-services-location:21.0.1`; - Google Play Billing до `com.android.billingclient:billing:7.1.1`; - Google Play Ads до `com.google.android.gms:play-services-ads:24.1.0`; - AppLovin SDK до `com.applovin:applovin-sdk:13.1.0`; - FairBid SDK до `com.fyber:fairbid-sdk:3.59.0`; - AppHud SDK до `com.apphud:ApphudSDK-Android:2.9.1`; - Google Play Services AppSet ID до `com.google.android.gms:play-services-appset:16.1.0`; - Google Play Services Ads Identifiers до `com.google.android.gms:play-services-ads-identifier:18.2.0`. - В `AppMetricaLibraryAdapter` добавлена возможность управлять доступом к [рекламным идентификаторам](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#track-adv-identifiers). ### Версия 7.7.0 {#s-7-7-0} Релиз 14 февраля 2025 г. * В события [ad revenue](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#send-adrevenue) добавлена информация об исходном типе рекламы. * Добавлен тип `APP_OPEN` для ad revenue событий в [AdMob](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#send-adrevenue-simple-integration-google-admob). * Обновлен Apphud SDK до версии 2.8.4 в модуле ad revenue. * Исправлены возможные ANR: - `at io.appmetrica.analytics.impl.nm.onDestroy(nm.java:1)` ([issue#16](https://github.com/appmetrica/appmetrica-sdk-android/issues/16)). - `at io.appmetrica.analytics.networktasks.internal.NetworkCore.stopTasks(NetworkCore.java:1)` ([issue#17](https://github.com/appmetrica/appmetrica-sdk-android/issues/17)). ### Версия 7.6.0 {#s-7-6-0} Релиз 23 января 2025 г. * Исправлена возможная проблема со статистикой (установки и новые пользователи) при одновременном использовании плагинов AppMetrica SDK (Unity, ReactNative, Flutter) и плагинов Yandex Ads SDK. * Исправлен возможный ANR при обращении к API AppMetrica SDK до активации AppMetrica SDK. ### Версия 7.5.0 {#s-7-5-0} Релиз 5 декабря 2024 г. * Добавлен API для управления доступом к рекламным идентификаторам (GAID, Huawei OAID). Подробнее в [документации](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#track-adv-identifiers). ### Версия 7.4.0 {#s-7-4-0} Релиз 29 ноября 2024 г. * Доработан механизм обработки реферрера, что позволило исправить ошибку получения [отложенного диплинка](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-deferred-deeplinks.md) и его параметров при установке приложения по трекинговой ссылке на последних версиях браузера с движком chromium (Google Chrome, Yandex Browser и т.д.). ### Версия 7.3.0 {#s-7-3-0} Релиз 5 ноября 2024 г. * Добавлены методы `AppMetrica#reportAnr()` и `IReporter#reportAnr()`, которые позволяют отправлять сведения об [ANR](https://appmetrica.yandex.com/docs/ru/mobile-reports/anr.md) вручную. * Исправлено возможное падение `java.lang.IllegalArgumentException:... at io.appmetrica.analytics.impl.K7.a(K7.java:27)`. * Исправлено предупреждение `Missing class com.google.android.gms.ads.AdValue` во время сборки приложения ([issue#10](https://github.com/appmetrica/appmetrica-sdk-android/issues/10)). ### Версия 7.2.2 {#s-7-2-2} Релиз 23 октября 2024 г. * Добавлена дополнительная проверка полной инициализации AppMetrica SDK. ### Версия 7.2.1 {#s-7-2-1} Релиз 3 октября 2024 г. * Улучшено определение факта непервого запуска приложения в рамках активации AppMetrica SDK через адаптер для сторонних библиотек. * При отправке событий через адаптер для сторонних библиотек до его активации или с некорректными аргументами они будут проигнорированы вместо выбрасывания исключения. ### Версия 7.2.0 {#s-7-2-0} Релиз 11 сентября 2024 г. * Удален локальный механизм детектирования собственных крэшей AppMetrica SDK, AppMetrica Push SDK в пользу серверного решения. * Добавлен модуль `io.appmetrica.analytics:analytics-apphud` для интеграции с Apphud. Подробности в статье [AppMetrica и Apphud](https://appmetrica.yandex.com/docs/ru/data-collection/apphud/apphud-about.md). * Добавлен API для упрощения отправки ILRD (Impression Level Revenue Data) из [Google AdMob](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#send-adrevenue-simple-integration-google-admob) для рекламного формата App open ad. * Улучшено логирование событий. ### Версия 7.1.0 {#s-7-1-0} Релиз 21 августа 2024 г. - Добавлен API для упрощения отправки ILRD (Impression Level Revenue Data) из: - [Digital Turbine](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#send-adrevenue-simple-integration-digital-turbine) - [Google AdMob](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#send-adrevenue-simple-integration-google-admob) - [Applovin MAX](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#send-adrevenue-simple-integration-applovin-max) - Добавлена ускоренная отправка на сервер некоторых событий (атрибуций из внешних SDK, `e-commerce`, `revenue`, `ad revenue` (Impression Level Revenue Data)). ### Версия 7.0.0 {#s-7-0-0} Релиз 28 июня 2024 г. **Ломающие изменения:** * Текущая версия `minSdkVersion` повышена до `21` (Android 5.0). * Версии `sourceCompatibility` и `targetCompatibility` повышены до Java 1.8. **Дополнения:** * Добавлена корректировка сообщений крэшей и ошибок c некорректным форматом. Корректировка исправит возможное падение ```java translate=no java.lang.IllegalArgumentException: Unpaired surrogate at index 14 at io.appmetrica.analytics.protobuf.nano.CodedOutputByteBufferNano.encodedLengthGeneral(Unknown Source) ``` * Исправлен возможный ANR `at io.appmetrica.analytics.impl.sk.a(sk.java:1)`. * Исправлен возможный крэш ```java translate=no java.lang.NullPointerException: Attempt to invoke virtual method 'void io.appmetrica.analytics.impl.Nb.a(io.appmetrica.analytics.impl.ie)' on a null object reference at io.appmetrica.analytics.impl.Qb.b(SourceFile:10) ``` * Добавлен лимит в 100 событий, отправляемых в одном запросе на сервер. Введение лимита повысит производительность SDK в условиях нестабильного сетевого канала. * Оптимизирована работа с потоками на клиентской стороне и удалены устаревшие проверки корректности интеграции SDK. Оптимизация снизит время синхронной части активации SDK. ### Версия 6.5.0 {#s-6-5-0} Релиз 26 апреля 2024 г. * Добавлена возможность отправки атрибуции из Singular (требуемый API доступен в [Singular SDK 12.5.1 и выше](https://support.singular.net/hc/en-us/articles/360041068651-Android-SDK-Change-Log)). Подробности в статье [Импорт атрибуций из других SDK](https://appmetrica.yandex.com/docs/ru/data-collection/attribution-integration.md). * Удалена обфускация названий аргументов методов в API. ### Версия 6.4.0 {#s-6-4-0} Релиз 11 апреля 2024 г. * Добавлена поддержка автоматического получения `impression level revenue data` из источников: [Ironsource V7](https://developers.is.com/) ([документация](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#send-adrevenue-automatic-integration-ironsource)), [Fyber V3](https://developer.digitalturbine.com/hc/en-us) ([документация](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#send-adrevenue-simple-integration-digital-turbine)). См. также [выключение автосбора Ad Revenue](https://appmetrica.yandex.com/docs/ru/sdk/android/off-adrevenue.md) и [конфликт при использовании автосбора для Fyber](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-errors.md#fyber-unsupport-adrevenue). * Исправлена ошибка, которая выводилась в системный лог: ``` E ActivityThread: Failed to find provider info for com.yandex.preinstallsatellite.appmetrica.provider ``` ### Версия 6.3.0 {#s-6-3-0} Релиз 18 марта 2024 г. * Добавлены дополнительная валидация формата `UUID` и восстановление некорректного значения `UUID`. * Улучшен алгоритм детекта ANR — теперь ANR фиксируется только в том случае, если за отведенное время на главном потоке не смог выполниться единственный `Runnable`. Алгоритм находит “тяжелые“ задачи, приводящие к зависанию главного потока. Ранее детект ANR срабатывал, когда на главном потоке исполнялось большое количество небольших `Runnable` — в таких ситуациях стектрейс ANR обычно был неинформативен и малополезен. * Теперь в результате подвисания одного `Runnable` будет формироваться один ANR отчет. Это уменьшит количество отчетов об ANR, но повысит их полезность. * Исправлен возможный ANR `at io.appmetrica.analytics.internal.AppMetricaService.onCreate` ([issue#3](https://github.com/appmetrica/appmetrica-sdk-android/issues/3)). * Исправлено возможное падение `org.json.JSONException: Forbidden numeric value: NaN` при отправке external атрибуций (`AppMetrica#reportExternalAttribution(...)`). ### Версия 6.2.1 {#s-6-2-1} Релиз 26 января 2024 г. * Исправлена ошибка в сериализации внешних атрибуций. ### Версия 6.2.0 {#s-6-2-0} Релиз 22 января 2024 г. * Добавлен метод `AppMetrica.reportExternalAttribution` для отправки атрибуций из сторонних библиотек. Подробности в статье [Импорт атрибуций из других SDK](https://appmetrica.yandex.com/docs/ru/data-collection/attribution-integration.md). * Исправлена проблема, которая приводила к тому, что не выводились логи о сохранении и отправке событий на сервер. ### Версия 6.1.0 {#s-6-1-0} Релиз 28 ноября 2023 г. * Увеличен `buildToolsVersion` до `34.0.0`. * Увеличен `targetSdkVersion` и `compileSdkVersion` до `34`. * Обновлена версия kotlin-плагина до `org.jetbrains.kotlin:kotlin-gradle-plugin:1.6.21`. * Поддержан [автосбор покупок и подписок](https://appmetrica.yandex.com/docs/ru/data-collection/about-revenue.md), совершаемых через библиотеку `com.android.billingclient:billing:6.0.0`. Удален автосбор покупок и подписок, совершаемых через библиотеку `com.android.billingclient:billing:4.+`. Теперь автосбор покупок и подписок доступен для версий `com.android.billingclient:billing:5.0.0` и выше. Подробнее об [отправке Revenue](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#send-revenue). * Исправлен возможный deadlock `at io.appmetrica.analytics.networktasks.internal.NetworkCore.onDestroy`. ### Версия 6.0.0 {#s-6-0-0} Релиз 13 сентября 2023 г. * Обновлены идентификатор библиотеки, корневой пакет и API. Подробнее в [инструкции по миграции](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/migration-io-6-0-0.md). * Удалена интеграция с breakpad. Сейчас используется только Crashpad. Для отлова нативных крэшей нужно использовать зависимость `io.appmetrica.analytics:analytics-ndk-crashes:3.0.0`. Подробнее в разделе про [нативные крэши](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#native-crashes). * Разрешение `com.google.android.gms.permission.AD_ID` перемещено в модуль `io.appmetrica.analytics:analytics-identifiers`. * Исправлен возможный warning при установке и запуске приложения `Class io.appmetrica.analytics.impl.ob.Zh failed lock verification and will run slower` и аналогичные ему. * Исправлен возможный ANR `at io.appmetrica.analytics.impl.ob.p3$b.onServiceConnected(SourceFile:2)`. * Работа с гео вынесена в отдельную зависимость: `io.appmetrica.analytics:analytics-location`. Теперь при необходимости можно отказаться от сбора координат AppMetrica SDK на этапе сборки приложения. Это может быть необходимо для отдельных категорий приложений в соответствии с политиками Google Play. Подробности в [документации](https://appmetrica.yandex.com/docs/ru/sdk/android/geo-exclude.md). * Поддержан API для получения различных идентификаторов AppMetrica SDK (`DeviceId`, `DeviceIdHash`, `UUID`) — метод `AppMetrica#requestStartupParams`. Подробности в [документации](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#get-ids). * Поддержан API для указания типа устройства (телефон, планшет, ТV, авто). Подробности в [документации](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#device-type). ### Версия 5.3.0 {#s-5-3-0} Релиз 3 марта 2023 г. * Исправлен возможный warning при установке и запуске приложения `Class com.yandex.metrica.impl.ob.Zh failed lock verification and will run slower` и аналогичные. * Исправлен возможный ANR `at com.yandex.metrica.impl.ob.p3$b.onServiceConnected(SourceFile:2)`. * Исправлены ошибки и повышена стабильность. ### Версия 5.2.0 {#s-5-2-0} Релиз 19 сентября 2022 г. * Добавлен API AdRevenue для передачи доходов рекламной монетизации на уровне показа (Impression-Level Revenue Data): * классы `AdRevenue`, `AdRevenue.Builder`. * Методы `reportAdRevenue(AdRevenue adRevenue)` в классе `YandexMetrica`, `reportAdRevenue(AdRevenue adRevenue)` в интерфейсе `IReportet`. * перечисление `AdType`. Подробности в разделах [Отправка Ad Revenue](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#send-adrevenue) и [Ad Revenue](https://appmetrica.yandex.com/docs/ru/data-collection/about-adrevenue.md). * Версия targetSdkVersion = 33. ### Версия 5.0.1 {#s-5-0-1} Релиз 29 июля 2022 г. * Исправлена проблема, которая могла приводить к повторным ложным установкам. ### Версии 5.0.0 — 4.0.0 {% cut "5.0.0 — 4.0.0" %} #### Версия 5.0.0 {#s-5-0-0} Релиз 20 мая 2022 г. {% note info %} Начиная с версии AppMetrica Android SDK 5.0.0 и выше при переустановке приложения на смартфоне меняется appmetrica_device_id. Это обусловлено новыми политиками Google. Подробности в [документации](https://appmetrica.yandex.com/docs/ru/troubleshooting/troubleshooting.md#change-device-id). {% endnote %} * Получение рекламных идентификаторов вынесено в отдельную библиотеку `com.yandex.android:mobmetricalib-identifiers`. Подробнее в разделе [Получение рекламных идентификаторов](https://appmetrica.yandex.com/docs/ru/sdk/android/get-ad-id.md). * По умолчанию выключен признак отправки информации о локации устройства. Чтобы включить отправку локации с событиями используйте один из методов: `withLocationTracking(boolean enabled)` или `setLocationTracking(boolean enabled)`. Подробности в разделах [Отправка местоположения устройства библиотекой](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#track-location) и [Определение местоположения](https://appmetrica.yandex.com/docs/ru/data-collection/geo.md). * Добавлены @NonNull-аннотации для аргументов методов интерфейса `DeferredDeeplinkParametersListener`. * Метод `reportNativeCrash` устарел и в будущих версиях будет удален. #### Версия 4.2.0 {#s-4-2-0} Релиз 17 февраля 2022 г. * Добавлен новый API для отслеживания крэшей и ошибок из произвольных плагинов. Интерфейсы: * YandexMetricaPlugins; * IPluginReporter. Классы: * PluginErrorDetails; * PluginErrorDetails.Builder; * StackTraceItem; * StackTraceItem.Builder. * Поддержан даунгрейд на версию 4.2.0 и выше с сохранением важных данных: идентификаторов устройства и т. д. Использовать даунгрейд не рекомендуется, это может привести к потере и искажению данных. Повторная атрибуция для таких пользователей не произойдет. * Добавлена поддержка Google Play Billing Library версии 4.0.0. Поддержка версий 3.x продолжается. Подробнее об [In-App покупках](https://appmetrica.yandex.com/docs/ru/data-collection/about-revenue.md). * В методе `DeferredDeeplinkParametersListener` аргумент `referrer` стал `@NonNull`. В случае его отсутствия придет пустая строка. * Убрали определение ROOT-статуса на устройствах с Android 12 и выше. На текущий момент все устройства с Android 12 будут считаться устройствами без ROOT-доступа. * Исправлены ошибки и повышена стабильность: * Исправлен возможный крэш при попытке подключения к сервису MetricaService: ``` Process: com.yandex :Metrica java.lang.RuntimeException: Unable to bind to service com.yandex.metrica.MetricaService Caused by: java.lang.IllegalArgumentException at android.os.Parcel.nativeAppendFrom(Native Method). ``` * Исправлен возможный ANR в процессе: ``` Metrica: at com.yandex.metrica.impl.ob.jg.a (jg.java) at com.yandex.metrica.MetricaService.onConfigurationChanged(MetricaService.java:2) ``` * Исправлен возможный крэш: ``` java.lang.NullPointerException: Attempt to read from null array at com.yandex.metrica.impl.ob.tz.a ``` #### Версия 4.1.1 {#s-4-1-1} Релиз 17 декабря 2021 г. * Добавлено разрешение [com.google.android.gms.permission.AD_ID](https://support.google.com/googleplay/android-developer/answer/6048248#zippy%3D%252Cpersistent-identifiers-including-android-id%252Ctargeting-devices-without-an-advertising-id%252Cadvertising-id-violations%252Chow-to-opt-out-of-personalized-ads). Подробности читайте в [документации](https://appmetrica.yandex.com/docs/ru/sdk/android/get-ad-id.md). * В `DeferredDeeplinkListener.Error` и `DeferredDeeplinkParametersListener.Error` добавлено значение `NO_REFERRER`. Добавлена предварительная поддержка [App Set ID](https://developer.android.com/training/articles/app-set-id) для получения реферрера из Google Play (зависимость `com.google.android.gms:play-services-appset:16.0.0`). * Поддержана оптимизация SDK из-за исправления возможных [VerifyError](https://source.chromium.org/chromium/chromium/src/+/master:build/android/docs/class_verification_failures.md;bpv=1;bpt=0) при инициализации классов. * Отключен сбор mac адресов. #### Версия 4.0.0 {#s-4-0-0} Релиз 20 сентября 2021 г. * Google Play Install Referrer через BroadcastReceiver больше не поддерживается: * удален из AndroidManifest `MetricaEventHandler`; * удален метод `YandexMetrica#registerReferrerBroadcastReceivers`; * удален флаг `YandexMetricaConfig#installedAppCollecting`; * удалены методы `YandexMetricaConfig.Builder#withInstalledAppCollecting`. * Добавлен метод `YandexMetricaConfig.Builder#withSessionsAutoTrackingEnabled(boolean enabled)` для [автоматического отслеживания сессий](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-listen.md). * Добавлен метод `revenueAutoTrackingEnabled` для [автоматического сбора данных по in-app покупкам](https://appmetrica.yandex.com/docs/ru/data-collection/about-revenue.md). * Поддержана публикация ".module" файла для [Google Play SDK Console](https://support.google.com/googlepl..-developer/answer/10358880?hl=ru). * Реализован и включен по умолчанию [автотрекинг диплинков](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#deeplink). Подробнее — в статье [Трекинг deeplink](https://appmetrica.yandex.com/docs/ru/data-collection/deeplinks.md). * AppMetrica SDK [смигрирован на AndroidX](https://developer.android.com/jetpack/androidx/migrate). * Добавлена базовая поддержка Android 12 — основной функционал AppMetrica SDK доступен на устройствах с Android 12 в приложениях с targetSdkVersion = 31. * minSdkVersion повышен до 14. {% endcut %} ## AppMetrica Gradle Plugin Подробнее о подключении и настройке — в разделе [AppMetrica Gradle Plugin](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-gradle-plugin.md) и статье [Загрузка mapping-файлов и отладочных символов на Android](https://appmetrica.yandex.com/docs/ru/data-collection/upload-mapping.md). ### Версия 2.1.0 {#c-2-1-0} Релиз 17 июня 2026 г. - Добавлены экстеншены для корректной настройки плагина в Kotlin DSL. - Исправлена ошибка, приводящая к игнорированию системных свойств Java. ### Версия 2.0.1 {#c-2-0-1} Релиз 16 марта 2026 г. - Увеличена скорость работы плагина. Задача для генерации ресурсов подключается только при включенном плагине. ### Версия 2.0.0 {#c-2-0-0} Релиз 3 марта 2026 г. - Переработан экстеншен для настройки плагина. - Таски переделаны для поддержки Gradle Configuration Cache. - Добавлена поддержка AGP до версии `8.13.+` (кроме `8.0.+`) и Gradle до `9.2.1`. - Таски для [загрузки нативных символов](https://appmetrica.yandex.com/docs/ru/data-collection/upload-mapping.md) вызываются автоматически после сборки приложения. - Удалена поддержка AGP 4. - Исправлено нахождение типа обфускатора. - Удалён вероятный warning `Invalid cookie header`. ### Версия 1.3.0 {#c-1-3-0} Релиз 18 августа 2025 г. - Подключаемая версия `analytics-ndk-crashes` обновлена до `3.1.0`. - Добавлена поддержка AGP до версии `8.12.+` (кроме `8.0.+`) и gradle до `8.13`. ### Версия 1.2.0 {#c-1-2-0} Релиз 15 июля 2025 г. - Исправлена ошибка `NegativeArraySizeException`. - Расширено логирование. - Добавлена поддержка AGP до версии `8.8.+` (кроме `8.0.+`) и gradle до `8.12`. - Исправлено получении версии AGP. ### Версия 1.0.1 {#c-1-0-1} Релиз 4 декабря 2024 г. * Исправлено значение поля `version_name` в `info.txt` файле. ### Версия 1.0.0 {#c-1-0-0} Релиз 27 ноября 2024 г. * Поддержано подключение плагина с помощью `pluginManagement`. Плагин переименован в `io.appmetrica.analytics`. * Все действия в плагине выполняются в отдельных gradle-тасках. * Изменен список версий gradle и AGP, с которыми работает плагин. * Поддержана работа при включенном configuration cache. * Исправлена ошибка, из-за которой при определенных настройках `R8` удалялись необходимые для работы ресурсы. ### Версия 0.11.0 {#c-0-11-0} Релиз 2 мая 2024 г. * Исправлена ошибка `Cannot write a file to a location pointing at a directory`. * Удалено использование `Deprecated` класса `VersionNumber`. ### Версия 0.10.0 {#c-0-10-0} Релиз 26 апреля 2024 г. * Добавлен `keep` для ресурсов, добавляемых плагином для AGP `8.2.+`. ### Версия 0.9.0 {#c-0-9-0} Релиз 26 февраля 2024 г. * Добавлена поддержка AGP до версии `8.2.+` (кроме `8.0.+`) и gradle до `8.6`. ### Версия 0.8.2 {#c-0-8-2} Релиз 31 октября 2023 г. * Исправлен `StackOverflowError` при наличии циклических зависимостей. ### Версия 0.8.1 {#c-0-8-1} Релиз 4 октября 2023 г. * Исправлено возможное падение при проверке использования двух версий AppMetrica, если в проекте несколько модулей. ### Версия 0.8.0 {#c-0-8-0} Релиз 14 сентября 2023 г. * Изменено название плагина на `io.appmetrica.analytics:gradle:0.8.0`. * Зависимость `com.yandex.android:mobmetricalib-ndk-crashes:1.1.0` обновлена до `io.appmetrica.analytics:analytics-ndk-crashes:3.0.0`. * Добавлена поддержка работы с `io.appmetrica.analytics:analytics:6.0.0`. * Добавлен параметр `allowTwoAppMetricas`, позволяющий убрать проверку на использование разных версий AppMetrica. ### Версия 0.7.0 {#c-0-7-0} Релиз 19 апреля 2023 г. * Дополнена ошибка об отсутствии mapping файлов. * Добавлена поддержка AGP до версии `7.4.+` и gradle до `7.5`. ### Версия 0.6.2 {#c-0-6-2} Релиз 28 июля 2022 г. * Улучшена работа плагина. ### Версия 0.6.1 {#c-0-6-1} Релиз 20 мая 2022 г. * Улучшена работа плагина. ### Версия 0.6.0 {#c-0-6-0} Релиз 17 мая 2022 г. * Добавлен параметр mappingFile. * Исправлена ошибка Cannot query the value of this property because it has no value available при получении mapping файла. ## AppMetrica Push SDK Подробнее о подключении и настройке — в разделе [Подключение и инициализация](https://appmetrica.yandex.com/docs/ru/sdk/android/push/quick-start.md). Список модулей — в статье [Список опциональных модулей для Push SDK](https://appmetrica.yandex.com/docs/ru/sdk/android/push/android-modules-push.md). ### Version 4.3.0 {#v-4-3-0} Релиз 26 марта 2026 г. - Удален модуль `plugin-adapter`. Вместо него используется анонимная активация AppMetrica SDK — активация с сохраненной ранее конфигурацией, если приложение еще не выполнило активацию самостоятельно. Подробнее в разделе [Подключение и инициализация](https://appmetrica.yandex.com/docs/ru/sdk/android/push/quick-start.md). - Добавлена автоматическая активация AppMetrica SDK для упрощения обработки событий в сервисах. Это улучшит доставляемость событий Push SDK, так как убраны возможные гонки при инициализации Push SDK и AppMetrica SDK. - Минимальная версия AppMetrica SDK увеличена до `7.1.0`. - Обновлена версия `org.jetbrains.kotlin:kotlin-stdlib` до `1.9.25`. - Обновлена версия JVM target до `1.8`. - Увеличен `targetSdkVersion` и `compileSdkVersion` до `36`. ### Версия 4.2.1 {#v-4-2-1} Релиз 13 сентября 2025 г. - Ускорена активация AppMetrica Push SDK. - Класс `AppMetricaPushTracker` помечен как `Deprecated`, используйте `AppMetricaPush.reportPushEvent`. - Метод `AppMetricaPush.addPushMessageTracker(PushMessageTracker)` помечен как `Deprecated`, используйте `AppMetricaPush.addPushEventListener`. - Добавлен URI экшена в событие `custom` и `open`. - Обновлен список версий зависимостей, с которыми проверяется совместимость. ### Версия 4.1.1 {#v-4-1-1} Релиз 25 января 2025 г. - Исправлена работа метода `PushServiceController.shouldSendToken`. Токен не отправляется, если `shouldSendToken == false` или `token == null`. - Зависимость `androidx.legacy:legacy-support-v4` заменена на `androidx.core:core`. ### Версия 4.0.0 {#v-4-0-0} Релиз 11 июля 2024 г. - Текущая версия `minSdkVersion` повышена до `21` (Android 5.0). - Конструктор `AppMetricaPushTracker` изменен с `AppMetricaPushTracker()` на `AppMetricaPushTracker(Context)`. - Изменен интерфейс `PushServiceController`: - Метод `getTitle` переименован в `getTransportId`. - Добавлены методы `getExecutionRestrictions` и `shouldSendToken`. - Улучшена доставка и скорость обработки push-нотификаций. ### Версия 3.3.0 {#v-3-3-0} Релиз 3 мая 2024 г. - Исправлена обработка пуша в `plugin-adapter`. ### Версия 3.2.0 {#v-3-2-0} Релиз 22 апреля 2024 г. - Обновлена поддерживаемая версия RuStore до `ru.rustore.sdk:pushclient:2.1.1`. Подробнее о модуле — в разделе [Список опциональных модулей для Push SDK](https://appmetrica.yandex.com/docs/ru/sdk/android/push/android-modules-push.md). - Добавлен модуль `plugin-adapter` для корректной работы Push SDK при использовании в плагинах. Подробнее в разделе [Список опциональных модулей для Push SDK](https://appmetrica.yandex.com/docs/ru/sdk/android/push/android-modules-push.md). - Добавлено сохранение для названий переменных в публичном API. ### Версия 3.1.1 {#v-3-1-1} Релиз 9 апреля 2024 г. - Удалены отладочные логи. ### Версия 3.1.0 {#v-3-1-0} Релиз 2 апреля 2024 г. - Исправлена доставка silent-пушей при отключенных уведомлениях. ### Версии 3.0.0 — 2.0.0 {% cut "3.0.0 — 2.0.0" %} #### Версия 3.0.0 {#v-3-0-0} Релиз 18 ноября 2023 г. - Обновлены идентификатор библиотеки, корневой пакет и API. Подробнее в [инструкции по миграции](https://appmetrica.yandex.com/docs/ru/sdk/android/push/migration-io-3-0-0.md). - Добавлено API для кастомизации нотификации, создаваемой SDK. - Удалена поддержка `com.yandex.android:mobmetricalib`. #### Версия 2.3.3 {#v-2-3-3} Релиз 10 ноября 2023 г. - Исправлено падение при наличии двух версий AppMetrica SDK в приложении одновременно. #### Версия 2.3.2 {#v-2-3-2} Релиз 4 октября 2023 г. - Исправлена ошибка ``` No field Companion of type Lio/appmetrica/analytics/ModuleEvent$Companion ``` #### Версия 2.3.1 {#v-2-3-1} Релиз 31 июля 2023 г. - Повышены производительность и стабильность работы библиотеки. #### Версия 2.2.0 {#v-2-2-0} Релиз 2 июня 2022 г. - `minSdkVersion` (в `appmetricapush-provider-hms`) увеличена до 17. - Обновлена версия `hms` до 6.5.0.300. - Ускорена активация PushSDK. #### Версия 2.1.1 {#v-2-1-1} Релиз 14 марта 2022 г. - Исправлена ошибка `BadParcelableException: Parcelable protocol requires a Parcelable.Creator object called CREATOR`. #### Версия 2.1.0 {#v-2-1-0} Релиз 24 февраля 2022 г. - Улучшено получение токенов. - Метод YandexMetricaPush.getTokens возвращает новые токены при вызове из TokenUpdateListener.onTokenUpdated. - Повышены производительность и стабильность работы библиотеки. #### Версия 2.0.0 {#v-2-0-0} Релиз 28 октября 2021 г. - Исправлена ошибка, возникающая в некоторых случаях при обработке клика по пушу на Android 12. - Переход с support-зависимостей на AndroidX. {% endcut %} ## AppMetrica NDK Crashes Подробнее об отлове нативных крэшей — в разделе [Отслеживание нативных аварийных остановок приложения](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#native-crashes). ### Версия 3.1.0 {#ndk-3-1-0} Релиз 30 июля 2025 г. - Обновлен крэшпад до коммита [46a5690fc061117f00dd48920de7b13c7db29da4](https://chromium.googlesource.com/crashpad/crashpad/+/46a5690fc061117f00dd48920de7b13c7db29da4). - Реализована поддержка [размеров страниц 16 КБ](https://developer.android.com/guide/practices/page-sizes) в .so файлах. ### Версия 3.0.0 {#ndk-3-0-0} Релиз 13 сентября 2023 г. - Обновлен Crashpad до коммита [9158eb7caa811b684c6bec7f9e9b5f52389d0ce0](https://chromium.googlesource.com/crashpad/crashpad/+/9158eb7caa811b684c6bec7f9e9b5f52389d0ce0). Для отлова нативных крэшей используйте зависимость `io.appmetrica.analytics:analytics-ndk-crashes:3.0.0`. Подробнее в разделе про [нативные крэши](https://appmetrica.yandex.com/docs/ru/sdk/android/analytics/android-operations.md#native-crashes).