Firebase Hosting si riserva gli URL del tuo sito che iniziano con /__. Questo
spazio dei nomi prenotato semplifica l'utilizzo di altri prodotti Firebase insieme a
Firebase Hosting.
Questi URL riservati sono disponibili sia quando esegui il deployment su Firebase
(firebase deploy) sia quando esegui l'app su un server locale
(firebase serve).
Aggiungere script per gli URL riservati
Poiché Firebase Hosting viene pubblicato tramite HTTP/2 quando viene eseguito il deployment, puoi migliorare le prestazioni caricando i file dalla stessa origine. Firebase Hosting fornisce la versione 8 dell'SDK Firebase JavaScript da URL speciali formattati come segue:
/__/firebase/JS_SDK_VERSION/FIREBASE_SDK_NAME.js
Ti consigliamo vivamente di caricare solo le librerie che utilizzi nella tua app. Ad esempio, per includere solo Authentication 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. Se utilizzi l'URL Hosting riservato, puoi eseguire il deployment dello stesso codice in 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 Hosting. Questa configurazione di Firebase e l'inizializzazione dell'SDK vengono 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 su Firebase o testi la tua app localmente, questo script configura automaticamente l'SDK Firebase JavaScript per il progetto Firebase attivo e lo inizializza.
Se preferisci controllare l'inizializzazione autonomamente, 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 (da URL Hosting riservati)
Gli URL Hosting| Prodotto Firebase | Riferimento alla raccolta (URL riservato) |
|---|---|
| Nucleo Firebase (obbligatorio) |
<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> |
| Installazioni Firebase | <script src="/__/firebase/8.10.1/firebase-installations.js"></script> |
| Cloud Messaging | <script src="/__/firebase/8.10.1/firebase-messaging.js"></script> Per un'esperienza ottimale con Cloud Messaging, aggiungi anche l'SDK Firebase per Analytics. |
| Cloud Storage | <script src="/__/firebase/8.10.1/firebase-storage.js"></script> |
|
Performance Monitoring
(release 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
(release beta) |
<script src="/__/firebase/8.10.1/firebase-remote-config.js"></script> Per un'esperienza ottimale con Remote Config, aggiungi anche l'SDK Firebase per Analytics. |
| Firebase SDK JavaScript (intero SDK) |
<script src="/__/firebase/8.10.1/firebase.js"></script> |
Componenti di assistenza per l'autenticazione
Firebase Authentication utilizza lo spazio dei nomi riservato per fornire JavaScript e HTML speciali per completare l'autenticazione con i fornitori tramite OAuth. In questo modo, ogni progetto Firebase ha un sottodominio Firebase univoco, aumentando la sicurezza di Firebase Authentication.
Inoltre, in questo modo puoi utilizzare il tuo dominio personalizzato per l'opzione authDomain
di firebase.initializeApp(). Se
configuri un dominio personalizzato
per Firebase Hosting, puoi anche specificare questo dominio personalizzato (invece
del sottodominio web.app o firebaseapp.com) durante l'inizializzazione degli SDK
Firebase. Per maggiori dettagli sull'utilizzo di un dominio personalizzato, consulta
Best practice per l'utilizzo di signInWithRedirect.
URL riservati e service worker
Se stai creando un'applicazione web progressiva (PWA), potresti creare un service worker con un"piano di riserva per la navigazione" e che mostri un URL specifico per impostazione predefinita se non corrisponde a un elenco di elementi memorizzati nella cache.
Se utilizzi la libreria sw-precache, puoi aggiungere un'impostazione della lista consentita di riserva per la navigazione che escluda lo spazio dei nomi riservato:
{
navigateFallbackWhitelist: [/^(?!\/__).*/]
}
In generale, ricorda che lo spazio dei nomi con due trattini bassi è riservato all'utilizzo di Firebase e che non devi intercettare queste richieste nel tuo worker di servizio.