Publikowanie aplikacji za pomocą Firebase Studio

Firebase Studio oferuje kilka opcji publikowania, dzięki czemu możesz wybrać metodę, która najlepiej odpowiada potrzebom Twojego projektu. Oto przegląd dostępnych opcji:

  • Firebase App Hosting: idealne rozwiązanie do publikowania dynamicznych aplikacji Next.js i Angular. App Hosting oferuje wbudowaną obsługę platform, integrację z GitHubem oraz integrację z innymi produktami Firebase, takimi jak Firebase Authentication, Cloud Firestore i Firebase AI Logic.

    Jeśli aplikację Next.js utworzono za pomocą agenta App Prototyping agent, możesz ją opublikować bezpośrednio z Firebase Studio za pomocą kilku kliknięć.

  • Firebase Hosting: idealne rozwiązanie do hostowania aplikacji internetowych i statycznych treści internetowych (HTML, CSS, JavaScript, obrazy i inne statyczne zasoby) oraz aplikacji jednostronicowych. Firebase Hosting zapewnia szybkie dostarczanie treści za pomocą globalnej sieci CDN, bezpłatnych certyfikatów SSL i obsługi domen niestandardowych.

    Jeśli aplikację internetową statyczną lub jednostronicową utworzono w Firebase Studio, możesz ją opublikować bezpośrednio z Firebase Studio prosząc Gemini o opublikowanie aplikacji.

  • Cloud Run: Użyj Cloud Run, aby wdrożyć aplikacje w kontenerach. Jest to dobry wybór do publikowania skalowalnych i przenośnych aplikacji, które mogą działać na dowolnej platformie.

  • Inne opcje wdrożenia: wdrożenie w wybranym rozwiązaniu hostingowym, w tym na innych platformach lub na własnym serwerze.

Publikowanie aplikacji i monitorowanie jej za pomocą Firebase App Hosting

Po przetestowaniu aplikacji i upewnieniu się, że działa ona prawidłowo, możesz ją opublikować w internecie za pomocą Firebase App Hosting.

Gdy skonfigurujesz App Hosting, Firebase Studio utworzy projekt w Firebase dla Ciebie (jeśli nie został on jeszcze utworzony przez automatyczne wygenerowanie klucza Gemini API lub innych usług backendu) i przeprowadzi Cię przez proces łączenia konta Cloud Billing.

Aby opublikować aplikację:

  1. Kliknij Opublikuj , aby skonfigurować projekt w Firebase i opublikować aplikację. Pojawi się panel Opublikuj aplikację.

  2. W kroku projekt w Firebase agent App Prototyping agent wyświetli projekt w Firebase powiązany z obszarem roboczym. Jeśli projekt w Firebase jeszcze nie istnieje, App Prototyping agent utworzy nowy projekt dla Ciebie. Aby kontynuować, kliknij Dalej.

  3. W kroku Połącz Cloud Billing konto wybierz jedną z tych opcji:

    • Wybierz konto Cloud Billing, które chcesz połączyć z projektem Firebase.

    • Jeśli nie masz konta Cloud Billing lub chcesz utworzyć nowe, kliknij Utwórz konto Cloud Billing. Otworzy się konsola Google Cloud, w której możesz utworzyć nowe konto z samodzielną obsługą Cloud Billing. Po utworzeniu konta wróć do Firebase Studio i wybierz je z listy Połącz Cloud Billing.

  4. Kliknij Dalej. Firebase Studio połączy konto rozliczeniowe z projektem powiązanym z Twoim obszarem roboczym, który został utworzony podczas automatycznego generowania Gemini API klucza lub po kliknięciu Opublikuj.

    .
  5. Kliknij Skonfiguruj usługi. App Prototyping agent rozpocznie udostępnianie usług Firebase.

  6. Kliknij Opublikuj teraz. Firebase Studio konfiguruje usługi Firebase a następnie uruchamia wdrożenie App Hosting. Może to potrwać kilka minut. Więcej informacji o tym, co dzieje się za kulisami, znajdziesz w artykule Proces kompilacjiApp Hosting.

  7. Po zakończeniu publikowania pojawi się Przegląd aplikacji z adresem URL i statystykami aplikacji opartymi na funkcjach App Hosting obserwacji. Aby używać domeny niestandardowej (np. example.com lub app.example.com) zamiast domeny wygenerowanej przez Firebase, możesz dodać domenę niestandardową w konsoli Firebase.

