Questa pagina offre brevi panoramiche di diversi concetti importanti sui progetti Firebase. Se disponibili, segui i collegamenti 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 Apple, Android o Web. Dopo aver registrato le tue app con Firebase, puoi aggiungere gli SDK Firebase per qualsiasi numero di prodotti Firebase , come Analytics, Cloud Firestore, Performance Monitoring o Remote Config.
Scopri informazioni più dettagliate su questo processo nella guida introduttiva per la tua piattaforma:
iOS+ | Androide | web | unità | C++ | Svolazzare .
Comprendere la gerarchia dei progetti Firebase
Questo diagramma mostra la gerarchia di base di un progetto Firebase. Ecco le relazioni chiave:
Un progetto Firebase è come un contenitore per tutte le tue app e tutte le risorse e i servizi forniti per il progetto.
Un progetto Firebase può avere una o più app Firebase registrate (ad esempio, entrambe le versioni iOS e Android di un'app o entrambe le versioni gratuite ea pagamento di un'app).
Tutte le app Firebase registrate nello stesso progetto Firebase condividono e hanno accesso a tutte le stesse risorse e servizi forniti 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à di Google Analytics, dove ogni app Firebase è un flusso di dati separato in quella proprietà.
Relazione tra i progetti Firebase e Google Cloud
Quando crei un nuovo progetto Firebase, stai effettivamente creando un progetto Google Cloud dietro le quinte. Puoi anche creare prima un progetto Google Cloud, quindi aggiungere Firebase al progetto in un secondo momento. Puoi pensare a un progetto Google Cloud come a un contenitore virtuale per dati, codice, configurazione e servizi.
Poiché un progetto Firebase è un progetto Google Cloud:
Puoi interagire con un progetto nella console Firebase così come in Google Cloud Console e nella console delle API di Google .
Puoi utilizzare prodotti e API sia da Firebase che da Google Cloud in un progetto.
La fatturazione e le autorizzazioni per un progetto sono condivise su Firebase e Google Cloud.
Gli identificatori univoci per un progetto (come il numero del progetto e l'ID progetto ) sono condivisi su Firebase e Google Cloud.
L'eliminazione di un progetto lo elimina su Firebase e Google Cloud.
Configurazione di un progetto Firebase e registrazione di app
Puoi configurare un progetto Firebase e registrare le app nella console Firebase (o, per casi d'uso avanzati, tramite l' API REST di Firebase Management o l'interfaccia a riga di comando di Firebase). 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, è necessario impostare un flusso di lavoro di sviluppo chiaro, che in genere prevede l'utilizzo di più ambienti. Consulta la nostra documentazione sui flussi di lavoro degli sviluppatori , incluse le best practice generali e le linee guida generali sulla sicurezza per la configurazione dei progetti Firebase e la registrazione delle app per creare il tuo flusso di lavoro di sviluppo.
Interagire con un progetto Firebase
Oltre agli SDK del prodotto, 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 pannello di sinistra della console elenca i prodotti Firebase, organizzati per categorie di primo livello. Nella parte superiore del pannello di sinistra, accedi alle impostazioni di un progetto facendo clic su integrazioni , autorizzazioni di accesso e fatturazione .
. Le impostazioni di un progetto includonoAl centro della console vengono visualizzati i pulsanti che avviano i flussi di lavoro di configurazione per registrare vari tipi di app. Dopo aver iniziato a utilizzare Firebase, l'area principale della console si trasforma in 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 di Google Cloud Console invece della console Firebase.
Firebase CLI (uno strumento da riga di comando)
Firebase offre anche la CLI Firebase per la configurazione e la gestione di prodotti Firebase specifici, come Firebase Hosting, Cloud Functions for Firebase e Firebase Extensions.
Dopo aver installato la CLI, hai accesso al comando globale di firebase
. Utilizza l'interfaccia a riga di comando per collegare la directory dell'app locale a un progetto Firebase , quindi distribuisci nuove versioni di contenuti ospitati da Firebase o aggiornamenti alle funzioni.
API REST di gestione di Firebase
Utilizzando l' API REST di gestione di Firebase , puoi gestire a livello di codice un progetto Firebase. Ad esempio, puoi registrare a livello di codice un'app con un progetto o elencare le app che sono già registrate ( iOS+ | Android | web ).
Identificatori di progetto Firebase
Un progetto Firebase può essere identificato nel backend Firebase e in varie interfacce per sviluppatori utilizzando identificatori diversi, inclusi il nome del progetto, il numero del progetto e l' ID progetto .
Il nome del progetto
Quando crei un progetto, fornisci un nome progetto . Questo identificatore è il nome solo interno per un progetto nella console Firebase , Google Cloud Console e Firebase CLI . Il nome del progetto non è esposto in nessun prodotto, servizio o risorsa Firebase o Google Cloud visibile pubblicamente; serve semplicemente per aiutarti a distinguere più facilmente tra più progetti.
Puoi modificare il nome di un progetto in qualsiasi momento nelle progetto della console Firebase. Il nome del progetto viene visualizzato nel riquadro superiore.
Il numero del progetto
Un progetto Firebase (e il relativo progetto Google Cloud associato ) ha un numero di progetto . Questo è l'identificatore canonico univoco globale assegnato da Google per il progetto. Utilizza questo identificatore quando configuri integrazioni e/o effettui chiamate API a Firebase, Google o servizi di terze parti.
Non è possibile modificare un numero di progetto. Se elimini un progetto, anche il numero del progetto viene eliminato e non può più essere utilizzato da nessun altro progetto.
Trova il numero di progetto del tuo progetto Firebase utilizzando una di queste opzioni:
Utilizzando la console Firebase : fai clic su progetto . Il numero del progetto viene visualizzato nel riquadro superiore.
Utilizzando l'interfaccia a riga di comando di Firebase : eseguire
firebase projects:list
. Il numero del progetto viene visualizzato insieme a tutti i progetti Firebase associati al tuo account.Utilizzando l'API REST di Firebase Management : Chiamare
projects.list
. Il corpo della risposta contiene il numero del progetto nell'oggettoFirebaseProject
.
Per molte chiamate API, devi includere un identificatore univoco per un progetto. Sebbene molte API accettino l' ID progetto , ti consigliamo di utilizzare il numero del progetto per effettuare chiamate API a Firebase, Google o servizi di terze parti.
Ulteriori informazioni sull'utilizzo degli identificatori di progetto, in particolare il numero di progetto, nello standard AIP 2510 di Google.
L'ID del progetto
Un progetto Firebase (e il relativo progetto Google Cloud associato ) ha un ID progetto . Questo è 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 dovrebbe generalmente essere trattato come un alias di convenienza per fare riferimento al progetto.
Trova l' ID progetto del tuo progetto Firebase utilizzando una di queste opzioni:
Utilizzando la console Firebase : fai clic su progetto . L'ID del progetto viene visualizzato nel riquadro superiore.
Utilizzando l'interfaccia a riga di comando di Firebase : eseguire
firebase projects:list
. L'ID progetto viene visualizzato insieme a tutti i progetti Firebase associati al tuo account.Utilizzando l'API REST di Firebase Management : Chiamare
projects.list
. Il corpo della risposta contiene l'ID progetto nell'oggettoFirebaseProject
.
L'ID progetto viene visualizzato nelle risorse Firebase pubblicamente visibili, ad esempio:
- Sottodominio di hosting predefinito:
PROJECT_ID .web.app
ePROJECT_ID .firebaseapp.com
- URL del database in tempo reale predefinito:
PROJECT_ID -default-rtdb.firebaseio.com
oPROJECT_ID -default-rtdb. REGION_CODE .firebasedatabase.app
- Nome del bucket di Cloud Storage predefinito:
PROJECT_ID .appspot.com
Per tutte le suddette risorse, puoi creare istanze non predefinite. I nomi pubblicamente visibili dei non predefiniti sono completamente personalizzabili. Puoi connettere domini personalizzati a un sito ospitato da Firebase, eseguire lo shard del database in tempo reale e creare più bucket di Cloud Storage (visita la pagina introduttiva specifica della piattaforma).
Per alcuni casi d'uso, potresti avere più progetti Firebase associati alla stessa directory dell'app locale. In queste situazioni, quando utilizzi l'interfaccia a riga di comando di Firebase , devi passare il flag --project
con i comandi firebase
per comunicare con quale progetto Firebase vuoi interagire.
Puoi anche impostare un alias di progetto per ogni progetto Firebase in modo da non dover ricordare gli ID progetto.
Per molte chiamate API, devi includere un identificatore univoco per un progetto. Sebbene molte API accettino l'ID progetto, ti consigliamo di utilizzare il numero del progetto per effettuare chiamate API a Firebase, Google o servizi di terze parti.
Ulteriori informazioni sull'utilizzo degli identificatori di progetto, in particolare il numero di progetto, nello standard AIP 2510 di Google.
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 Android, aggiungi un file di configurazione
google-services.json
. - Per le app Web, aggiungi un oggetto di configurazione Firebase.
In qualsiasi momento, puoi ottenere il file di configurazione o l'oggetto Firebase di un'app .
Un file o un oggetto di configurazione Firebase associa un'app a un progetto Firebase specifico e alle sue risorse (database, storage bucket, ecc.). La configurazione include "Opzioni Firebase", che sono parametri richiesti dai servizi Firebase e Google per comunicare con le API del server Firebase e per associare i dati del client al progetto Firebase e all'app Firebase. Ecco le "opzioni Firebase" minime obbligatorie:
Chiave API : una semplice stringa crittografata utilizzata quando si chiamano determinate API che non necessitano di accedere ai dati utente privati (valore di esempio:
AIzaSyDOCAbC123dEf456GhI789jKl012-MnO
)ID progetto : un identificatore univoco definito dall'utente per il progetto in tutto Firebase e Google Cloud. Questo identificatore può apparire negli URL o nei nomi di alcune risorse Firebase, ma in genere dovrebbe essere considerato un alias di convenienza per fare riferimento al progetto. (valore di esempio:
myapp-project-123
)ID applicazione ("AppID") : l'identificatore univoco per l'app Firebase in tutto Firebase con un formato specifico della piattaforma:
- App Apple Firebase:
GOOGLE_APP_ID
(valore di esempio:1:1234567890:ios:321abc456def7890
)
Questo non è un ID bundle Apple. - App Android Firebase:
mobilesdk_app_id
(valore di esempio:1:1234567890:android:321abc456def7890
)
Questo non è un nome di pacchetto Android o un ID applicazione Android. - App Web Firebase:
appId
(valore di esempio:1:65211879909:web:3ae38ef1cdcb2e01fe5f0c
)
- App Apple Firebase:
Il contenuto del file o dell'oggetto di configurazione di Firebase è considerato pubblico, incluso 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 del database in tempo reale e Nome del bucket di Cloud Storage. Detto questo, utilizza le regole di sicurezza Firebase per proteggere i tuoi dati e file in Realtime Database , Cloud Firestore e Cloud Storage .
Per i progetti open source, generalmente non consigliamo di includere il file di configurazione o l'oggetto Firebase dell'app nel controllo del codice sorgente perché, nella maggior parte dei casi, gli utenti dovrebbero creare i propri progetti Firebase e indirizzare le proprie app alle proprie risorse Firebase (tramite la propria configurazione Firebase file o oggetto).
Limiti generali per progetti, app e siti Firebase
Di seguito sono riportati alcuni limiti generali per progetti, app e siti Firebase:
Numero di progetti per account
- Piano tariffario Spark: la quota di creazione del progetto è limitata a un numero inferiore di progetti (di solito circa 5-10).
- Piano tariffario Blaze: la quota di creazione di progetti per account aumenta in modo sostanziale finché l'account di fatturazione Cloud associato è in regola.
Il limite alla quota di creazione del progetto è raramente un problema per la maggior parte degli sviluppatori, ma se necessario, puoi richiedere un aumento della quota del progetto .
Tieni presente che l'eliminazione completa di un progetto richiede 30 giorni e conta ai fini della quota del progetto fino a quando il progetto non viene completamente eliminato.
Numero di app per progetto
Firebase limita a 30 il numero totale di app Firebase all'interno di un progetto Firebase.
Dovresti 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. Maggiori informazioni sulla multi-tenancy nei nostri documenti sulle best practice.
Scopri di più sul limite di app per progetto nelle domande frequenti.
Numero di siti di hosting per progetto
La funzionalità multisito di Firebase Hosting supporta un massimo di 36 siti per progetto.
Avvio della tua app
- Imposta avvisi di budget per il tuo progetto in Google Cloud Console.
- Monitora il dashboard di utilizzo e fatturazione nella console Firebase per avere un quadro generale dell'utilizzo del tuo progetto su più servizi Firebase.
- Esamina l'elenco di controllo per l'avvio di Firebase .