firebase-crashlytics
Firebase Crashlytics — официальный навык Firebase для первичной настройки Crashlytics в клиентском приложении Android или iOS и дальнейшего использования crash-reporting SDK. Его назначение — провести разработчика через необходимую структуру работ: сначала подготовить Firebase project и Firebase app, затем выбрать платформенную инструкцию SDK и после подключения использовать дополнительные данные, которые делают отчёты об ошибках полезнее. Источник подчёркивает, что для provisioning нужны и проект Firebase, и приложение Android или iOS; одного общего аккаунта или названия продукта недостаточно. Перед настройкой нужно проверить, что выбран правильный Firebase project и зарегистрировано приложение нужной платформы. Навык не описывает создание произвольного проекта вместо пользователя и не превращает отсутствие Firebase app в успешный setup. Для чтения собранных Crashlytics-данных источник предлагает установить MCP server в Firebase CLI и ссылается на firebase-basics для базовой подготовки CLI и окружения. Это разделяет две задачи: SDK собирает данные на клиенте, а MCP server предоставляет способ читать накопленные данные. Наличие MCP-подключения само по себе не создаёт crash reports и не доказывает, что приложение уже отправило событие. SDK Setup выбирается по платформе. Для Android источник направляет в references/android_setup.md, а для iOS — в references/ios_setup.md. Поэтому карточка не должна смешивать Android- и Apple-команды или выдавать платформенно-зависимые детали без выбора приложения. Последовательность остаётся проверяемой: определить Android или iOS, открыть соответствующую инструкцию, подключить SDK к существующему Firebase app и затем проверить результат в целевом проекте. Сам skill выступает навигацией по workflow и официальным ссылкам, а не заменой полного исходника платформенной интеграции. После подключения Crashlytics SDK источник перечисляет четыре группы полезных возможностей. Custom keys добавляют к отчёту структурированные значения, которые помогают связать сбой с состоянием приложения. Custom logs сохраняют дополнительную последовательность событий перед ошибкой. User identifiers позволяют связать отчёт с конкретным идентификатором пользователя в пределах выбранной модели приложения. Non-fatal exceptions дают возможность отправлять исключения, которые не остановили приложение, но важны для диагностики. Эти возможности должны использоваться осознанно: источник перечисляет их как средства сделать отчёт actionable, но не утверждает, что любая ключевая запись или идентификатор автоматически объяснит причину сбоя. Для Android в skill приведена ссылка на официальную документацию Firebase Customize Crash Reports for Android, а для iOS — на Customize Crash Reports for Apple Platforms. В них следует сверять платформенный способ добавления keys, logs, user identifiers и non-fatal reports. Такая ссылка важнее универсальной инструкции из карточки, потому что API и место вызова зависят от SDK и языка приложения. Если разработчик не выбрал платформу, корректный следующий шаг — уточнить её или открыть обе официальные ветки как отдельные варианты, а не предположить Android по умолчанию. Практический результат workflow — Firebase app, подключённый к Crashlytics SDK, и понятный путь к чтению и обогащению crash reports. Ограничения также подтверждены источником: provisioning требует уже выбранного Firebase project и app, чтение данных вынесено в Firebase CLI MCP server, а подробная установка SDK находится в отдельных Android/iOS reference-файлах. Навык не обещает исправить сам crash, определить первопричину без отчёта, настроить все сервисы Firebase или заменить проверку конфигурации в реальном приложении. Перед выводом о готовности нужно отдельно убедиться, что нужная платформа, Firebase app, SDK и канал чтения действительно работают.
Для чего подходит
- Подключение Crashlytics к Android и iOS
- Настройка crash reporting
- Добавление custom keys и non-fatal reports
Установка
Сначала прочитайте SKILL.md и scripts в исходном репозитории. Затем выполните команду в каталоге проекта:
npx skills add https://github.com/firebase/agent-skills/tree/main/skills/firebase-crashlytics