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.

Подключение

Пакет поддерживает оба менеджера зависимостей Flutter для iOS: Swift Package Manager и CocoaPods. Flutter выбирает тот, который включён в приложении.

Swift Package Manager

Ничего настраивать не нужно: Package.swift объявляет OKTracer зависимостью от репозитория вендора по версии, и Xcode забирает SDK сам. Нижняя граница — 1.5.2: это первая версия, бинарники которой лежат на nexus-external.vkteam.ru; прежний хост вендор выключил 31.08.2026, и манифесты всех тегов до 1.5.2 ссылаются на него. Если Package.resolved приложения ещё держит 1.5.1, разрешите зависимости заново (File → Packages → Update to Latest Package Versions).

Package.swift не зависит ни от чего, что генерирует сам Flutter: import Flutter резолвится через framework search paths, которые Flutter передаёт сборке. Поэтому SPM-путь работает на любой версии, где SPM вообще есть, и констрейнт пакета остаётся >=3.22.0 для обоих путей. Так же устроены url_launcher_ios из flutter/packages и vkid_flutter_sdk.

Единственное отличие от CocoaPods — фазу выгрузки dSYM придётся добавить руками, потому что подспека, которая делает это при pod install, здесь никто не выполняет. В Xcode: цель Runner → Build Phases → + → New Run Script Phase, назовите её [apptracer_flutter] Upload dSYMs to Tracer и вставьте содержимое ios/tracer_dsym_upload_phase.sh.

То же самое делает команда пакета — она сама находит скрипт и правит проект, если в системе есть Ruby с gem xcodeproj (та же пара, на которой работает CocoaPods):

dart run apptracer_flutter:install_ios_dsym_phase

Повторный запуск безопасен: существующая фаза обновляется на месте, а не дублируется.

CocoaPods

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

Подспек требует OKTracer >= 1.5.2 по той же причине, что и Package.swift выше: спеки всех версий до 1.5.1 включительно скачивают архив с выключенного хоста. Если Tracer уже был подключён и Podfile.lock держит 1.5.1, pod install остановится на «could not find compatible versions for pod OKTracer» — выполните pod update OKTracer, он заодно обновит закешированный spec-репозиторий вендора.

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

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