Carica gli SDK Firebase da URL riservati

Firebase Hosting riserva gli URL nel tuo sito che iniziano con /__ . Questo spazio dei nomi riservato semplifica l'utilizzo di altri prodotti Firebase insieme a Firebase Hosting.

Questi URL riservati sono disponibili sia quando esegui la distribuzione in Firebase ( firebase deploy ) sia quando esegui la tua app su un server locale ( firebase serve ).

Aggiungi script per URL riservati

Poiché Firebase Hosting viene servito su HTTP/2 durante la distribuzione, puoi migliorare le prestazioni caricando file dalla stessa origine. Firebase Hosting serve la versione 8 dell'SDK Firebase JavaScript da URL speciali formattati in questo modo:

/__/firebase/JS_SDK_VERSION/FIREBASE_SDK_NAME.js

Ti consigliamo vivamente di caricare solo le librerie che usi nella tua app. Ad esempio, per includere solo l'autenticazione e Cloud Firestore, aggiungi i seguenti script alla fine del tag <body> , ma prima di utilizzare qualsiasi servizio 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>

Configurazione automatica dell'SDK

La configurazione automatica dell'SDK semplifica la gestione di più ambienti (come sviluppo, gestione temporanea e produzione) da un'unica base di codice. Facendo affidamento sull'URL di hosting riservato, puoi distribuire lo stesso codice a più progetti Firebase.

Oltre a ospitare gli SDK stessi, lo spazio dei nomi riservato fornisce anche tutta la configurazione necessaria per inizializzare l'SDK per il progetto Firebase associato al sito di hosting. Questa configurazione di Firebase e l'inizializzazione dell'SDK sono fornite da uno script che puoi includere direttamente:

<!-- Load the Firebase SDKs before loading this file -->
<script src="/__/firebase/init.js"></script>

Quando esegui il deployment in Firebase o test la tua app in locale, questo script configura automaticamente l'SDK Firebase JavaScript per il progetto Firebase attivo e inizializza l'SDK.

Se preferisci controllare tu stesso l'inizializzazione, i valori di configurazione di Firebase sono disponibili anche in formato JSON:

fetch('/__/firebase/init.json').then(async response => {
  firebase.initializeApp(await response.json());
});

SDK Firebase JS disponibili (dagli URL di hosting riservati)

Prodotto base fuoco Riferimento biblioteca (URL riservato)
Nucleo Firebase
(necessario)
<script src="/__/firebase/8.10.1/firebase-app.js"></script>
Analitica
<script src="/__/firebase/8.10.1/firebase-analytics.js"></script>
Controllo dell'app
<script src="/__/firebase/8.10.1/firebase-app-check.js"></script>
Autenticazione
<script src="/__/firebase/8.10.1/firebase-auth.js"></script>
CloudFirestore
<script src="/__/firebase/8.10.1/firebase-firestore.js"></script>
Funzioni cloud per Firebase Client SDK
<script src="/__/firebase/8.10.1/firebase-functions.js"></script>
Installazioni Firebase
<script src="/__/firebase/8.10.1/firebase-installations.js"></script>
Messaggi sulla nuvola
<script src="/__/firebase/8.10.1/firebase-messaging.js"></script>

Per un'esperienza ottimale con Cloud Messaging, aggiungi anche Firebase SDK for Analytics.

Archiviazione cloud
<script src="/__/firebase/8.10.1/firebase-storage.js"></script>
Monitoraggio delle prestazioni
(versione beta )
<script src="/__/firebase/8.10.1/firebase-performance.js"></script>
Database in tempo reale
<script src="/__/firebase/8.10.1/firebase-database.js"></script>
Configurazione remota
(versione beta )
<script src="/__/firebase/8.10.1/firebase-remote-config.js"></script>

Per un'esperienza ottimale con Remote Config, aggiungi anche Firebase SDK for Analytics.

SDK Firebase JavaScript
(intero SDK)
<script src="/__/firebase/8.10.1/firebase.js"></script>

Auth helper

Firebase Authentication utilizza lo spazio dei nomi riservato per fornire JavaScript e HTML speciali per completare l'autenticazione con i provider tramite OAuth. Ciò consente a ciascun progetto Firebase di avere un sottodominio Firebase univoco, aumentando la sicurezza dell'autenticazione Firebase.

Inoltre, questo ti consente di utilizzare il tuo dominio personalizzato per l'opzione authDomain di firebase.initializeApp() . Se configuri un dominio personalizzato per Firebase Hosting, puoi anche specificare tale dominio personalizzato (invece del tuo sottodominio web.app o firebaseapp.com ) durante l'inizializzazione degli SDK Firebase.

URL riservati e service worker

Se stai creando una Progressive Web App (PWA), potresti creare un service worker che ha un "fallback di navigazione" e visualizza un URL specifico per impostazione predefinita se non corrisponde a un elenco di elementi prememorizzati nella cache.

Se stai utilizzando la libreria sw-precache , puoi aggiungere un'impostazione whitelist di fallback di navigazione che escluda lo spazio dei nomi riservato:

{
  navigateFallbackWhitelist: [/^(?!\/__).*/]
}

In generale, ricorda solo che lo spazio dei nomi con doppio trattino basso è riservato all'utilizzo di Firebase e che non devi intercettare queste richieste nel tuo service worker.