К основному содержанию
скилл CX Codex

firebase-crashlytics · evanca — скилл для Claude Code

Скилл учит агента настраивать Firebase Crashlytics во Flutter-проектах: ловить фатальные и нефатальные ошибки, логировать асинхронные исключения, добавлять кастомные ключи и загружать символы обфусцированных сборок.

MIT ★ 674 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add evanca/flutter-ai-rules
/plugin install flutter-ai-skills@flutter-ai-rules
Открыть на GitHub

Что делает firebase-crashlytics

Скилл объясняет, как захватывать ошибки из разных источников: фатальные через FlutterError.onError, асинхронные через PlatformDispatcher.instance.onError, isolate-ошибки через addErrorListener. Агент научится добавлять в отчёты кастомные ключи (до 64 пар, каждая до 1 kB), логи (лимит 64 kB на сессию) и пользовательские идентификаторы. Crashlytics хранит только последние восемь нефатальных исключений за сессию — остальные отбрасывает.

Для обфусцированных сборок агент знает, что iOS с Flutter 3.12.0+ и плагином 3.3.4+ загружает символы автоматически, а для Android нужна Firebase CLI версии 11.9.0 и выше и команда firebase crashlytics:symbols:upload --app=FIREBASE_APP_ID PATH/TO/symbols. Скилл показывает, как отключить сбор данных в debug-режиме через setCrashlyticsCollectionEnabled(false) и как реализовать opt-in: по умолчанию Crashlytics собирает отчёты автоматически, но можно выключить автосбор и включать вручную, когда пользователь даёт согласие — настройка сохраняется между запусками.

Для проверки настройки агент вызовет FirebaseCrashlytics.instance.crash(), пересоберёт приложение в release-режиме, перезапустит его и проверит дашборд Firebase Console через пять минут.

Какие задачи решает

  • захватывать фатальные ошибки Flutter и асинхронные исключения
  • логировать isolate-ошибки и записывать нефатальные исключения с контекстом
  • добавлять в отчёты кастомные ключи, сообщения и идентификаторы пользователей
  • загружать символы обфусцированных сборок для читаемых стектрейсов
  • настроить opt-in сбор данных и отключить Crashlytics в debug-режиме

Примеры запросов агенту

  • Настрой Firebase Crashlytics во Flutter-проекте и захватывай фатальные ошибки через FlutterError.onError
  • Добавь в отчёт Crashlytics кастомный ключ user_action со значением payment_completed
  • Загрузи символы обфусцированной Android-сборки в Crashlytics через Firebase CLI

Как установить firebase-crashlytics

1Через маркетплейс плагинов

/plugin marketplace add evanca/flutter-ai-rules
/plugin install flutter-ai-skills@flutter-ai-rules

Команда ставит плагин flutter-ai-skills целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add evanca/flutter-ai-rules --skill firebase-crashlytics -a claude-code

3Вручную: положить файлы

~/.claude/skills/firebase-crashlytics/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/firebase-crashlytics/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о firebase-crashlytics

Как установить firebase-crashlytics в Claude Code?

Выполни /plugin marketplace add evanca/flutter-ai-rules, затем /plugin install flutter-ai-skills@flutter-ai-rules. Скилл появится в ~/.claude/skills/firebase-crashlytics/SKILL.md.

Что делает скилл firebase-crashlytics?

Учит агента настраивать Firebase Crashlytics во Flutter: ловить фатальные и нефатальные ошибки, логировать асинхронные исключения, добавлять кастомные ключи и загружать символы обфусцированных сборок.

Сколько нефатальных исключений хранит Crashlytics?

Crashlytics хранит только последние восемь нефатальных исключений за сессию. Более старые отбрасываются автоматически.

Исходный текст

SKILL.md · MIT
---
name: firebase-crashlytics
description: "Use when implementing crash reporting, capturing fatal/non-fatal errors, recording isolate/async exceptions, customizing reports, or uploading obfuscated symbols."
license: MIT
---

# Firebase Crashlytics Skill

This skill defines how to correctly use Firebase Crashlytics in Flutter applications.

## When to Use

Use this skill when:

* Implementing crash reporting in a Flutter project.
* Capturing fatal errors, non-fatal exceptions, and async/isolate errors.
* Customizing crash reports with keys, logs, and user identifiers.
* Configuring opt-in data collection or disabling reporting in debug builds.
* Uploading symbol files for obfuscated builds.

