Интеграция Crashlytics для отслеживания крашей мобильного приложения
Firebase Crashlytics — стандарт de facto для сбора краш-репортов на iOS и Android. Главное преимущество перед конкурентами: автоматическая символизация стектрейсов без ручной загрузки dSYM на iOS и mapping-файлов на Android. Когда Xcode Cloud или Fastlane отдают билд в Firebase App Distribution или TestFlight, Crashlytics сам подтягивает символы через Run Script в Build Phases.
Подключение на iOS
Через Swift Package Manager добавляем firebase-ios-sdk, затем в AppDelegate:
import FirebaseCrashlytics
import FirebaseCore
@main
struct MyApp: App {
init() {
FirebaseApp.configure()
}
}
Это всё, что нужно для базового краш-репортинга — SDK перехватывает необработанные исключения и сигналы (SIGABRT, EXC_BAD_ACCESS) автоматически.
Критичный момент — dSYM upload. В Xcode убедитесь, что Build Settings → DEBUG_INFORMATION_FORMAT = DWARF with dSYM File для Release. Без этого в дашборде будут адреса памяти вместо имён функций. Для CI добавляем в Fastfile:
upload_symbols_to_crashlytics(
dsym_path: "./build/MyApp.app.dSYM.zip",
gsp_path: "./GoogleService-Info.plist"
)
Подключение на Android
// build.gradle (app)
implementation("com.google.firebase:firebase-crashlytics:18.+")
implementation("com.google.firebase:firebase-crashlytics-ndk:18.+") // для C++ крашей
Плагин com.google.firebase.crashlytics в build.gradle автоматически загружает R8/ProGuard mapping-файл после каждой release-сборки. Без плагина — mapping загружать вручную через Firebase CLI.
Кастомные ключи и логи для диагностики
Голый стектрейс часто не объясняет, почему упало. Crashlytics позволяет прикреплять контекст:
// iOS
Crashlytics.crashlytics().setCustomValue(userId, forKey: "user_id")
Crashlytics.crashlytics().setCustomValue("checkout", forKey: "last_screen")
Crashlytics.crashlytics().log("CartViewModel: начало оплаты")
// Android
Firebase.crashlytics.setCustomKey("user_id", userId)
Firebase.crashlytics.setCustomKey("last_screen", "checkout")
Firebase.crashlytics.log("CartViewModel: начало оплаты")
Эти данные появляются во вкладке Keys и Logs каждого краш-репорта. На практике это сокращает время диагностики: сразу видно, что упало у анонимного пользователя на экране оплаты, а не просто в URLSession.dataTask.
Non-fatal ошибки
Не все проблемы — краши. Сетевая ошибка, неудачный парсинг JSON, timeout — всё это стоит логировать без завершения сессии:
Crashlytics.crashlytics().record(error: NetworkError.timeout)
В дашборде non-fatal ошибки попадают в отдельный раздел Non-fatals. Удобно для мониторинга деградации API без роста crash-free rate.
Crash-free rate и алерты
Firebase Console показывает crash-free users — процент сессий без краша. Норма для production — выше 99,5%. Настраиваем email-алерт при падении ниже порога через Firebase Alerts, либо подключаем webhook в PagerDuty через Firebase Extensions.
Что входит в работу
- Добавление зависимостей (CocoaPods / SPM / Gradle)
- Настройка dSYM upload для iOS через Fastlane или скрипт в Xcode
- Настройка ProGuard/R8 mapping upload для Android
- Добавление кастомных ключей для User ID, сессии, навигационного пути
- Логирование non-fatal ошибок в ключевых точках приложения
- Настройка алертов в Firebase Console
Сроки
Базовая интеграция с dSYM/mapping upload: 0,5–1 день. Добавление кастомных ключей и non-fatal в кодовой базе — ещё 0,5–1 день в зависимости от размера проекта. Стоимость рассчитывается индивидуально.