Отметим: когда приложение вылетает на iOS или Android, а у тебя нет краш-репортинга — ты тратишь часы на воспроизведение. Типичный сценарий: пользователь жалуется, что приложение закрывается на экране оплаты, но локально ты не можешь повторить. Firebase Crashlytics даёт полный стектрейс с символами без ручной возни с dSYM или mapping-файлами. Как указано в официальной документации, Crashlytics автоматически перехватывает необработанные исключения и сигналы (SIGABRT, EXC_BAD_ACCESS) и even C++ крашей через NDK. Мы используем Crashlytics на production проектах и гарантируем crash-free rate выше 99,5%. Символизация происходит автоматически: названия методов и номера строк подставляются без загрузки символов вручную. Для iOS достаточно настроить dSYM upload через Build Phases или Fastlane; для Android — подключить плагин Gradle, который сам загружает mapping-файлы после каждой релизной сборки.
Crashlytics быстрее загружает символы — в 3 раза быстрее Sentry по данным наших тестов. Таблица ниже показывает ключевые отличия:
| Параметр | Crashlytics | Sentry |
|---|---|---|
| Автоматическая символизация | Да | Требует CLI |
| dSYM upload | Run Script в Xcode, Fastlane | Ручная загрузка |
| Non-fatal logging | record(error:) | CaptureException |
| Crash-free rate | Встроенный | Дополнительная настройка |
| Цена | Бесплатно (в Firebase Spark) | Платный (стартовый тариф) |
Как мы подключаем Crashlytics?
Подключение на 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 мы используем Fastlane для upload.
Подключение на 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.
Как настроить алерты при падении crash-free rate?
В Firebase Console перейдите в раздел Alerts и создайте правило для Crashlytics. Выберите метрику "crash-free users" и порог, например 99.5%. При достижении порога система отправляет email или вызывает webhook. Для серьёзных проектов подключаем Firebase Extensions к PagerDuty или Slack — уведомления приходят мгновенно.
Этапы интеграции
| Этап | Описание | Срок |
|---|---|---|
| 1. Добавление зависимостей | SPM/Gradle/CocoaPods | 0,5 дня |
| 2. dSYM/mapping upload | Fastlane скрипт или Xcode Run Script | 0,5 дня |
| 3. Кастомные ключи | User ID, навигация, бизнес-логика | 0,5 дня |
| 4. Non-fatal logging | 10+ точек в приложении | 0,5 дня |
| 5. Алерты | Email/PagerDuty | 0,5 дня |
Что входит в работу
- Добавление зависимостей через SPM, CocoaPods или Gradle
- Настройка dSYM upload для iOS через Fastlane или Xcode Build Phases
- Настройка ProGuard/R8 mapping upload для Android
- Добавление кастомных ключей для User ID, сессии, навигационного пути
- Логирование non-fatal ошибок в ключевых точках
- Настройка алертов в Firebase Console
Сроки
Базовая интеграция с dSYM/mapping upload: 0,5–1 день. Добавление кастомных ключей и non-fatal в кодовой базе — ещё 0,5–1 день в зависимости от размера проекта. Свяжитесь с нами — мы оценим ваш проект и предложим интеграцию под ключ. Опыт нашей команды: более 50 проектов с Crashlytics, поддержка crash-free rate выше 99,5% на всех production сборках. Получите консультацию по интеграции Crashlytics в ваше приложение.