Firebase Hosting rezerwuje w Twojej witrynie adresy URL zaczynające się od /__. Ten
zarezerwowana przestrzeń nazw ułatwia korzystanie z innych usług Firebase razem z
Firebase Hosting
Te zarezerwowane adresy URL będą dostępne zarówno po wdrożeniu aplikacji w Firebase,
(firebase deploy) lub po uruchomieniu aplikacji na serwerze lokalnym
(firebase serve).
Dodawanie skryptów do zarezerwowanych adresów URL
Ponieważ po wdrożeniu interfejs Firebase Hosting jest wyświetlany przez HTTP/2, możesz zwiększyć wydajność przez wczytywanie plików z tego samego źródła. Firebase Hosting udostępnia wersję 8 poziomu pakietu SDK Firebase JavaScript z adresów URL o takim formacie:
/__/firebase/JS_SDK_VERSION/FIREBASE_SDK_NAME.js
Zdecydowanie zalecamy wczytywanie tylko tych bibliotek,
których używasz w aplikacji. Aby na przykład uwzględnić tylko Authentication i
Cloud Firestore, dodaj następujące skrypty na dole strony <body>
, ale zanim skorzystasz z usług Firebase:
<body>
<!-- Insert these scripts at the bottom of the HTML, but before you use any Firebase services -->
<!-- Firebase App (the core Firebase SDK) is always required and must be listed first -->
<script src="/__/firebase/8.10.1/firebase-app.js"></script>
<!-- Add Firebase products that you want to use -->
<script src="/__/firebase/8.10.1/firebase-auth.js"></script>
<script src="/__/firebase/8.10.1/firebase-firestore.js"></script>
</body>
Automatyczna konfiguracja pakietu SDK
Automatyczna konfiguracja pakietu SDK ułatwia zarządzanie wieloma środowiskami (np. jako programistyczne, przejściowe i produkcyjne) z poziomu jednej bazy kodu. Korzystając z zarezerwowanego adresu URL Hosting, możesz wdrażać ten sam kod w kilku projektach Firebase.
Zarezerwowana przestrzeń nazw zawiera nie tylko pakiety SDK, ale też całą konfigurację potrzebną do zainicjowania pakietu SDK dla projektu Firebase powiązanego z witryną Hosting. Ta konfiguracja Firebase Inicjowanie pakietu SDK jest dostarczane za pomocą skryptu, który można bezpośrednio uwzględnić:
<!-- Load the Firebase SDKs before loading this file -->
<script src="/__/firebase/init.js"></script>
Podczas wdrażania na Firebase lub testowania aplikacji lokalnie ten skrypt automatycznie konfiguruje pakiet SDK Firebase JavaScript dla aktywnego projektu Firebase i inicjalizuje go.
Jeśli wolisz samodzielnie kontrolować inicjowanie, wartości konfiguracji Firebase są też dostępne w formacie JSON:
fetch('/__/firebase/init.json').then(async response => {
firebase.initializeApp(await response.json());
});
Dostępne pakiety SDK Firebase JS (z zarezerwowanych adresów URL Hosting)
| Usługa Firebase | Odwołania do biblioteki (zarezerwowany URL) |
|---|---|
| Podstawowe Firebase (wymagane) |
<script src="/__/firebase/8.10.1/firebase-app.js"></script> |
| Analytics | <script src="/__/firebase/8.10.1/firebase-analytics.js"></script> |
| App Check | <script src="/__/firebase/8.10.1/firebase-app-check.js"></script> |
| Authentication | <script src="/__/firebase/8.10.1/firebase-auth.js"></script> |
| Cloud Firestore | <script src="/__/firebase/8.10.1/firebase-firestore.js"></script> |
| Cloud Functions for Firebase Client SDK | <script src="/__/firebase/8.10.1/firebase-functions.js"></script> |
| Instalacje: Firebase | <script src="/__/firebase/8.10.1/firebase-installations.js"></script> |
| Cloud Messaging | <script src="/__/firebase/8.10.1/firebase-messaging.js"></script> Aby zapewnić sobie optymalne korzystanie z Cloud Messaging, dodaj też pakiet SDK Firebase dla Analytics. |
| Cloud Storage | <script src="/__/firebase/8.10.1/firebase-storage.js"></script> |
|
Performance Monitoring
(wersja beta) |
<script src="/__/firebase/8.10.1/firebase-performance.js"></script> |
| Realtime Database | <script src="/__/firebase/8.10.1/firebase-database.js"></script> |
| Remote Config
(wersja beta) |
<script src="/__/firebase/8.10.1/firebase-remote-config.js"></script> Aby zapewnić optymalne działanie usługi Remote Config, dodaj również pakiet SDK Firebase dla Analytics. |
| Firebase JavaScript SDK (cały pakiet SDK) |
<script src="/__/firebase/8.10.1/firebase.js"></script> |
Pomoc dotycząca uwierzytelniania
Firebase Authentication używa zarezerwowanej przestrzeni nazw, aby udostępniać specjalny kod JavaScript i HTML do uwierzytelniania u dostawców za pomocą OAuth. Dzięki temu każdy projekt Firebase może mieć unikalny identyfikator Subdomena Firebase, która zwiększa bezpieczeństwo Firebase Authentication.
Dzięki temu możesz też używać własnej domeny w authDomain
opcji firebase.initializeApp(). Jeśli
skonfigurować domenę niestandardową
dla Firebase Hosting, możesz też określić tę domenę niestandardową (zamiast
z subdomeny web.app lub firebaseapp.com) podczas inicjowania Firebase.
Pakiety SDK. Zobacz
Sprawdzone metody korzystania z logowania signInWithRedirect
, aby dowiedzieć się więcej o korzystaniu z domeny niestandardowej.
Zarezerwowane adresy URL i usługi w tle
Jeśli tworzysz progresywną aplikację internetową (PWA), możesz utworzyć skrypt service worker, który ma „awaryjny sposób nawigacji” i domyślnie renderuje określony adres URL, jeśli nie pasuje do listy elementów z pamięci podręcznej.
Jeśli używasz biblioteki sw-precache, możesz dodać ustawienie listy dozwolonych adresów domyślnych nawigacji, które wyklucza zarezerwowaną przestrzeń nazw:
{
navigateFallbackWhitelist: [/^(?!\/__).*/]
}
Ogólnie pamiętaj, że przestrzeń nazw podwójnego podkreślenia jest zarezerwowana dla korzystania z Firebase i że nie należy przechwytywać tych żądań w swojej usłudze. .