Collega la tua app all'emulatore Cloud Storage for Firebase

Prima di connettere la tua app all'emulatore Cloud Storage for Firebase, assicurati di comprendere il flusso di lavoro complessivo di Firebase Local Emulator Suite e di installare e configurare Local Emulator Suite e rivedere i relativi comandi dell'interfaccia a riga di comando.

Scegli un progetto Firebase

Firebase Local Emulator Suite emula i prodotti per un singolo progetto Firebase.

Per selezionare il progetto da utilizzare, prima di avviare gli emulatori, esegui firebase use nell'interfaccia a riga di comando nella directory di lavoro. In alternativa, puoi passare il flag --project a ogni comando dell'emulatore.

Local Emulator Suite supporta l'emulazione di progetti Firebase reali e progetti demo.

Ti consigliamo di utilizzare i progetti demo, se possibile. I vantaggi includono:

• Configurazione più semplice, poiché puoi eseguire gli emulatori senza creare un progetto Firebase
• Maggiore sicurezza, poiché se il codice richiama accidentalmente risorse non emulate (di produzione), non c'è alcuna possibilità di modifica dei dati, utilizzo e fatturazione
• Migliore supporto offline, poiché non è necessario accedere a internet per scaricare la configurazione dell'SDK.

Strumenta la tua app per comunicare con gli emulatori

SDK per Android, piattaforme Apple e web

Configura le classi di configurazione o di test in-app per interagire con l'emulatore Cloud Storage for Firebase come segue.

// 10.0.2.2 is the special IP address to connect to the 'localhost' of
// the host computer from an Android emulator.
val storage = Firebase.storage
storage.useEmulator("10.0.2.2", 9199)
EmulatorSuite.kt

// 10.0.2.2 is the special IP address to connect to the 'localhost' of
// the host computer from an Android emulator.
FirebaseStorage storage = FirebaseStorage.getInstance();
storage.useEmulator("10.0.2.2", 9199);
EmulatorSuite.java

Storage.storage().useEmulator(withHost: "127.0.0.1", port: 9199)
ViewController.swift

FirebaseStorage storage = FirebaseStorage.DefaultInstance;
// Connects to the Storage Emulator running on port 9199
storage.UseEmulator("127.0.0.1", 9199);

const { getStorage, connectStorageEmulator } = require("firebase/storage");

const storage = getStorage();
if (location.hostname === "localhost") {
  // Point to the Storage emulator running on localhost.
  connectStorageEmulator(storage, "127.0.0.1", 9199);
} 
emulator-suite.js

var storage = firebase.storage();
if (location.hostname === "localhost") {
  // Point to the Storage emulator running on localhost.
  storage.useEmulator("127.0.0.1", 9199);
} 
emulator-suite.js

Non è necessaria alcuna configurazione aggiuntiva per testare le funzioni Cloud Functions attivate dagli eventi Cloud Storage for Firebase utilizzando l'emulatore. Quando gli emulatori Cloud Storage for Firebase e Cloud Functions sono entrambi in esecuzione, funzionano automaticamente insieme.

Admin SDK s

I Firebase Admin SDK si connettono automaticamente all'emulatore Cloud Storage for Firebase quando viene impostata la variabile di ambiente FIREBASE_STORAGE_EMULATOR_HOST:

export FIREBASE_STORAGE_EMULATOR_HOST="127.0.0.1:9199"

Tieni presente che l'emulatore Cloud Functions riconosce automaticamente l'emulatore Cloud Storage for Firebase, quindi puoi saltare questo passaggio quando testi le integrazioni tra gli emulatori Cloud Functions e Cloud Storage for Firebase. La variabile di ambiente verrà impostata automaticamente per l'SDK Admin in Cloud Storage for Firebase.

Se vuoi che il tuo codice Admin SDK si connetta a un emulatore condiviso in esecuzione in un altro ambiente, devi specificare lo stesso ID progetto che hai impostato utilizzando l'interfaccia a riga di comando di Firebase. Puoi passare un ID progetto direttamente a initializeApp o impostare la variabile di ambiente GCLOUD_PROJECT.

