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

Why does Firebase Studio need third-party (3P) cookies enabled?

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

How do I update to the latest version of React or Next.js?

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

1. Откройте свой проект Firebase Studio и переключитесь на Просмотр Code .
2. Open the terminal ( Shift+Ctrl+C ), and run the command npx fix-react2shell-next .
3. Follow the prompts in the terminal to proceed and apply any fixes.
4. После завершения процесса опубликуйте обновленное приложение .

While opening a workspace, the message Unable to forward your request to backend. Couldn't connect to a server on port 80 appears.

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

My preview doesn't load, but I can't find any issues in code. How can I restart Firebase Studio ?

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

My workspace is not responsive, all I see is a blank screen when it loads

If your workspace is not responding, you can try restarting the VM. To do this:

1. From Firebase Studio , click the More ( more_horiz ) menu, then select Restart .

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

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

While creating a workspace, I see a message, Whoops...We need to start a new VM , and the UI hangs after that.

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

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

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

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

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

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

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

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

How do I submit a feature request or feedback on an issue I encountered?

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

I was using a particular feature in Firebase Studio but I can't find it anymore. Why was it removed?

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

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

We're actively improving the reliability of our cloud-based emulators. If a page refresh does not fix the problem, report the issue to Firebase Support .

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

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

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

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

When I share my workstation, what can my collaborator see?

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

I shared my workspace; why can't my collaborator publish or monitor my app?

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

Can I use frameworks that Firebase Studio does not have a template for to build my application?

Yes! You can customize your environment to work with just about any framework or language in Firebase Studio .

What target directory should I select when publishing a Flutter app to Firebase Hosting ?

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

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

You can temporarily publicly open the TCP port your backend server is running on to make it easier to develop your frontend and backend separately, across different workspaces:

1. Start your backend or API server either manually in a terminal, or as part of your dev.nix file 's preview configuration or onStart lifecycle hook.

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

3. 

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

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

5. Нажмите Copy URL icon to the right of the port number to copy its fully-qualified URL.

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

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

Open the command palette using Ctrl+Shift+P (or Cmd-Shift-P on MacOS), then select Firebase Studio : Show Android preview or Firebase Studio : Show web preview .

Что такое Code OSS?

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

How can I prevent my code completions and Gemini chat prompts from being used as training data?

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

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

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

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

You can view the quotas associated with your auto-generated API key on the Generative Language API Quotas and System Limits page in the Google Cloud console .

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

Объем данных (представленных в виде «токенов») в вашем проекте превышает максимальный лимит, который может принять модель. Для устранения этой ошибки измените список файлов в вашем коде, которые следует скрывать от 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 не предлагает исправить мою проблему?

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. Скопируйте сообщение об ошибке и вставьте его в чат 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 . Если агент по-прежнему не отвечает или выдает ошибку, попробуйте создать ветку с еще более ранней версии вашего приложения.

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

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

Вот несколько распространенных проблем и советов по интеграции сервисов Firebase:

• Файл конфигурации не обновился : В командной строке укажите конкретное значение, которое вы хотите обновить. Значения можно найти на странице настроек проекта в консоли Firebase. Например, вы можете отправить запрос: "Обновите measurementId в моей конфигурации на G-1234567890".
• При предварительном просмотре моего приложения аутентификация не работает : возможно, вам потребуется указать URL-адрес предварительного просмотра в качестве авторизованного домена:
  1. В режиме прототипирования нажмите кнопку open_in_new Открыть в новом окне) .
  2. В открывшемся окне предварительного просмотра скопируйте URL-адрес. Обратите внимание, что URL-адрес должен начинаться с 6000 Если он начинается с 9000 , обновите его перед переходом к следующему шагу.
  3. На странице настроек аутентификации в консоли Firebase добавьте URL-адрес, скопированный на предыдущем шаге, в раздел « Авторизованные домены» . Примечание: Этот метод включает только предварительный просмотр по умолчанию, отображаемый в режиме Prototyper . Предварительный просмотр в режиме просмотра Code и во всплывающем окне предварительного просмотра может не позволить вам пройти аутентификацию.
• Правила безопасности Firebase не созданы : Gemini может помочь вам написать правила безопасности, но пока не может автоматически добавить их в ваш проект Firebase. Вам необходимо скопировать ваши правила Firebase в консоль Firebase , чтобы опубликовать их.
• Неожиданное взаимодействие с сервером Firebase MCP : Если вы настроили сервер Firebase MCP , при использовании Prototyper для интеграции с Firebase вы можете столкнуться с неожиданным поведением. В этом случае переключитесь в режим просмотра Code и предложите Gemini интегрировать сервисы Firebase.

Как изменить значок приложения (favicon)?

Изменить значок можно непосредственно в Firebase Studio :

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

2. Если проводник еще не активирован, щелкните по нему ( Ctrl+Shift+E или Cmd+Shift+E на Mac), чтобы просмотреть все ваши файлы.

3. Разверните src , щелкните правой кнопкой мыши на каталоге app и выберите «Загрузить...».

4. Когда появится соответствующее сообщение, найдите и выберите файл favicon.ico в локальной файловой системе.

5. Когда появится запрос на замену существующего файла значка сайта (favicon), нажмите «Заменить» .

6. Чтобы увидеть изменения, повторно разверните приложение или очистите кэш браузера.