Informazioni sui progetti Firebase

Questa pagina offre brevi panoramiche di diversi concetti importanti relativi ai progetti Firebase. Se disponibili, segui i link per trovare informazioni più dettagliate su funzionalità, servizi, strumenti e best practice.

Relazione tra progetti, app e prodotti Firebase

Un progetto Firebase è l'entità di primo livello per Firebase. In un progetto, puoi registrare le tue app per Apple, Android o web. Dopo aver registrato le tue app con Firebase, puoi aggiungere gli SDK Firebase per un numero qualsiasi di prodotti Firebase, come Analytics, Cloud Firestore, Performance Monitoring o Remote Config.

Scopri di più su questa procedura nella guida introduttiva per la tua piattaforma:
iOS+ | Android | web | Unity | C++ | Flutter.

Informazioni sulla gerarchia dei progetti Firebase

Diagramma che mostra la gerarchia di base di un progetto Firebase, tra cui il progetto, le app registrate e le risorse e i servizi di cui è stato eseguito il provisioning Questo diagramma mostra la gerarchia di base di un progetto Firebase. Ecco le relazioni principali:

  • Un progetto Firebase è come un container per tutte le tue app e per tutte le risorse e i servizi di cui è stato eseguito il provisioning per il progetto.

  • In un progetto Firebase possono essere registrate una o più app Firebase (ad esempio, le versioni iOS e Android di un'app o le versioni senza costi e a pagamento di un'app).

  • Tutte le app Firebase registrate nello stesso progetto Firebase condividono e hanno accesso a tutte le stesse risorse e agli stessi servizi di cui è stato eseguito il provisioning per il progetto. Ecco alcuni esempi:

    • Tutte le app Firebase registrate nello stesso progetto Firebase condividono gli stessi backend, come Firebase Hosting, Authentication, Realtime Database, Cloud Firestore, Cloud Storage e Cloud Functions.

    • Tutte le app Firebase registrate nello stesso progetto Firebase sono associate alla stessa proprietà Google Analytics, in cui ogni app Firebase è uno stream di dati separato.

Relazione tra progetti Firebase e Google Cloud

Quando crei un nuovo progetto Firebase, stai in effetti creando un progetto Google Cloud dietro le quinte. Puoi anche creare prima un progetto Google Cloud e poi aggiungere Firebase al progetto in un secondo momento. Puoi pensare a un progetto Google Cloud come a un container virtuale per dati, codice, configurazione e servizi.

Tieni presente che, per tutti i progetti Firebase, Firebase aggiunge automaticamente al tuo progetto un'etichetta firebase:enabled nella pagina IAM e amministrazione > Etichette della console Google Cloud. Scopri di più su questa etichetta nelle nostre domande frequenti.

Poiché un progetto Firebase è un progetto Google Cloud:

  • Puoi accedere al progetto e interagire con questo nella console Firebase, nella console Google Cloud e nella console API di Google.

  • Puoi interagire con il progetto utilizzando l'interfaccia a riga di comando Firebase, la gcloud CLI e qualsiasi risorsa Terraform di Google.

  • Nel progetto puoi utilizzare prodotti e API sia di Firebase che di Google Cloud.

  • I ruoli e le autorizzazioni IAM per il progetto sono condivisi tra Firebase e Google Cloud. Qualsiasi accesso di un membro del progetto (ovvero un'entità) al tuo progetto Google Cloud si applicherà anche al tuo progetto Firebase (e viceversa).

  • La fatturazione per il progetto è condivisa tra Firebase e Google Cloud. Se la fatturazione è abilitata per il tuo progetto Google Cloud, il tuo progetto Firebase sarà nel piano tariffario Blaze con pagamento a consumo di Firebase.

  • Gli identificatori univoci del progetto (come il numero di progetto e l'ID progetto) sono condivisi tra Firebase e Google Cloud.

  • Qualsiasi gerarchia delle risorse applicata al tuo progetto Google Cloud (ad esempio organizzazione, cartelle ecc.) verrà applicata anche al tuo progetto Firebase.

  • L'eliminazione del progetto comporta l'eliminazione in Firebase e Google Cloud.

  • L'eliminazione o la modifica di una risorsa o di dati all'interno del progetto si applica sia a Firebase che a Google Cloud.

Configurazione di un progetto Firebase e registrazione delle app

Puoi configurare un progetto Firebase e registrare le app nella consoleFirebase (o, per casi d'uso avanzati, utilizzando l'API REST Firebase Management o l'interfaccia a riga di comandoFirebase). Quando configuri un progetto e registri le app, devi prendere alcune decisioni organizzative e aggiungere informazioni di configurazione specifiche di Firebase ai tuoi progetti locali.

Per le app di produzione, devi configurare un workflow di sviluppo chiaro, che in genere prevede l'utilizzo di più ambienti. Consulta la nostra documentazione sui workflow degli sviluppatori, tra cui le best practice generali e le linee guida generali sulla sicurezza per configurare i progetti Firebase e registrare le app per creare il tuo workflow di sviluppo.

Interazione con un progetto Firebase

Oltre agli SDK dei prodotti, puoi interagire direttamente con un progetto Firebase utilizzando diversi strumenti e interfacce.

Console Firebase

La console Firebase offre l'ambiente più completo per la gestione di prodotti, app e impostazioni a livello di progetto Firebase.

Il riquadro a sinistra della console elenca i prodotti Firebase, organizzati per categorie di primo livello. Nella parte superiore del riquadro a sinistra, fai clic su Impostazioni per accedere alle impostazioni di un progetto, che includono integrazioni, autorizzazioni di accesso e fatturazione.

Al centro della console sono visualizzati i pulsanti che avviano i workflow di configurazione per registrare vari tipi di app. Dopo aver iniziato a utilizzare Firebase, l'area principale della console diventa una dashboard che mostra le statistiche sui prodotti che utilizzi.

Tieni presente che, poiché un progetto Firebase è anche un progetto Google Cloud, potresti scoprire che varie attività o prodotti richiedono l'utilizzo della console Google Cloud anziché della console Firebase.

Interfaccia a riga di comando Firebase (uno strumento a riga di comando)

Firebase offre anche l'interfaccia a riga di comando Firebase per configurare e gestire prodotti Firebase specifici, come Firebase Hosting, Cloud Functions for Firebase e Firebase Extensions.

Dopo aver installato l'interfaccia a riga di comando Firebase, hai accesso al comando firebase globale. Utilizza l'interfaccia a riga di comando Firebase per collegare la directory dell'app locale a un progetto Firebase, quindi esegui il deployment di nuove versioni dei contenuti ospitati su Firebase o degli aggiornamenti delle funzioni.

API REST Firebase Management

Utilizzando l'API REST Firebase Management, puoi gestire in modo programmatico un progetto Firebase. Ad esempio, puoi registrare un'app con un progetto o elencare le app già registrate in modo programmatico (iOS+ | Android | web).

Identificatori dei progetti Firebase

Un progetto Firebase può essere identificato nel backend Firebase e in varie interfacce per sviluppatori utilizzando identificatori diversi, tra cui il nome del progetto, il numero del progetto e l'ID progetto.

Il nome del progetto

Quando crei un progetto, fornisci un nome del progetto. Questo identificatore è il nome solo interno di un progetto nella consoleFirebase, nella consoleGoogle Cloud e nell'interfaccia a riga di comandoFirebase. Il nome del progetto non viene esposto in nessun prodotto, servizio o risorsa Firebase o Google Cloud visibile pubblicamente, ma serve semplicemente per aiutarti a distinguere più facilmente i vari progetti.

Puoi modificare il nome di un progetto in qualsiasi momento nel riquadro superiore di Impostazioni > scheda Generali della console Firebase.

Il numero del progetto

Un progetto Firebase (e il relativo progetto Google Cloud associato) ha un numero di progetto. Si tratta dell'identificatore canonico globalmente univoco assegnato da Google al progetto. Utilizza questo identificatore quando configuri le integrazioni e/o effettui chiamate API a Firebase, Google o servizi di terze parti.

Non puoi modificare un numero di progetto. Se elimini un progetto, viene eliminato anche il relativo numero, che non potrà più essere utilizzato da nessun altro progetto.

L'ID progetto

Un progetto Firebase (e il relativo progetto Google Cloud associato) ha un ID progetto. Si tratta di un identificatore univoco definito dall'utente per il progetto in tutto Firebase e Google Cloud. Quando crei un progetto Firebase, Firebase assegna automaticamente un ID univoco al progetto, ma puoi modificarlo durante la configurazione del progetto. Questo identificatore deve essere generalmente trattato come un alias di convenienza per fare riferimento al progetto.

File e oggetti di configurazione di Firebase

Quando registri un'app con un progetto Firebase, la console Firebase fornisce un file di configurazione Firebase (app Apple/Android) o un oggetto di configurazione (app web) che aggiungi direttamente alla directory dell'app locale.

  • Per le app Apple, aggiungi un file di configurazione GoogleService-Info.plist.
  • Per le app per Android, aggiungi un file di configurazione google-services.json.
  • Per le app web, aggiungi un oggetto di configurazione Firebase.

In qualsiasi momento, puoi ottenere un file o un oggetto di configurazione Firebase di un'app.

Un file o un oggetto di configurazione di Firebase associa un'app a un progetto Firebase specifico e alle relative risorse (database, bucket di archiviazione e così via). La configurazione include le "opzioni Firebase", ovvero i parametri richiesti dai servizi Firebase e Google per comunicare con le API del server Firebase e per associare i dati client al progetto Firebase e all'app Firebase.

Ecco le "opzioni Firebase" minime richieste:

  • Chiave API Firebase: una stringa univoca utilizzata per indirizzare le richieste al tuo progetto Firebase. Questa chiave API deve essere limitata all'utilizzo solo con le API correlate a Firebase. (valore di esempio: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO)

  • ID progetto Firebase: un identificatore univoco globale definito dall'utente per il progetto in tutto Firebase e Google Cloud. Questo identificatore può essere visualizzato negli URL o nei nomi di alcune risorse Firebase, ma in genere dovrebbe essere trattato come un alias di convenienza per fare riferimento al progetto. (valore di esempio: myapp-project-123)

  • ID applicazione Firebase ("ID app"): l'identificatore univoco globale dell'app Firebase in tutto Firebase e Google Cloud con un formato specifico per la piattaforma:

    • App Firebase per Apple: GOOGLE_APP_ID (valore di esempio: 1:1234567890:ios:321abc456def7890)
      Questo non è un ID pacchetto Apple.
    • App Firebase per Android: mobilesdk_app_id (valore di esempio: 1:1234567890:android:321abc456def7890)
      Non si tratta di un nome di pacchetto Android o di un ID applicazione Android.
    • App web Firebase: appId (valore di esempio: 1:65211879909:web:3ae38ef1cdcb2e01fe5f0c)

I contenuti del file o dell'oggetto di configurazione Firebase sono considerati pubblici, inclusi l'ID specifico della piattaforma dell'app (ID pacchetto Apple o nome del pacchetto Android) e i valori specifici del progetto Firebase, come la chiave API, l'ID progetto, l'URL Realtime Database e il nome del bucket Cloud Storage. Per questo motivo, utilizza Firebase Security Rules per proteggere i tuoi dati e file in Realtime Database, Cloud Firestore e Cloud Storage.

Per i progetti open source, in genere sconsigliamo di includere il file o l'oggetto di configurazione Firebase dell'app nel controllo del codice sorgente perché, nella maggior parte dei casi, gli utenti devono creare i propri progetti Firebase e indirizzare le proprie app alle proprie risorse Firebase (tramite il proprio file o oggetto di configurazione Firebase).

Limiti generali per progetti, app e siti Firebase

Ecco alcuni limiti generali per progetti, app e siti Firebase:

  • Numero di progetti per Account Google (indirizzo email)

    • Piano tariffario Spark: la quota di creazione dei progetti è limitata a un numero ridotto di progetti (di solito circa 5-10).
    • Piano tariffario Blaze: la quota di creazione dei progetti è ancora limitata, ma potrebbe aumentare con il collegamento di un account Cloud Billing in regola.

    Tieni presente quanto segue in merito al limite della quota di creazione dei progetti:

    • Questo limite non è specifico di Firebase. I limiti di Firebase per la quota di progetti sono gli stessi di Google Cloud.
    • Nel raro caso in cui sia necessario, puoi richiedere un aumento della quota del progetto.
    • L'eliminazione completa di un progetto richiede 30 giorni e viene conteggiata ai fini della quota di progetti fino a quando il progetto non viene eliminato completamente.

    Scopri le best practice generali per la configurazione dei progetti Firebase consigliate da Firebase.

  • Numero di app per progetto

    Firebase limita il numero totale di app Firebase all'interno di un progetto Firebase a 30.

    Devi assicurarti che tutte le app Firebase all'interno di un singolo progetto Firebase siano varianti di piattaforma della stessa applicazione dal punto di vista dell'utente finale. Scopri di più sulla multi-tenancy nei nostri documenti sulle best practice.

    Scopri di più sul limite di app per progetto nelle domande frequenti.

  • Numero di siti Hosting per progetto

    La funzionalità multisito di Firebase Hosting supporta un massimo di 36 siti per progetto.

Lancio dell'app