Rozwiązywanie problemów z Firebase Studio i najczęstsze pytania

Dlaczego Firebase Studio wymaga włączenia plików cookie innych firm?

Firebase Studio wymaga włączonych plików cookie firm zewnętrznych, ponieważ renderujemy element iframe z jednej domeny (subdomeny cloudworkstations.dev) w innej domenie (studio.firebase.google.com), a pliki cookie firm zewnętrznych umożliwiają bezpieczną komunikację między źródłami.

Jak zaktualizować React lub Next.js do najnowszej wersji?

Krytyczna luka w zabezpieczeniach umożliwiająca zdalne wykonanie kodu (RCE) wpływa na aplikacje utworzone za pomocą Next.js i komponentów serwera React. Aby chronić aplikację i dane, musisz zaktualizować ją do najnowszej stabilnej wersji.

1. Otwórz projekt Firebase Studio i przełącz się na widok Code.
2. Otwórz terminal (Shift+Ctrl+C) i uruchom polecenie npx fix-react2shell-next.
3. Postępuj zgodnie z instrukcjami wyświetlanymi w terminalu, aby kontynuować i zastosować poprawki.
4. Po zakończeniu procesu opublikuj zaktualizowaną aplikację.

Podczas otwierania obszaru roboczego wyświetla się komunikat Nie udało się przekazać prośby do backendu. Nie udało się połączyć z serwerem na porcie 80.

Odczekaj około 5 sekund i odśwież stronę.

Podgląd się nie wczytuje, ale nie widzę żadnych problemów w kodzie. Jak ponownie uruchomić Firebase Studio?

Jeśli Firebase Studio nie odświeża się prawidłowo (zwykle w wyniku poważnych zmian w kodzie lub zmian w pliku środowiska dev.nix), otwórz paletę poleceń (Cmd+Shift+P na komputerze Mac lub Ctrl+Shift+P w ChromeOS, Windows lub Linux) i uruchom polecenie Hard Restart (Twardy restart). Jeśli to nie pomoże, spróbuj uruchomić polecenie Rebuild Environment (Ponowne tworzenie środowiska).

Mój obszar roboczy nie odpowiada, po wczytaniu widzę tylko pusty ekran

Jeśli obszar roboczy nie odpowiada, możesz spróbować ponownie uruchomić maszynę wirtualną. Aby to zrobić:

1. W Firebase Studio kliknij menu Więcej (more_horiz), a następnie wybierz Uruchom ponownie.

2. Gdy pojawi się odpowiedni komunikat, ponownie kliknij Uruchom ponownie.

3. Otwórz ponownie obszar roboczy.

Podczas tworzenia obszaru roboczego widzę komunikat Ups… Musimy uruchomić nową maszynę wirtualną, a interfejs zawiesza się.

Firebase Studio utrzymuje pulę maszyn wirtualnych w stanie gotowości, które służą do udostępniania obszarów roboczych na żądanie. Gdy pula się wyczerpie, obszary robocze są udostępniane po uruchomieniu nowej maszyny wirtualnej. Ten proces może potrwać (czasami nawet 5 minut), ale ostatecznie się powiedzie.

[Errno 28] No space left on device

Ten komunikat może się pojawić, jeśli dysk jest pełny. Firebase StudioObszar roboczy zapewnia:

• 100 GiB łącznego miejsca na dysku na pakiety Nix i /tmp
• 10 GiB na /homekatalog

Podczas tworzenia obszaru roboczego pojawia się komunikat wystąpił błąd wewnętrzny.

W większości przypadków błędów wewnętrznych podczas udostępniania przestrzeni roboczej odświeżenie strony po minucie powinno rozwiązać problem i umożliwić dostęp do przestrzeni roboczej.

Ile obszarów roboczych mogę utworzyć?

Firebase Studio Bezpłatny plan jest ograniczony do 3 przestrzeni roboczych na użytkownika. Możesz zwiększyć liczbę przestrzeni roboczych, które możesz utworzyć, do 10, dołączając do Google Developer Program. Aby przejść na 30 przestrzeni roboczych, subskrybuj Google Developer Premium Program.

Jak przesłać prośbę o dodanie funkcji lub opinię o naprawieniu problemu?

Jeśli podczas korzystania z Firebase Studio napotkasz problem lub masz prośbę o dodanie funkcji, skontaktuj się z zespołem pomocy Firebase.

Korzystałem(-am) z określonej funkcji w Firebase Studio, ale nie mogę jej już znaleźć. Dlaczego został usunięty?

Niektóre funkcje w Firebase Studio są eksperymentalne. Okresowo usuwamy funkcje, które nie spełniają Twoich ani naszych oczekiwań.