---

## 1. Setup and Configuration

```
flutter pub add firebase_crashlytics
flutter pub add firebase_analytics  # enables breadcrumb logs for better crash context
```

Run `flutterfire configure` to update the Firebase configuration and add the required Crashlytics Gradle plugin for Android.

```dart
import 'package:firebase_crashlytics/firebase_crashlytics.dart';
```

**Obfuscated code:**
- For apps built with `--split-debug-info` and/or `--obfuscate`, upload symbol files for readable stack traces.
- **iOS:** Flutter 3.12.0+ and Crashlytics Flutter plugin 3.3.4+ handle symbol upload automatically.
- **Android:** Use Firebase CLI (v11.9.0+) to upload Flutter debug symbols:

```bash
firebase crashlytics:symbols:upload --app=FIREBASE_APP_ID PATH/TO/symbols
```

---

## 2. Error Handling

Configure comprehensive error capture in `main()` to catch errors from all sources:

**Fatal Flutter errors:**

```dart
void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();

  // Pass all uncaught fatal errors from the framework to Crashlytics
  FlutterError.onError = FirebaseCrashlytics.instance.recordFlutterFatalError;

  // Catch async errors not handled by the Flutter framework
  PlatformDispatcher.instance.onError = (error, stack) {
    FirebaseCrashlytics.instance.recordError(error, stack, fatal: true);
    return true;
  };

  runApp(MyApp());
}
```

**Non-fatal Flutter errors:** use `recordFlutterError` instead of `recordFlutterFatalError`.

**Isolate errors:**

```dart
Isolate.current.addErrorListener(RawReceivePort((pair) async {
  final List<dynamic> errorAndStacktrace = pair;
  await FirebaseCrashlytics.instance.recordError(
    errorAndStacktrace.first,
    errorAndStacktrace.last,
    fatal: true,
  );
}).sendPort);
```

**Caught exceptions (non-fatal):**

```dart
await FirebaseCrashlytics.instance.recordError(
  error,
  stackTrace,
  reason: 'a non-fatal error',
  information: ['further diagnostic information about the error', 'version 2.0'],
);
```

- Crashlytics only stores the **most recent 8 non-fatal exceptions** per session — older ones are discarded.

---

## 3. Crash Report Customization

**Custom keys** (max 64 key/value pairs, up to 1 kB each):

```dart
FirebaseCrashlytics.instance.setCustomKey('str_key', 'hello');
FirebaseCrashlytics.instance.setCustomKey('bool_key', true);
FirebaseCrashlytics.instance.setCustomKey('int_key', 1);
```

**Custom log messages** (limit: 64 kB per session):

```dart
FirebaseCrashlytics.instance.log("User tapped on payment button");
```

**User identifier:**

```dart
FirebaseCrashlytics.instance.setUserIdentifier("user-123");
// Clear by setting to blank string
FirebaseCrashlytics.instance.setUserIdentifier("");
```

- Avoid putting unique values (user IDs, timestamps) directly in exception messages — use custom keys instead.

---

## 4. Performance and Optimization

- Crashlytics processes exceptions on a **dedicated background thread** to minimize performance impact.
- **Fatal** reports are sent in real-time without requiring an app restart.
- **Non-fatal** reports are written to disk and sent with the next fatal report or on app restart.
- Use breadcrumb logs (requires Firebase Analytics) to understand user actions leading up to a crash.

**Disable Crashlytics in debug builds:**

```dart
if (kReleaseMode) {
  await FirebaseCrashlytics.instance.setCrashlyticsCollectionEnabled(true);
} else {
  await FirebaseCrashlytics.instance.setCrashlyticsCollectionEnabled(false);
}
```

---

## 5. Testing and Debugging

Force a test crash to verify the setup:

```dart
FirebaseCrashlytics.instance.crash();
```

**Verification workflow:**
1. Build and run the app in release mode.
2. Trigger the test crash.
3. Reopen the app so the crash report is uploaded.
4. Check the Firebase Console Crashlytics dashboard within 5 minutes.
5. Verify that custom keys, logs, and user identifiers appear on the crash report.

- Verify stack traces are properly symbolicated when using code obfuscation.

---

## 6. Opt-in Reporting

By default, Crashlytics automatically collects crash reports for all users.

