Устранение неполадок Firebase Studio & Часто задаваемые вопросы

Зачем Firebase Studio нужны сторонние (3P) файлы cookie?

Для работы Firebase Studio необходимо включить сторонние файлы cookie, поскольку мы отображаем iframe с одного домена (поддомена cloudworkstations.dev ) на другом домене ( studio.firebase.google.com ), а сторонние файлы cookie обеспечивают безопасную междоменную связь.

Как обновить React или Next.js до последней версии?

Критическая уязвимость удаленного выполнения кода (RCE) затрагивает приложения, созданные с использованием Next.js и React Server Components. Для защиты вашего приложения и данных необходимо обновить его до последней стабильной версии.

1. Откройте свой проект Firebase Studio и переключитесь на Просмотр Code .
2. Откройте терминал ( Shift+Ctrl+C ) и выполните команду npx fix-react2shell-next .
3. Следуйте подсказкам в терминале, чтобы продолжить и применить исправления.
4. После завершения процесса опубликуйте обновленное приложение .

При открытии рабочего пространства появляется сообщение «Не удалось перенаправить ваш запрос на серверную часть. Не удалось подключиться к серверу на порту 80» .

Подождите примерно пять секунд и обновите страницу.

Предварительный просмотр не загружается, но я не нахожу никаких ошибок в коде. Как перезапустить Firebase Studio ?

Если Firebase Studio не обновляется должным образом (обычно это происходит из-за серьезных изменений или правок в файле dev.nix вашей среды), откройте палитру команд ( Cmd+Shift+P на Mac или Ctrl+Shift+P на ChromeOS, Windows или Linux) и выполните команду «Принудительная перезагрузка» . Если это не поможет, попробуйте выполнить команду «Перестроить среду» .

Моё рабочее пространство не реагирует на действия пользователя, при загрузке я вижу только пустой экран.

Если ваше рабочее пространство не отвечает, вы можете попробовать перезапустить виртуальную машину. Для этого:

1. В Firebase Studio щелкните меню «Дополнительно» ( more_horiz ), затем выберите «Перезапустить» .

2. При появлении запроса снова нажмите «Перезапустить» .

3. Откройте рабочее пространство заново.

При создании рабочего пространства появляется сообщение: «Ой... Нам нужно запустить новую виртуальную машину» , после чего пользовательский интерфейс зависает.

Firebase Studio поддерживает пул свободных виртуальных машин, используемых для создания рабочих пространств по запросу. Когда пул становится пустым, рабочие пространства создаются после запуска новой виртуальной машины. Этот процесс может занять некоторое время (иногда до пяти минут), но в конечном итоге завершается успешно.

[Ошибка 28] На устройстве недостаточно места

Это сообщение может появиться, если диск заполнен. Рабочая область Firebase Studio предоставляет:

• Общее дисковое пространство для пакетов Nix и /tmp составляет 100 ГиБ.
• 10 ГБ для вашей /home ).

При создании рабочего пространства я получаю сообщение об ошибке "Произошла внутренняя ошибка" .

В большинстве случаев внутренних ошибок при создании рабочей области обновление страницы примерно через минуту должно помочь устранить ошибку и получить доступ к рабочей области.

Сколько рабочих мест я могу создать?

Бесплатный тарифный план Firebase Studio ограничен тремя рабочими пространствами на пользователя. Вы можете увеличить количество создаваемых рабочих пространств до 10, присоединившись к программе Google Developer Program . Чтобы перейти на тарифный план с 30 рабочими пространствами, подпишитесь на программу Google Developer Premium Program .

Как отправить запрос на добавление новой функции или отзыв о возникшей проблеме?

Если у вас возникли проблемы при использовании Firebase Studio или у вас есть предложение по улучшению функционала, обратитесь в службу поддержки Firebase .

Я использовал определённую функцию в Firebase Studio , но больше не могу её найти. Почему её удалили?

Некоторые функции Firebase Studio являются экспериментальными. Мы ценим ваши отзывы и активно используем их для формирования текущего и планируемого набора функций, периодически удаляя те, которые не соответствуют вашим или нашим ожиданиям. Если есть функции, которые вы хотели бы видеть в идеальной для вас версии Firebase Studio , отправьте нам отзыв . Мы хотим услышать ваше мнение!

Моё рабочее пространство загружается, но эмулятор остаётся пустым.

Мы активно работаем над повышением надежности наших облачных эмуляторов. Если обновление страницы не решает проблему, сообщите о ней в службу поддержки Firebase .