admin.initializeApp({ projectId: "your-project-id" });

export GCLOUD_PROJECT="your-project-id"

Importazione ed esportazione di dati

Gli emulatori del database e di Cloud Storage for Firebase ti consentono di esportare i dati da un'istanza dell'emulatore in esecuzione. Definisci un set di dati di riferimento da utilizzare nei test delle unità o nei workflow di integrazione continua, quindi esportalo per condividerlo con il team.

firebase emulators:export ./dir

Nei test, all'avvio dell'emulatore, importa i dati di riferimento.

firebase emulators:start --import=./dir

Puoi indicare all'emulatore di esportare i dati all'arresto, specificando un percorso di esportazione o semplicemente utilizzando il percorso passato al flag --import.

firebase emulators:start --import=./dir --export-on-exit

Queste opzioni di importazione ed esportazione dei dati funzionano anche con il comando firebase emulators:exec. Per saperne di più, consulta il riferimento dei comandi dell'emulatore.

Differenze tra l'emulatore Cloud Storage for Firebase e la produzione

Per i test delle app client, l'emulatore Cloud Storage for Firebase si allinea quasi perfettamente alla produzione per quanto riguarda l'area di superficie dell'API Firebase. Tutti i comandi Firebase dovrebbero funzionare tra gli SDK Firebase standard (piattaforme web, Android e Apple).

Per i test delle app lato server, esistono delle limitazioni. Gli SDK Firebase Admin utilizzano la superficie dell'API Google Cloud e non tutti gli endpoint di questa API sono emulati. Come regola generale, tutto ciò che può essere eseguito dagli SDK client (caricamento o eliminazione di file, recupero e impostazione dei metadati) viene implementato anche per l'utilizzo dagli SDK Admin, ma non oltre. Le esclusioni principali sono elencate di seguito.

Differenze rispetto a Google Cloud Storage

Il prodotto Cloud Storage for Firebase, incluso l'emulatore Storage, fornisce un sottoinsieme di funzionalità di Google Cloud Storage (GCS) incentrate sugli oggetti di archiviazione, molto utile per lo sviluppo di app Firebase. Cloud Storage for Firebase differisce da GCS per i seguenti aspetti:

• Al momento, Cloud Storage for Firebase non supporta le API Bucket per la creazione, l'elenco, il recupero o l'eliminazione dei bucket di archiviazione.
• Dall'API Google Cloud Storage Objects, sono supportati i seguenti metodi: copy, delete, get, insert, list, patch, rewrite, update.

Cloud IAM

Firebase Emulator Suite non tenta di replicare o rispettare alcun comportamento relativo a IAM per l'esecuzione. Gli emulatori rispettano le regole di sicurezza di Firebase fornite, ma in situazioni in cui normalmente verrebbe utilizzato IAM, ad esempio per impostare il service account di chiamata di Cloud Functions e quindi le autorizzazioni, l'emulatore non è configurabile e utilizzerà l'account disponibile a livello globale sulla tua macchina di sviluppo, in modo simile all'esecuzione diretta di uno script locale.

Notifiche Pub/Sub

L'emulatore Cloud Storage for Firebase non si integra con l'emulatore Cloud Pub/Sub e pertanto non supporta la creazione di canali/notifiche per le modifiche agli oggetti di archiviazione. Ti consigliamo di utilizzare direttamente i trigger di Cloud Functions Storage.

Metadati a livello di bucket

L'emulatore Cloud Storage for Firebase non supporta alcuna configurazione a livello di bucket, tra cui classe di archiviazione, configurazione CORS a livello di bucket, etichette o policy di conservazione. Firebase intende migliorare questo supporto nel tempo.

Cosa devo fare adesso?

• Per una raccolta di video selezionati ed esempi dettagliati di istruzioni, segui la playlist di formazione sugli emulatori Firebase.
• Poiché le funzioni attivate sono una tipica integrazione con Cloud Storage for Firebase, scopri di più sull'emulatore Cloud Functions for Firebase in Esegui le funzioni in locale.