Więcej informacji o App Hosting znajdziesz w artykule Informacje o App Hosting i jego działaniu.

(Cloud Firestore tylko) Dodawanie indeksów i weryfikowanie reguł bezpieczeństwa w środowisku produkcyjnym

Po zakończeniu publikowania i wdrożeniu aplikacji w Firebase usługi Cloud Firestore i Firebase Authentication są gotowe do testowania w środowisku produkcyjnym.

Generowanie indeksów dla bazy danych Cloud Firestore

Gdy wdrożysz aplikację w Cloud Firestore, indeksy nie są generowane automatycznie. Oznacza to, że po opublikowaniu aplikacji może być konieczne wygenerowanie indeksów dla zapytań.

Może to być widoczne w komunikatach o błędach lub w konsoli programisty przeglądarki .

Aby wygenerować indeksy po opublikowaniu:

  1. W opublikowanej aplikacji: w okienku Przegląd aplikacji (jeśli nie jest widoczne, kliknij Opublikuj ) znajdź i kliknij link Otwórz aplikację.

    Z podglądu Firebase Studio: Otwórz konsolę programisty przeglądarki i znajdź komunikat o błędzie 200 wygenerowany przez Cloud Firestore.

  2. Przetestuj wszystkie ścieżki w aplikacji. Może pojawić się błąd podobny do tego: „Error loading recipes. The query requires an index. You can create it here:" with a link to the Firebase console.

  3. Kliknij link, aby przejść do konsoli Firebase. Pojawi się zalecany indeks.

  4. Aby zaakceptować zalecany indeks, kliknij Zapisz.

  5. Wróć do aplikacji i załaduj ponownie stronę.

  6. Kontynuuj testowanie wszystkich ścieżek w aplikacji, aby dodać indeksy tam, gdzie jest to konieczne.

Więcej informacji znajdziesz w artykule Zarządzanie indeksami w Cloud Firestore.

Wyświetlanie danych Cloud Firestore i Firebase Authentication w konsoli Firebase

Po opublikowaniu aplikacji możesz wyświetlać dane na żywo w konsoli Firebase po.

  • Aby wyświetlić bazę danych Cloud Firestore na żywo, otwórz konsolę Firebase i w menu nawigacyjnym wybierz Build (Tworzenie) > Firestore Database (Baza danych Firestore).

    Możesz tu sprawdzać przechowywane dane, wyświetlać i testować reguły bezpieczeństwa oraz tworzyć indeksy. Więcej informacji znajdziesz w artykule Cloud Firestore.

  • Aby wyświetlić dane Firebase Authentication na żywo, otwórz Firebase konsolę i w menu nawigacyjnym wybierz Build > Authentication.

    Możesz tu sprawdzać konfigurację uwierzytelniania i użytkowników aplikacji. Więcej informacji znajdziesz w artykule Firebase Authentication.

Testowanie reguł Cloud Firestore w środowisku produkcyjnym

Po opublikowaniu aplikacji ponownie przetestuj reguły bezpieczeństwa Cloud Firestore w środowisku produkcyjnym. Pomoże to zapewnić, że dane są dostępne dla autoryzowanych użytkowników i chronione przed nieautoryzowanym dostępem.

Reguły możesz testować za pomocą tych metod:

  • Testowanie aplikacji: korzystaj z wdrożonej aplikacji, wykonując operacje, które wywołują różne wzorce dostępu do danych (odczytywanie, zapisywanie, usuwanie) dla różnych ról lub stanów użytkowników. Testowanie w rzeczywistych warunkach pomaga potwierdzić, że reguły są prawidłowo egzekwowane w praktyce.

  • Środowisko do testowania reguł: do przeprowadzania ukierunkowanych testów użyj Środowiska do testowania reguł w konsoli Firebase. To narzędzie umożliwia symulowanie żądań (odczytywania, zapisywania, usuwania) w bazie danych Cloud Firestore za pomocą reguł produkcyjnych. Możesz określić stan uwierzytelnienia użytkownika, ścieżkę do danych i typ operacji, aby sprawdzić, czy reguły zezwalają na dostęp lub go odmawiają zgodnie z oczekiwaniami.

  • Testy jednostkowe: aby przeprowadzić bardziej kompleksowe testy, możesz napisać testy jednostkowe dla reguł bezpieczeństwa rules. Backend podglądu Firebase Studio oparty na Firebase Local Emulator Suite umożliwia przeprowadzanie tych testów lokalnie, symulując działanie reguł produkcyjnych. Jest to niezawodny sposób na sprawdzenie złożonej logiki reguł i potwierdzenie pokrycia różnych scenariuszy. Po wdrożeniu sprawdź, czy testy jednostkowe korzystające z emulatora działają zgodnie z oczekiwaniami i obejmują wszystkie scenariusze.

Monitorowanie aplikacji za pomocą funkcji obserwacji App Hosting

Panel Przegląd aplikacji w Firebase Studio zawiera najważniejsze wskaźniki i informacje o aplikacji, dzięki czemu możesz monitorować wydajność swojej aplikacji internetowej za pomocą wbudowanych narzędzi do dostrzegalności w App Hosting. Po wdrożeniu witryny możesz otworzyć przegląd, klikając Opublikuj. W tym panelu możesz:

  • kliknąć Opublikuj , aby opublikować nową wersję aplikacji;
  • udostępnić link do aplikacji lub otworzyć ją bezpośrednio w sekcji Otwórz aplikację ;
  • sprawdzić podsumowanie skuteczności aplikacji w ciągu ostatnich 7 dni, w tym łączną liczbę żądań i stan najnowszego wdrożenia; kliknąć Wyświetl szczegóły , aby uzyskać dostęp do jeszcze większej ilości informacji w Firebase konsoli;
  • wyświetlić wykres liczby żądań otrzymanych przez aplikację w ciągu ostatnich 24 godzin, podzielonych według kodu stanu HTTP;
  • wyświetlić stan aktywacji usług Firebase, takich jak Firebase Authentication i Cloud Firestore.

Jeśli zamkniesz panel Przegląd aplikacji, możesz go ponownie otworzyć w dowolnym momencie, klikając Opublikuj.

Więcej informacji o zarządzaniu wdrożeniami App Hosting i ich monitorowaniu znajdziesz w artykule Zarządzanie wdrożeniami i wersjami.

Wycofywanie zmian w witrynieApp Hosting

Jeśli wdrożono kolejne wersje aplikacji w App Hosting, możesz wycofać ją do jednej z wcześniejszych wersji. Możesz je też usunąć.

  • Aby wycofać zmiany w opublikowanej witrynie:

    1. Otwórz App Hosting w Firebase konsoli.

    2. Znajdź backend aplikacji, kliknij Wyświetl, a potem Wdrożenia.

    3. Obok wdrożenia, do którego chcesz wycofać zmiany, kliknij Więcej , a potem wybierz Wycofaj zmiany do tej kompilacji i potwierdź.

    Więcej informacji znajdziesz w artykule Zarządzanie wdrożeniami i wersjami.

  • Aby usunąć domenę App Hosting z internetu:

    1. W Firebase konsoli, otwórz App Hosting i w sekcji aplikacji Firebase Studio kliknij Wyświetl.

    2. W sekcji Informacje o backendzie kliknij Zarządzaj. Otworzy się strona Domeny.

    3. Obok domeny kliknij Więcej , a potem wybierz Wyłącz domenę, i potwierdź.

    Spowoduje to usunięcie domeny z internetu. Aby całkowicie usunąć backend App Hosting, postępuj zgodnie z instrukcjami w artykule Usuwanie backendu.