Mój obszar roboczy się wczytuje, ale emulator jest pusty.

Aktywnie pracujemy nad zwiększeniem niezawodności naszych emulatorów w chmurze. Jeśli odświeżenie strony nie rozwiąże problemu, zgłoś go do zespołu pomocy Firebase.

Firebase Studio workspaces ma wersję Fluttera, która jest niezgodna z moim projektem.

W przestrzeni roboczej możesz uaktualnić lub przywrócić starszą wersję niemal każdego preinstalowanego oprogramowania, tak jak na komputerze lokalnym (za pomocą poleceń apt-get lub brew). Możesz uaktualnić lub przywrócić starszą wersję oprogramowania w przestrzeni roboczej, ale zainstalowane oprogramowanie nie jest trwałe w różnych sesjach. Zalecamy uwzględnienie wszystkich wymaganych pakietów w pliku dev.nix.

Udostępniłem(-am) adres URL stacji roboczej innej osobie, ale nie może go ona zobaczyć.

Adres URL obszaru roboczego możesz udostępniać tylko użytkownikom, którzy mają do niego dostęp. Użytkownicy bez uprawnień zobaczą błąd podczas próby otwarcia adresu URL. Pamiętaj, aby udostępnić im obszar roboczy.

Co widzi współpracownik, gdy udostępniam mu stację roboczą?

Użytkownicy dodani do obszaru roboczego mają pełny dostęp do całego systemu plików maszyny wirtualnej, który może zawierać poufne pliki, takie jak klucze prywatne i tokeny dostępu przechowywane na dysku. Udostępniaj obszar roboczy tylko zaufanym osobom. Chociaż to podejście pomaga innym użytkownikom zobaczyć dokładny stan obszaru roboczego, oznacza to, że widzą oni wszystko, co się w nim znajduje.

Udostępniłem(-am) obszar roboczy. Dlaczego współpracownik nie może opublikować ani monitorować mojej aplikacji?

Użytkownicy dodani do Twojej przestrzeni roboczej mogą nie mieć uprawnień do powiązanego projektu Firebase, który obsługuje funkcje publikowania i monitorowania w sekcji „Przegląd aplikacji”. Aby przyznać im uprawnienia do projektu w Firebase, zapoznaj się z artykułem Uprawnienia i dostęp do projektów w Firebase.

Czy mogę używać platform, dla których Firebase Studio nie ma szablonu, do tworzenia aplikacji?

Tak. Możesz dostosować środowisko, aby pracować z niemal dowolną platformą lub językiem w Firebase Studio.

Jaki katalog docelowy należy wybrać podczas publikowania aplikacji Flutter w Firebase Hosting?

Wybierz katalog build/web. Ten katalog powinien zawierać plik index.html i wszystkie statyczne zasoby potrzebne do renderowania aplikacji internetowej po jej prawidłowym utworzeniu (za pomocą polecenia flutter build web).

Jak skonfigurować backend aplikacji w przestrzeni roboczej, aby frontend mógł się z nim komunikować?

Możesz tymczasowo otworzyć publicznie port TCP, na którym działa serwer backendu, aby ułatwić oddzielne tworzenie frontendu i backendu w różnych obszarach roboczych:

1. Uruchom backend lub serwer interfejsu API ręcznie w terminalu albo w ramach konfiguracji podglądu pliku dev.nix lub onStart wywołania zwrotnego cyklu życia.

2. Na pasku aktywności (domyślnie po lewej stronie) kliknij ikonę Firebase Studio, aby otworzyć panel Firebase Studio.

3. 

   Rozwiń sekcję Porty backendu, aby wyświetlić listę działających serwerów, w tym numer portu i identyfikator procesu (PID).

4. Kliknij ikonę Udostępnij (kłódka) po lewej stronie numeru portu.

5. Kliknij ikonę Kopiuj URL po prawej stronie numeru portu, aby skopiować jego w pełni kwalifikowany adres URL.

6. Możesz teraz bezpośrednio odwoływać się do tego adresu URL (np. za pomocą wywołania fetch) z interfejsu.

Karta podglądu została zamknięta. Jak mogę go przywrócić?

Otwórz paletę poleceń, naciskając Ctrl+Shift+P (lub Cmd-Shift-P w systemie macOS), a następnie wybierz Firebase Studio: Pokaż podgląd na Androidzie lub Firebase Studio: Pokaż podgląd w przeglądarce.

Co to jest Code OSS?