To give users control over data collection:
- Disable automatic reporting and enable it only via `setCrashlyticsCollectionEnabled(true)` when users opt in.
- The override value **persists** across all subsequent app launches.
- To opt a user out, pass `false` — this applies from the next app launch.
- When disabled, crash info is **stored locally**; if later enabled, locally stored crashes are sent to Crashlytics.

---

## References

- [Firebase Crashlytics Flutter documentation](https://firebase.google.com/docs/crashlytics/get-started?platform=flutter)
- [Customize crash reports](https://firebase.google.com/docs/crashlytics/customize-crash-reports?platform=flutter)

© Ivanna Kaceviča · MIT · evanca/flutter-ai-rules

Похожие скиллы

Все скиллы по теме «Мобильная разработка» →

Сначала — firebase-crashlytics от других авторов.

firebase-crashlytics Google LLC Помогает настроить Firebase Crashlytics и SDK для отчётов о сбоях. Запускается при добавлении Crashlytics в Android, iOS или Web-приложение. CX Codex +1 142 900установок firebase-ai-logic-basics Google LLC Скилл firebase-ai-logic-basics подключает Firebase AI Logic к мобильным и веб-приложениям, позволяя вызывать модели Gemini напрямую из клиентского кода без своего бэкенда. CX Codex +1 146 900установок firebase-apk-scanner trailofbits Скилл firebase-apk-scanner разбирает Android APK, вытаскивает конфиг Firebase и проверяет базы, хранилища и функции на открытый доступ. Нужен при аудите мобильных приложений. CX Codex +1 6 000установок firebase-development 2389-research Плагин firebase-development для Claude Code ведёт работу с Firebase-проектами: настройкой, функциями, отладкой и проверкой. ★ 106звёзд репо firebase-remote-config-basics Google LLC Скилл firebase-remote-config-basics помогает управлять Remote Config в приложениях на Android и iOS через Firebase CLI. Позволяет менять флаги функций и параметры без выкатки обновлений в магазины. CX Codex +1 132 400установок firebase-basics официальный google Скилл firebase-basics настраивает Firebase CLI, помогает войти в аккаунт, создать или выбрать проект и скачать конфигурацию Android или iOS. CX Codex +1 14 100установок ios-simulator callstack Запускайте, инспектируйте и отлаживайте нативные, React Native, Expo и Flutter приложения на iOS Simulator прямо из агента. Агент может тапать, печатать, скроллить, проверять изменения кода и собирать логи ошибок. CX Codex +1 7 000установок

Из того же набора39

Весь набор →
testing Скилл testing помогает писать и проверять unit- и widget-тесты для Flutter и Dart, разбирать flaky-тесты и выбирать подходящий тип проверки. CX Codex +1 ★ 674звёзд репо firebase-ai Скилл учит агента правильно подключать Firebase AI Logic в Flutter-проекте и писать код для генерации текста и чата через Gemini. CX Codex +1 ★ 674звёзд репо flutterfire-configure Настраивает Firebase в Flutter-проектах, автоматизирует вызов flutterfire configure и помогает развести конфигурации по нескольким app flavors. CX Codex +1 ★ 674звёзд репо flutter-use-column-row-first Скилл flutter-use-column-row-first помогает собирать адаптивные Flutter-экраны на Row и Column, а фиксированные размеры оставляет для конкретных задач. Пригодится при создании и проверке интерфейсов. CX Codex +1 ★ 674звёзд репо firebase-in-app-messaging Помогает настроить Firebase In-App Messaging во Flutter: подавлять показы на критичных экранах, настраивать сбор согласий для GDPR и тестировать кампании на тестовых устройствах. CX Codex +1 ★ 674звёзд репо firebase-analytics Скилл firebase-analytics для Claude Code помогает настраивать Firebase Analytics в приложениях Flutter. Подключается при добавлении событий, свойств пользователей, воронок и отслеживания экранов. CX Codex +1 ★ 674звёзд репо patrol-e2e-testing Скилл patrol-e2e-testing пишет и запускает E2E-тесты на Patrol 4.x для Flutter: пользовательские сценарии, системные диалоги разрешений, деплинки. CX Codex +1 ★ 674звёзд репо revenuecat-testing Скилл revenuecat-testing помогает составить план тестирования встроенных покупок и подписок в RevenueCat, проверить события в песочнице и разобрать сбои. CX Codex +1 ★ 674звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой