apptracer_flutter_ios 0.1.0

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

apptracer_flutter_ios

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

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

English version: README.en.md.

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

Что он делает

Передаёт ошибки Dart в SDK OKTracer как TracerNonFatalModel. Нативные краши, зависания и отчёты MetricKit этот SDK обрабатывает сам.

Стектрейс Dart не несёт нативных адресов, а переданный массив символов Tracer игнорирует, пока не подключён отладчик. Поэтому реализация синтезирует issueKey из типа ошибки Dart и её верхнего кадра — так ошибки всё же группируются по месту вызова. Передайте свой issueKey, чтобы это переопределить.

Breadcrumbs доставляются через TracerLogProviderProtocol, который не трогает настройки собственного логирования SDK.

Подключение

OKTracer лежит в собственном spec-репозитории вендора для CocoaPods и поставляется статическим xcframework, поэтому в ios/Podfile нужны и источник, и статическая линковка:

source 'https://github.com/odnoklassniki/tracer-ios.git'
source 'https://cdn.cocoapods.org/'

platform :ios, '13.0'

target 'Runner' do
  use_frameworks! :linkage => :static
  # ...
end

При pod install подспек добавляет в Runner.xcodeproj фазу сборки, которая отправляет dSYM при каждой release-сборке; TRACER_SKIP_IOS_PHASE=1 запрещает трогать файл проекта. Токен фаза берёт из ios/tracer_plugin_token или из TRACER_IOS_PLUGIN_TOKEN.

В отличие от Android, TracerOptions.appToken на iOS используется.