Code-Open Source Software (Code-OSS) to projekt open source, który jest podstawową warstwą VS Code. Kod OSS jest dostępny na GitHubie na podstawie standardowej licencji MIT i to w tym miejscu Microsoft rozwija produkt VS Code.

Jak mogę zapobiec wykorzystywaniu moich uzupełnień kodu i Gemini promptów na czacie jako danych treningowych?

Korzystanie z usługi Firebase Studio podlega Warunkom korzystania z usługi Google.

Pamiętaj jednak, że korzystanie z funkcji generatywnej AI w usłudze Firebase Studio podlega zasadom dotyczącym niedozwolonych zastosowań generatywnej AI oraz Gemini API Dodatkowym warunkom korzystania z usługi (w szczególności Gemini API Dodatkowym warunkom korzystania z usługi: bezpłatne usługi).

Aby zablokować używanie promptów i odpowiedzi do trenowania modelu, nie używaj App Prototyping agent ani pomocy Gemini w Firebase Studio. Aby zablokować wykorzystywanie kodu do trenowania modelu, wyłącz uzupełnianie kodu i indeksowanie kodu w Firebase Studioustawieniach.

Jak wyświetlić limit żądań na minutę dla automatycznie wygenerowanego klucza interfejsu Gemini API?

Limity przydziału powiązane z automatycznie wygenerowanym kluczem interfejsu API możesz wyświetlić na stronie Limity przydziału i limity systemu interfejsu API języka generatywnego w Google Cloudkonsoli.

Jak mogę zmienić klucz Gemini API?

Aby przeprowadzić rotację klucza interfejsu Gemini API używanego w projekcie Firebase Studio, wygeneruj nowy klucz w Google AI Studio i zaktualizuj go w Firebase Studio.

1. Generowanie nowego klucza interfejsu API

   1. Otwórz Google AI Studiostronę kluczy interfejsów API.
   2. Kliknij Utwórz klucz interfejsu API.
   3. Nadaj kluczowi interfejsu API nazwę i wybierz odpowiedni Google Cloud projekt. Jeśli projektu nie ma na liście, może być konieczne jego zaimportowanie.
   4. Kliknij Utwórz klucz.
   5. Skopiuj nowo wygenerowany klucz interfejsu API.

2. Zaktualizuj klucz interfejsu API w Firebase Studio projekcie

   1. Otwórz Firebase Studio obszar roboczy.
   2. Przełącz na widok Code.
   3. Otwórz plik .env (znajdujący się w lokalizacji /home/user/studio/.env).
   4. Zastąp starą wartość GEMINI_API_KEY nowym kluczem, który został skopiowany.

3. Ponowne wdrożenie lub ponowne uruchomienie (w razie potrzeby)

   Aby zmiany zaczęły obowiązywać, może być konieczne ponowne opublikowanie aplikacji lub ponowne uruchomienie serwera programistycznego.

4. Unieważnij stary klucz interfejsu API

   • W przypadku kluczy wygenerowanych automatycznie przez Firebase Studio:
     1. Otwórz stronę Google AI Studio.
     2. Zaimportuj Firebaseprojekt z Firebase Studioobszaru roboczegoGoogle AI Studio.
     3. Znajdź automatycznie wygenerowany klucz interfejsu API w tym projekcie i usuń go.
   • W przypadku kluczy wygenerowanych w Google AI Studio lub w konsoli Google Cloud:
     1. Otwórz Google AI Studiostronę kluczy interfejsów API lub Google Cloudstronę Dane logowania w konsoli.
     2. Znajdź stary klucz API, który został zastąpiony, i usuń go.

Pojawił się błąd informujący o przekroczeniu maksymalnej dozwolonej liczby tokenów

Ilość danych (reprezentowanych jako „tokeny”) w projekcie jest większa niż maksymalny limit, jaki może zaakceptować model. Aby rozwiązać ten problem, dostosuj, które pliki w bazie kodu mają być ukryte przed Gemini:

1. W obszarze roboczym przejdź do widoku Code.

2. Utwórz plik .aiexclude.

3. Uwzględnij pliki lub katalogi, które Gemini powinna ignorować, aby zmniejszyć ilość danych w projekcie. Możesz na przykład dodać .next/ i wszystkie podkatalogi. Ścieżka powinna być podana w odniesieniu do katalogu zawierającego plik .aiexclude:

    .next/
   

4. Spróbuj ponownie użyć Gemini. Jeśli nadal pojawia się błąd związany z przekroczeniem maksymalnej liczby tokenów, spróbuj dodać inne duże pliki lub katalogi do pliku .aiexclude.

Nie udało mi się utworzyć projektu

