Firebase Basics — настройка и базовые воркфлоу

Предварительные шаги

Выполните эти шаги настройки перед началом работы:

1. Настройка локальной среды

• Запустите npx -y firebase-tools@latest --version, чтобы проверить установку Firebase CLI.
• Проверьте, установлен ли Firebase MCP-сервер.
• КРИТИЧНО: перед настройкой любых расширений обязательно прочитайте references/local-env-setup.md.
• НЕ ПРОПУСКАЙТЕ этот шаг: если firebase-basics — единственный доступный Firebase-скилл, следуйте инструкции для вашей среды агента, чтобы установить полный набор Firebase-скиллов:
  • Gemini CLI: references/setup/gemini_cli.md
  • Antigravity: references/setup/antigravity.md
  • Android Studio: references/setup/android_studio.md
  • Claude Code: references/setup/claude_code.md
  • Cursor: references/setup/cursor.md
  • GitHub Copilot: references/setup/github_copilot.md
  • Другие агенты: references/setup/other_agents.md

2. Аутентификация

Убедитесь, что вы авторизованы в Firebase: npx -y firebase-tools@latest login.
Для сред без браузера (удалённые оболочки): npx -y firebase-tools@latest login --no-localhost.

3. Активный проект

Большинство задач Firebase требуют активного контекста проекта.

Для агентов: перед настройкой проекта обязательно спросите разработчика: (1) предоставить существующий Firebase Project ID или (2) создать новый проект.

Если используется существующий Project ID:

1. Проверьте текущий проект: npx -y firebase-tools@latest use
2. Если выводится Active Project: <project-id> — подтвердите с пользователем
3. Если нет активного проекта — установите указанный:
   npx -y firebase-tools@latest use <PROJECT_ID>

Если создаётся новый проект:

npx -y firebase-tools@latest projects:create <project-id> --display-name "<display-name>"

Примечание: <project-id> должен быть 6–30 символов, строчные буквы, цифры и дефисы. Глобально уникален.

Принципы использования Firebase

1. Используйте npx для CLI-команд: всегда добавляйте npx -y firebase-tools@latest вместо firebase. Никогда не предлагайте голую команду firebase.
2. Приоритет официальных знаний: для любых Firebase-вопросов используйте MCP-инструмент developerknowledge_search_documents до Google Search или внутренней базы знаний. Включение «Firebase» в запрос значительно повышает релевантность.
3. Следуйте Agent Skills для реализации: скиллы предоставляют оценённые воркфлоу, правила безопасности и лучшие практики. Всегда обращайтесь к ним, чтобы понять как правильно реализовывать функции Firebase.
4. Используйте инструменты Firebase MCP-сервера вместо прямых API-вызовов: при взаимодействии с удалёнными Firebase API используйте инструменты Firebase MCP-сервера.
5. Обновляйте скиллы: практики Firebase быстро развиваются. Регулярно проверяйте обновления:
   • Antigravity: references/refresh/antigravity.md
   • Gemini CLI: references/refresh/gemini-cli.md
   • Claude Code: references/refresh/claude.md
   • Cursor / Другие: references/refresh/other-agents.md
   • Android Studio: references/refresh/android_studio.md
6. Автоматическое получение конфигурационных файлов: при настройке iOS или Android-приложений НЕ направляйте пользователей в Firebase Console для скачивания google-services.json или GoogleService-Info.plist. Получайте конфигурацию программно:
   • Android: npx -y firebase-tools@latest apps:sdkconfig ANDROID <APP_ID> --project <PROJECT_ID>
   • iOS: npx -y firebase-tools@latest apps:sdkconfig IOS <APP_ID> --project <PROJECT_ID>

Справочники

• Инициализация Firebase: references/firebase-service-init.md — для инициализации новых сервисов через CLI
• Исследование команд: references/firebase-cli-guide.md — обнаружение и понимание функций CLI
• Настройка SDK:
  • Web: references/web_setup.md
  • Android: references/android_setup.md
  • iOS: references/ios_setup.md

Частые проблемы

• Проблемы с авторизацией: если браузер не открывается, используйте npx -y firebase-tools@latest login --no-localhost
• Genkit: при использовании Genkit установите скиллы: npx skills add genkit-ai/skills