В рабочих пространствах Firebase Studio используется версия Flutter, несовместимая с моим проектом.

Вы можете обновить или понизить версию почти всего предустановленного программного обеспечения внутри рабочей области так же, как и на локальном компьютере (используя apt-get или brew). Вы можете обновлять или понижать версию программного обеспечения в своей рабочей области, но установленное программное обеспечение не сохраняется между сессиями. Мы рекомендуем включить все необходимые пакеты в ваш файл dev.nix .

Мы активно работаем над улучшением системы управления версиями Flutter в Firebase Studio .

Я поделился URL-адресом своей рабочей станции с кем-то, но он не может её увидеть.

Вы можете поделиться URL-адресом рабочей области только с пользователями, имеющими к ней доступ. Пользователи без разрешения будут видеть ошибку при попытке перейти по URL-адресу. Обязательно явно предоставьте им доступ к рабочей области .

Что может увидеть мой коллега, когда я предоставляю доступ к своему рабочему месту?

Пользователи, добавленные в ваше рабочее пространство, получают полный доступ ко всей файловой системе виртуальной машины, которая может содержать конфиденциальные файлы, такие как закрытые ключи и токены доступа, хранящиеся на диске. Предоставляйте доступ к своему рабочему пространству только тем, кому вы доверяете. Хотя такой подход позволяет другим пользователям видеть точное состояние вашего рабочего пространства, это означает, что они видят все, что в нем находится.

Я предоставил доступ к своему рабочему пространству; почему мой коллега не может опубликовать или отслеживать мое приложение?

Пользователи, добавленные в ваше рабочее пространство, могут не иметь доступа к базовому проекту Firebase, который обеспечивает работу функций публикации и мониторинга «Обзор приложения». Чтобы предоставить им доступ к вашему проекту Firebase, см. раздел «Разрешения и доступ к проектам Firebase».

Могу ли я использовать фреймворки, для которых Firebase Studio нет шаблонов, для сборки своего приложения?

Да! В Firebase Studio вы можете настроить свою среду для работы практически с любым фреймворком или языком программирования.

Какую целевую директорию следует выбрать при публикации Flutter-приложения на Firebase Hosting ?

Выберите каталог build/web . В этом каталоге должен находиться файл index.html и все статические ресурсы, необходимые для отображения вашего веб-приложения после успешной сборки (с помощью команды flutter build web ).

Как мне настроить бэкенд моего приложения в рабочей области, чтобы фронтенд мог с ним взаимодействовать?

Вы можете временно открыть для публичного доступа TCP-порт, на котором работает ваш бэкэнд-сервер, чтобы упростить разработку фронтенда и бэкэнда отдельно в разных рабочих пространствах:

1. Запустите свой бэкэнд или API-сервер либо вручную в терминале, либо в рамках конфигурации предварительного просмотра в файле dev.nix или с помощью обработчика жизненного цикла onStart .

2. Чтобы открыть панель Firebase Studio , щелкните значок Firebase Studio на панели действий (по умолчанию слева).

3. 

   Разверните раздел «Порты бэкэнда» , чтобы увидеть список запущенных серверов, включая номер порта и идентификатор процесса (PID).

4. Нажмите Создайте общедоступный значок (замок) слева от номера порта.

5. Нажмите Чтобы скопировать полный URL-адрес, нажмите на значок «Копировать URL» справа от номера порта.

6. Теперь вы можете напрямую ссылаться на этот URL (например, с помощью запроса fetch ) из своего интерфейса.

Я закрыл вкладку предварительного просмотра. Как мне её снова открыть?

Откройте палитру команд с помощью Ctrl+Shift+P (или Cmd-Shift-P на macOS), затем выберите Firebase Studio : Show Android preview или Firebase Studio : Show web preview .

Что такое Code OSS?

Code-Open Source Software (Code-OSS) — это проект с открытым исходным кодом, являющийся ядром VS Code. Code-OSS доступен на GitHub под стандартной лицензией MIT, и именно там Microsoft разрабатывает продукт VS Code.

Как предотвратить использование результатов автозавершения кода и подсказок чата Gemini в качестве обучающих данных?

Использование вами Firebase Studio регулируется Условиями использования Google .

Однако обратите внимание, что использование вами функций генеративного ИИ в Firebase Studio регулируется Политикой запрета использования генеративного ИИ и Дополнительными условиями предоставления услуг API Gemini (в частности, Дополнительными условиями предоставления услуг API Gemini : неоплачиваемые услуги ).