Podczas udostępniania zasobów, takich jak Gemini API klucz lub wdrażanie w Firebase App Hosting, automatycznie udostępniany jest projekt na podstawie nazwy Twojego obszaru roboczego Firebase Studio.

Jeśli pojawi się błąd „Nie udało się utworzyć projektu”:

• Jeśli Twoje konto Google należy do organizacji, możesz nie mieć uprawnień do tworzenia Google Cloudprojektów lub możesz mieć już wykorzystany limit projektów. Skontaktuj się z administratorem, aby uzyskać pomoc, lub zapoznaj się z artykułem Tworzenie projektów i zarządzanie nimi.

• Jeśli Twoje konto Google nie należy do organizacji, być może osiągnięto limitGoogle Cloud projektów. Poproś o zwiększenie limitu.

  Więcej informacji o limitach w projektach znajdziesz w artykule Zarządzanie limitami w projektach.

Więcej informacji o Firebase i Google Cloud projektach znajdziesz w artykule Projekty Firebase.

Nie udało się utworzyć konta Cloud Billing

Podczas udostępniania zasobów, np. wdrażania w Firebase App Hosting, możesz wybrać lub utworzyć konto Cloud Billing.

Jeśli pojawi się błąd „Nie udało się utworzyć konta Cloud Billing”:

• Sprawdź, czy masz uprawnienia do tworzenia Cloud Billing kont. Sprawdź swoje uprawnienia lub skontaktuj się z administratorem.

Jeśli pojawi się błąd „Z tym kontem rozliczeniowym jest powiązanych zbyt wiele projektów”:

• Mogłeś(-aś) osiągnąć limit projektów na koncie Cloud Billing. Możesz poprosić o zwiększenie limitu. Więcej informacji o Cloud Billing limitach kont

Więcej informacji o tworzeniu konta Cloud Billing znajdziesz w artykule Tworzenie nowego konta rozliczeniowego z samoobsługą.

Jeśli żadne z tych rozwiązań nie pomoże, skontaktuj się z Cloud Billingzespołem pomocy.

Jak sprawić, aby App Prototyping agent automatycznie dodawał Cloud Firestore i Firebase Authentication do mojej aplikacji?

Poproś App Prototyping agent o dodanie bazy danych lub uwierzytelniania podczas pracy nad istniejącą aplikacją. Gdy poprosisz o dodanie bazy danych lub uwierzytelniania, App Prototyping agent poprosi o potwierdzenie. Jeśli się zgodzisz, App Prototyping agent skonfiguruje dla Ciebie projekt w Firebase z wymaganymi usługami backendu.

Dlaczego App Prototyping agent nie oferuje rozwiązania mojego problemu?

App Prototyping agent wykrywa błędy Next.js i proponuje ich naprawienie. Jeśli pojawi się błąd, a nie będzie możliwości jego naprawienia, skopiuj tekst problemu i wklej go na czacie.

Aby uzyskać najlepsze wyniki, podaj więcej informacji o charakterze problemu, jeśli je masz.

Jeśli na przykład widzisz błąd Firebase, taki jak Property access is undefined on object. for 'list' @ L6, który wskazuje na problem z regułami Cloud Firestore, zacznij od pytania: „Czy możesz mi pomóc rozwiązać ten problem z regułami Cloud Firestore?”.

Po opublikowaniu aplikacji pojawił się błąd „Nie udało się opublikować aplikacji”

W przypadku nieudanych publikacji w dziennikach Cloud Build zwykle rejestrowane są błędy, które można naprawić. Aby debugować i rozwiązywać problemy z publikowaniem:

1. Na stronie Szczegóły aplikacji (jeśli jest zminimalizowana, kliknij Opublikuj, aby ją wyświetlić) kliknij Wyświetl szczegóły. Spowoduje to otwarcie App Hosting w Firebase konsoli.

2. Na stronie Firebase konsoliApp Hosting kliknij Wyświetl Cloud Build logi.

   Otworzy się konsola Firebase, w której możesz wyświetlić dzienniki kompilacji i zlokalizować błąd.

3. Skopiuj błąd i wklej go na czacie App Prototyping agent lub Gemini w obszarze roboczym, a potem poproś Gemini o jego naprawienie.

4. Aby sprawdzić, czy problem został rozwiązany, przełącz się na widok Kod, otwórz terminal i uruchom polecenie npm run build. Jeśli zobaczysz kolejny błąd, spróbuj ponownie. Jeśli zobaczysz znak FirebaseError, zapoznaj się z artykułem Dlaczego funkcja App Prototyping agent nie proponuje rozwiązania mojego problemu?

