apptracer_flutter_android 0.2.1

Android implementation of apptracer_flutter, the unofficial Flutter integration with Tracer (apptracer.ru). Forwards Dart errors to the ru.ok.tracer Android SDK.

apptracer_flutter_android

Реализация apptracer_flutter под Android — неофициальной интеграции Flutter с Tracer.

Не связан с VK и OK.TECH, не одобрен и не поддерживается ими.

English version: README.en.md.

Зависеть от этого пакета напрямую не нужно: его подтягивает apptracer_flutter.

Что он делает

Передаёт ошибки Dart в ru.ok.tracer:tracer-crash-report. Нативные краши, ANR и метрику crash-free этот SDK считает сам — плагин добавляет только ту половину, которую SDK не видит.

Ошибка Dart заворачивается в синтетический Throwable, чей stackTrace собран из кадров Dart. Если отдавать вместо этого стек JVM, у всех ошибок Dart в приложении окажутся одинаковые кадры, и Tracer схлопнет их в одну проблему.

Подключение

SDK Tracer подключён здесь как compileOnly, поэтому его добавляет само приложение — вместе с Gradle-плагином ru.ok.tracer, откуда берётся appToken. См. README.

Настройку SDK пакет ставит себе сам, без строчки в манифесте: рейт-лимит на нефатальные (10 в час вместо жёстких 8 за сессию — а каждая ошибка Dart здесь нефатальная). Кладёт её TracerAutoConfigProvider, который система создаёт раньше провайдера Tracer. Application, реализующий HasTracerConfiguration, эту конфигурацию отменяет — на такой случай в пакете есть TracerApplication, от которого наследуются. Почему так и чем это рискованно — в TracerAutoConfig.

О четырёх вещах плагин скажет в рантайме, а не промолчит. Первые две его выключают:

• SDK Tracer отсутствует в classpath рантайма;
• Gradle-плагин ru.ok.tracer не применён — определяется по отсутствию сгенерированного ресурса tracer_app_token;
• передан TracerOptions.appToken — на Android он игнорируется;
• передан TracerOptions.environment — тоже игнорируется, значение берётся из Gradle-плагина.

Требует minSdk 21 — как и ru.ok.tracer:tracer-commons.

Android tombstones (SDK 1.5.2)

Экспериментальные системные отчёты о нативных крэшах выключены по умолчанию. Чтобы включить их без собственного Application, добавьте внутрь <application> в android/app/src/main/AndroidManifest.xml:

<meta-data
    android:name="ru.apptracer.flutter.experimentalTombstoneEnabled"
    android:value="true" />

Нужны Tracer Android 1.5.2 и Android 12 / API 31+. Функция входит в tracer-crash-report; модуль tracer-crash-report-native необязателен и остаётся полезным для нативных крэшей на старых версиях Android. Tombstones позволяют символизировать системные библиотеки, но не гарантируют символизацию Dart AOT. Отчёты восстанавливаются при последующем запуске SDK.

Собственный Application, реализующий HasTracerConfiguration, заменяет настройки пакета. В его существующем CrashReportConfiguration.Builder вызовите setExperimentalTombstoneEnabled(true) и при необходимости сохраните лимит нефатальных событий. Наследник TracerApplication учитывает флаг манифеста.

Флаг работает при автоматическом и отложенном запуске. Он задаётся на Android до инициализации SDK, а не через Dart TracerOptions. Для отложенного сбора по-прежнему нужны удаление провайдеров из манифеста и явный startCollection; сам флаг сбор не запускает. Сохраните nexus-external.vkteam.ru/repository/maven/ в репозиториях плагинов и зависимостей и выполните чистую сборку после обновления.