Чтобы заблокировать использование ваших подсказок и ответов для обучения модели, не используйте App Prototyping agent и не используйте Gemini в Firebase Firebase Studio . Чтобы заблокировать использование вашего кода для обучения модели, отключите автозавершение кода и индексирование кода в настройках Firebase Studio .

Как посмотреть квоту запросов в минуту для моего автоматически сгенерированного ключа API Gemini?

Вы можете просмотреть квоты, связанные с вашим автоматически сгенерированным ключом API, на странице «Квоты и системные ограничения API для генеративных языков» в консоли Google Cloud .

Я получил сообщение об ошибке, связанное с превышением максимально допустимого количества токенов.

Объем данных (представленных в виде «токенов») в вашем проекте превышает максимальный лимит, который может принять модель. Для устранения этой ошибки измените список файлов в вашем коде, которые следует скрывать от Gemini :

1. В вашем рабочем пространстве переключитесь на Просмотр Code .

2. Создайте файл .aiexclude .

3. Чтобы уменьшить объем данных в вашем проекте, Gemini должен игнорировать файлы или каталоги, которые необходимо включить. Например, вы можете добавить папку .next/ и все ее подкаталоги. Путь должен быть относительным к каталогу, содержащему файл .aiexclude :

    .next/
   

4. Попробуйте еще раз использовать Gemini . Если вы по-прежнему получаете ошибку о превышении максимального количества токенов, попробуйте добавить другие большие файлы или каталоги в файл .aiexclude .

Мне не удалось создать проект.

При выделении ресурсов, таких как ключ API Gemini , или при развертывании на Firebase App Hosting , проект автоматически создается на основе имени вашей рабочей области Firebase Studio .

Если вы получили ошибку "Не удалось создать проект":

• Если ваша учетная запись Google входит в состав организации, возможно, у вас нет разрешения на создание проектов Google Cloud или вы достигли лимита квот на проекты. Обратитесь за помощью к администратору или см. раздел «Создание и управление проектами» .

• Если ваш аккаунт Google не входит в организацию, возможно, вы достигли лимита квоты на использование проекта Google Cloud . Запросите увеличение квоты .

  Подробнее о квотах по проектам см. в разделе «Управление квотами по проектам».

Узнайте больше о проектах Firebase и Google Cloud в разделе «Понимание проектов Firebase» .

Создание учетной записи Cloud Billing не удалось.

При выделении ресурсов, например, при развертывании приложений в Firebase App Hosting , вы можете выбрать или создать учетную запись Cloud Billing .

Если вы получили ошибку "Не удалось создать учетную запись Cloud Billing ":

• Убедитесь, что у вас есть разрешение на создание учетных записей Cloud Billing . Проверьте свои права доступа или обратитесь за помощью к администратору.

Если вы получаете ошибку "Слишком много проектов с этим платежным аккаунтом":

• Возможно, вы достигли лимита проектов для вашей учетной записи Cloud Billing . Вы можете запросить увеличение квоты . Узнайте больше о квотах в учетной записи Cloud Billing .

Подробнее о создании учетной записи Cloud Billing можно узнать в разделе «Создание новой учетной записи для самостоятельной оплаты» .

Если ни один из этих вариантов не решит вашу проблему, обратитесь в службу поддержки Cloud Billing .

Как настроить App Prototyping agent так, чтобы он автоматически добавлял Cloud Firestore и Firebase Authentication в мое приложение?

Предложите App Prototyping agent добавить базу данных или аутентификацию во время работы над существующим приложением. Когда вы запросите добавление базы данных или аутентификации, App Prototyping agent запросит подтверждение. Если вы согласитесь, App Prototyping agent создаст для вас проект Firebase с запрошенными серверными службами.

Почему App Prototyping agent не предлагает исправить мою проблему?

Агент прототипирования приложений обнаруживает ошибки Next.js и предлагает их исправить. Если вы получили ошибку, и он не предлагает её исправить, скопируйте текст ошибки и вставьте его в чат.

Для достижения наилучших результатов предоставьте, если у вас есть, более подробную информацию о характере проблемы.

Например, если вы видите ошибку Firebase типа Property access is undefined on object. for 'list' @ L6 , которая указывает на проблему с правилами Cloud Firestore , добавьте перед сообщением об ошибке: "Не могли бы вы помочь мне исправить эту проблему с правилами Cloud Firestore ?"