5. Gdy kompilacja się powiedzie, kliknij npm run start i otwórz podany link localhost, a następnie przetestuj funkcje aplikacji. W terminalu możesz sprawdzić, czy nie ma błędów czasu działania.

6. Jeśli wszystko przebiegnie pomyślnie, wpisz Ctrl-C w Terminalu, aby zatrzymać działającą w obszarze roboczym wersję produkcyjną, a następnie ponownie spróbuj App Hosting opublikować.

Nie mogę wprowadzać zmian za pomocą App Prototyping agent

Jeśli App Prototyping agent nie wprowadzi żądanych zmian w kodzie, wróci do kroku Plan aplikacji lub wielokrotnie zwróci błąd z informacją, że napotkał problem:

1. Uruchom ponownie maszynę wirtualną.

2. Jeśli problem nadal występuje po ponownym otwarciu przestrzeni roboczej, wpisz /clear na czacie App Prototyping agent.

3. Jeśli problem nadal występuje, możesz spróbować utworzyć gałąź z poprzedniej wersji aplikacji:

   1. Przełącz na widok Code.

   2. Otwórz kartę Kontrola źródła.

   3. Na wykresie kontroli źródła kliknij prawym przyciskiem myszy wcześniejszą wersję > Utwórz gałąź. Wpisz nazwę gałęzi.

   4. Wróć do trybu Prototyper. Jeśli agent nadal nie odpowiada lub zwraca błąd, spróbuj rozwidlić jeszcze wcześniejszą wersję aplikacji.

   5. Aby przełączać się między utworzonymi gałęziami (lub wrócić do gałęzi głównej), kliknij nazwę gałęzi w lewym dolnym rogu widoku Code i wybierz gałąź, której chcesz użyć.

Mam problem z poproszeniem App Prototyping agent o zintegrowanie usług Firebase.

Oto kilka typowych problemów i wskazówek dotyczących integracji usług Firebase:

• Plik konfiguracyjny nie został zaktualizowany: w prompcie podaj konkretną wartość, którą chcesz zaktualizować. Wartości znajdziesz na stronie Ustawienia projektu w konsoli Firebase. Możesz na przykład wpisać: „Zaktualizuj identyfikator pomiaru w mojej konfiguracji, wpisując G-1234567890”.
• Uwierzytelnianie nie działa podczas wyświetlania podglądu aplikacji: może być konieczne dodanie adresu URL podglądu jako autoryzowanej domeny:
  1. W trybie Prototyper kliknij open_in_new Otwórz w nowym oknie.
  2. W nowym oknie podglądu, które się otworzy, skopiuj adres URL. Pamiętaj, że powinien on zaczynać się od 6000. Jeśli zaczyna się od 9000, zaktualizuj go, zanim przejdziesz do następnego kroku.
  3. Na stronie Ustawienia uwierzytelniania w konsoli Firebase dodaj adres URL skopiowany w poprzednim kroku do autoryzowanych domen. Uwaga: ta metoda włącza tylko podgląd domyślny wyświetlany w trybiePrototyper. Podgląd w Codewidoku i wyskakujące okienko podglądu mogą nie umożliwiać uwierzytelniania.
• Nie utworzono reguł zabezpieczeń Firebase: Gemini może pomóc w pisaniu reguł zabezpieczeń, ale nie może jeszcze automatycznie dodawać ich do projektu Firebase. Aby opublikować reguły Firebase, musisz skopiować je do konsoli Firebase.
• Nieoczekiwana interakcja z serwerem MCP Firebase: jeśli skonfigurujesz serwer MCP Firebase, podczas korzystania z Prototyper w przypadku integracji z Firebase możesz napotkać nieoczekiwane zachowanie. W takim przypadku przełącz się na widok Code i poproś Gemini o zintegrowanie usług Firebase.

Jak zmienić favikonę aplikacji?

Ikonę możesz zmienić w Firebase Studio:

1. Przełącz na widok Code.

2. Jeśli nie jest jeszcze aktywny, kliknij Eksplorator (Ctrl+Shift+E lubCmd+Shift+E na komputerze Mac), aby wyświetlić wszystkie pliki.

3. Rozwiń src, kliknij prawym przyciskiem myszy katalog app i wybierz Prześlij...

4. Gdy pojawi się odpowiedni komunikat, przejdź do pliku favicon.ico w lokalnym systemie plików i wybierz go.

5. Gdy pojawi się prośba o zastąpienie istniejącego pliku ikony, kliknij Zastąp.

6. Aby zobaczyć zmianę, ponownie wdróż aplikację lub wyczyść pamięć podręczną przeglądarki.