Firebase Hosting

Statyczne i jednostronicowe aplikacje internetowe możesz publikować w Firebase Hosting z poziomu Firebase Studio obszaru roboczego.

Jeśli nie masz wymaganych uprawnień do projektu w Firebase, poproś właściciela projektu Firebase o przypisanie Ci odpowiedniej roli na stronie Użytkownicy i uprawnienia w konsoli Firebase Firebase. Jeśli masz pytania dotyczące dostępu do projektu w Firebase, w tym o znajdowanie lub przypisywanie właściciela, zapoznaj się z artykułem Uprawnienia i dostęp do projektów w Firebase.

Publikowanie z pomocą Gemini

  1. W czacie z Gemini wpisz polecenie, np. "Opublikuj moją aplikację."

  2. Gemini przeprowadzi Cię przez niezbędne kroki. Może to obejmować utworzenie projektu w Firebase i zarejestrowanie aplikacji, jeśli nie zostały one jeszcze utworzone.

Publikowanie z panelu Firebase Studio

Firebase Hosting jest zoptymalizowany pod kątem witryn statycznych i aplikacji jednostronicowych. Jeśli Twój projekt zawiera treści dynamiczne, Gemini może nie zainicjować procesu publikowania. Jeśli tak się stanie, ale nadal chcesz używać Firebase Hosting, opublikuj projekt z Firebase Studio panelu:

  1. Jeśli jeszcze tego nie zrobiłeś, utwórz projekt w Firebase i zarejestruj aplikację.

  2. Otwórz Firebase Studio obszar roboczy.

    • Jeśli używasz App Prototyping agent, kliknij Ikona przełączania kodu Przełącz na kod, aby otworzyć widok Code.
  3. W panelu nawigacyjnym kliknij ikonę Firebase Studio, aby otworzyć panel, a potem rozwiń sekcję Firebase Hosting.

  4. Kliknij Uwierzytelnij Firebase i postępuj zgodnie z instrukcjami w oknie terminala, aby uwierzytelnić konto Firebase.

  5. Kliknij Zainicjuj Firebase Hosting i postępuj zgodnie z instrukcjami w oknie terminala, aby skonfigurować wdrożenie.

  6. Aby wdrożyć aplikację, w sekcji Firebase Hosting panelu Firebase Studio kliknij Wdróż w środowisku produkcyjnym lub Wdróż na kanale.

Cloud Run

Zanim wdrożysz aplikację za pomocą Cloud Run, upewnij się, że skonfigurujesz Google Cloud projekt i włączysz Cloud Billing.

  1. Otwórz Firebase Studio obszar roboczy. Jeśli używasz App Prototyping agent, kliknij Ikona przełączania kodu Przełącz na kod, aby otworzyć widok Code.

  2. W panelu nawigacyjnym kliknij ikonę Firebase Studio, aby otworzyć panel Firebase Studio, a potem kliknij Wdróż w Cloud Run.

  3. W oknach dialogowych kliknij Zezwól temu obszarowi roboczemu na dostęp do zasobów Google Cloud za pomocą mojego konta Google , a potem wybierz projekt Google Cloud z włączonymi rozliczeniami.

  4. W sekcji Cloud Run panelu Firebase Studio kliknij Uwierzytelnij i postępuj zgodnie z instrukcjami, aby się uwierzytelnić.

  5. Kliknij Wdróż i postępuj zgodnie z instrukcjami, aby skonfigurować wdrożenie i wdrożyć aplikację.

Dalsze kroki