После публикации приложения я получил ошибку "Не удалось опубликовать приложение".

Как правило, при сбоях публикации в журналы Cloud Build записываются сообщения об ошибках, требующих принятия мер. Для отладки и устранения сбоев публикации:

1. На странице сведений о приложении (если она свернута, нажмите «Опубликовать» , чтобы отобразить ее) нажмите «Просмотреть сведения» . Это откроет App Hosting в консоли Firebase .

2. На странице App Hosting в консоли Firebase нажмите «Просмотреть журналы Cloud Build .

   Это откроет консоль Firebase , где вы сможете просмотреть журналы сборки и найти ошибку.

3. Скопируйте сообщение об ошибке и вставьте его в чат Firebase в вашем рабочем пространстве App Prototyping agent или в Gemini, попросив Gemini исправить ее.

4. Чтобы проверить исправление, переключитесь в режим просмотра кода , откройте терминал и выполните команду npm run build . Если вы увидите другую ошибку, попробуйте еще раз. Если вы видите ошибку FirebaseError , см. раздел «Почему App Prototyping agent не предлагает исправить мою проблему?» .

5. После успешной сборки нажмите npm run start , откройте предоставленную ссылку localhost и протестируйте функциональность вашего приложения. Вы можете проверить терминал на наличие ошибок во время выполнения.

6. Если все прошло успешно, Ctrl-C в Терминале, чтобы остановить сборку производственного пакета, запущенную в вашей рабочей области, а затем попробуйте снова запустить процесс публикации App Hosting .

Я не могу вносить изменения с помощью App Prototyping agent

Если App Prototyping agent не завершает запрошенные изменения кода, возвращается к шагу создания шаблона приложения или неоднократно возвращает ошибку, указывающую на возникшую проблему:

1. Перезапустите виртуальную машину .

2. Если проблема сохраняется после повторного открытия рабочего пространства, введите команду /clear в чате App Prototyping agent .

3. Если проблема сохраняется, вы можете попробовать создать ветку на основе предыдущей версии вашего приложения:

   1. Переключиться на Просмотр Code .

   2. Откройте вкладку «Управление версиями» .

   3. В графе управления версиями щелкните правой кнопкой мыши по более ранней версии > Создать ветку . Введите имя для вашей ветки.

   4. Вернитесь в Prototyper mode. If the agent still doesn't respond or returns an error, try branching from an even earlier version of your app.

   5. Чтобы переключаться между созданными вами ветками (или вернуться к основной ветке), щелкните имя ветки, расположенное в левом нижнем углу окна просмотра Code , и выберите нужную ветку.

У меня возникли проблемы с настройкой App Prototyping agent для интеграции сервисов Firebase.

Мы работаем над улучшением процесса интеграции сервисов Firebase с помощью App Prototyping agent . А пока предлагаем ознакомиться с некоторыми распространенными проблемами и советами.

• Файл конфигурации не обновился : В командной строке укажите конкретное значение, которое вы хотите обновить. Значения можно найти на странице настроек проекта в консоли Firebase. Например, вы можете отправить запрос: "Обновите measurementId в моей конфигурации на G-1234567890".
• При предварительном просмотре моего приложения аутентификация не работает : возможно, вам потребуется указать URL-адрес предварительного просмотра в качестве авторизованного домена:
  1. В режиме прототипирования нажмите кнопку open_in_new ( Открыть в новом окне) .
  2. В открывшемся окне предварительного просмотра скопируйте URL-адрес. Обратите внимание, что URL-адрес должен начинаться с 6000 Если он начинается с 9000 , обновите его перед переходом к следующему шагу.
  3. На странице настроек аутентификации в консоли Firebase добавьте URL-адрес, скопированный на предыдущем шаге, в раздел « Авторизованные домены» . Примечание: Этот метод включает только предварительный просмотр по умолчанию, отображаемый в Prototyper mode. The preview within Code view and the preview pop-out might not allow you to authenticate.
• Правила безопасности Firebase не созданы : Gemini может помочь вам написать правила безопасности, но пока не может автоматически добавить их в ваш проект Firebase. Вам необходимо скопировать ваши правила Firebase в консоль Firebase , чтобы опубликовать их.
• Неожиданное взаимодействие с сервером Firebase MCP : Если вы настроили сервер Firebase MCP , при использовании Prototyper for Firebase integrations. If this occurs, switch to Code view and prompt Gemini in Firebase to integrate Firebase services.