Google is committed to advancing racial equity for Black communities. See how.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

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 firebase deploy distribuzione su Firebase (distribuzione Firebase) sia quando esegui la tua app su un server locale (server firebase serve ).

Aggiungi script per URL riservati

Poiché Firebase Hosting viene servito su HTTP / 2 quando viene distribuito, puoi migliorare le prestazioni caricando i file dalla stessa origine. Firebase Hosting offre tutte le versioni dell'SDK JavaScript Firebase da URL speciali formattati in questo modo:

/__/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 l'autenticazione e Cloud Firestore, aggiungi i seguenti script in fondo al 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/7.17.2/firebase-app.js"></script>

  <!-- Add Firebase products that you want to use -->
  <script src="/__/firebase/7.17.2/firebase-auth.js"></script>
  <script src="/__/firebase/7.17.2/firebase-firestore.js"></script>
</body>
 

Configurazione automatica dell'SDK

La configurazione automatica dell'SDK semplifica la gestione di più ambienti (come sviluppo, staging e produzione) da una singola codebase. Affidandoti all'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 su Firebase o provi la tua app in locale, questo script configura automaticamente l'SDK JavaScript di Firebase 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 (da URL di hosting riservati)

Prodotto Firebase Riferimento alla libreria (URL riservato)
Core di Firebase
(necessario)
<script src="/__/firebase/7.17.2/firebase-app.js"></script>
analitica
<script src="/__/firebase/7.17.2/firebase-analytics.js"></script>
Autenticazione
<script src="/__/firebase/7.17.2/firebase-auth.js"></script>
Cloud Firestore
<script src="/__/firebase/7.17.2/firebase-firestore.js"></script>
Cloud Functions per Firebase Client SDK
<script src="/__/firebase/7.17.2/firebase-functions.js"></script>
Messaggistica cloud
<script src="/__/firebase/7.17.2/firebase-messaging.js"></script>

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

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

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

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

Aiutanti di autenticazione

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 ogni progetto Firebase di avere un sottodominio Firebase univoco, aumentando la sicurezza di Firebase Authentication.

Inoltre, questo consente di utilizzare il proprio dominio personalizzato per authDomain possibilità di firebase.initializeApp() . Se configuri un dominio personalizzato per Firebase Hosting, puoi anche specificare quel 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 un'app Web progressiva (PWA), potresti creare un service worker che abbia un "fallback di navigazione" e che visualizzi un URL specifico per impostazione predefinita se non corrisponde a un elenco di elementi preconfezionati.

Se utilizzi la libreria sw-precache , puoi aggiungere un'impostazione della whitelist di fallback di navigazione che esclude lo spazio dei nomi riservato:

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

In generale, ricorda che lo spazio dei nomi con doppio trattino basso è riservato per l'utilizzo di Firebase e che non dovresti intercettare queste richieste nel tuo addetto all'assistenza.