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: registra le tue app Apple, Android o web. Dopo aver registrato le app con Firebase, puoi aggiungere gli SDK Firebase per qualsiasi numero Prodotti Firebase, ad esempio Analytics, Cloud Firestore, Performance Monitoring o Remote Config.
Puoi trovare ulteriori informazioni su questa procedura nella sezione Guida introduttiva
guida per la tua piattaforma:
iOS+ | Android |
web | Unità | C++ |
Flutter.
Informazioni sulla gerarchia dei progetti Firebase
Questo diagramma mostra la gerarchia di base di un progetto Firebase. Ecco le relazioni principali:
Un progetto Firebase è come un contenitore per tutte le app e 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, entrambe le versioni di un'app per iOS e Android o entrambe le versioni senza costi e versioni a pagamento di un'app).
Tutte le app Firebase registrate nello stesso progetto Firebase condividono e hanno l'accesso a tutte le risorse e gli stessi servizi di cui è stato eseguito il provisioning per il progetto. Ecco alcuni esempi:
Tutte le app Firebase registrate nello stesso progetto Firebase condividono lo stesso di 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 con la stessa proprietà Google Analytics, dove ogni app Firebase è un e uno stream di dati separato in quella proprietà.
Relazione tra progetti Firebase e Google Cloud
Quando crei un nuovo progetto Firebase, di fatto crei una Progetto Google Cloud dietro le quinte. Puoi anche creare prima un progetto Google Cloud, poi aggiungere Firebase in un secondo momento. Puoi pensare a un progetto Google Cloud come container virtuale per dati, codice, configurazione e servizi.
Tieni presente che, per tutti i progetti Firebase, Firebase aggiunge automaticamente l'etichetta
firebase:enabled nel
Pagina Etichette
per il tuo progetto nella console Google Cloud. Scopri di più su questa etichetta in
le nostre Domande frequenti.
Poiché un progetto Firebase è un progetto Google Cloud:
Puoi interagire con un progetto nella console Firebase, nella console Google Cloud e nella console API di Google.
Puoi utilizzare i prodotti e le API sia di Firebase che di Google Cloud in un progetto.
Fatturazione e le autorizzazioni di un progetto sono condivise Firebase e Google Cloud.
Identificatori univoci per un progetto (come numero di progetto e ID progetto) sono condivisi tra Firebase e Google Cloud.
L'eliminazione di un progetto comporta l'eliminazione in Firebase e Google Cloud.
Configurazione di un progetto Firebase e registrazione delle app
Puoi configurare un progetto Firebase e registrare le app nella console Firebase (o, per casi d'uso avanzati, tramite API REST Firebase Management o interfaccia a riga di comando Firebase). Quando configuri un progetto e registrare le app, devi prendere alcune decisioni organizzative e aggiungere con le informazioni di configurazione specifiche di Firebase per i progetti locali.
Per le app di produzione, devi definire un flusso di lavoro per lo sviluppo chiaro, che di solito prevede l'utilizzo di più ambienti. Consulta la nostra documentazione su flussi di lavoro degli sviluppatori, tra cui best practice generali e linee guida generali sulla sicurezza per impostare progetti Firebase e registrare app per creare il tuo sviluppo un flusso di lavoro di machine learning.
Interazione con un progetto Firebase
Oltre agli SDK del prodotto, puoi interagire direttamente con un progetto Firebase usando diversi strumenti e interfacce.
Console Firebase
La console Firebase offre l'ambiente più completo per la gestione di Firebase prodotti, app e impostazioni a livello di progetto.
Console Firebase - schermata di panoramica del progetto"
class="attempt-right screenshot"
style="max-width: calc((100% - 40px)/1.75);">
Il riquadro laterale sinistro della console elenca i prodotti Firebase, organizzati per categorie di primo livello. Nella parte superiore del riquadro laterale sinistro, accedi alla finestra impostazioni facendo clic su . Il traffico di un progetto le impostazioni includono integrazioni, autorizzazioni di accesso, e fatturazione.
Al centro della console sono visualizzati i pulsanti che avviano i flussi di lavoro di configurazione registrare vari tipi di app. Dopo aver iniziato a utilizzare Firebase, l'area principale la console si trasforma in una dashboard che mostra le statistiche sui prodotti per gli utilizzi odierni.
Tieni presente che, poiché un progetto Firebase è anche un progetto Google Cloud, potresti che varie attività o prodotti richiedono l'utilizzo Console Google Cloud anziché la console Firebase.
Interfaccia a riga di comando Firebase (strumento a riga di comando)
Firebase offre anche l'interfaccia a riga di comando di 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, puoi accedere
comando firebase globale. Utilizza l'interfaccia a riga di comando per
collega la directory delle app locali a un
progetto Firebase,
eseguire il deployment di nuove versioni dei contenuti ospitati da Firebase
alle funzioni.
API REST Firebase Management
L'utilizzo del API REST Firebase Management, puoi gestire in modo programmatico un progetto Firebase. Ad esempio, puoi registrare in modo programmatico un'app con un progetto o elencare le app già registrato (iOS e versioni successive) | Android | web).
Identificatori dei progetti Firebase
Un progetto Firebase può essere identificato nel backend Firebase e in diverse interfacce degli sviluppatori utilizzando identificatori diversi, tra cui il nome del progetto, il numero di progetto e l'ID progetto.
Il nome del progetto
Quando crei un progetto, fornisci un nome del progetto. Questo identificatore è il nome solo per uso interno per un progetto nel Firebase, Google Cloud console, e l'interfaccia a riga di comando Firebase. Il nome del progetto non è esposto in nessun prodotto, servizio o risorsa Firebase o Google Cloud visibili pubblicamente; questo elemento serve semplicemente per aiutarti a distinguere più facilmente tra più progetti.
Puoi modificare il nome di un progetto in qualsiasi momento nella Progetto impostazioni Console Firebase. Il nome del progetto viene visualizzato nel riquadro superiore.
Il numero del progetto
Un progetto Firebase (e il suo progetto Google Cloud associato) ha un numero di progetto. Si tratta dell'identificatore canonico univoco a livello globale assegnato da Google al progetto. Utilizza questo identificatore quando configuri le integrazioni e/o effettuare chiamate API a Firebase, Google o servizi di terze parti.
Non puoi modificare un numero di progetto. Se elimini un progetto, il numero del progetto è viene eliminato e non può più essere riutilizzato da nessun altro progetto.
L'ID del progetto
Un progetto Firebase (e i relativi progetto Google Cloud associato) ha un ID progetto. Si tratta di un identificatore univoco definito dall'utente per il progetto in il tutto Firebase e Google Cloud. Quando crei un progetto Firebase, assegna automaticamente un ID univoco al progetto, ma puoi modificarlo la configurazione del progetto. In genere, questo identificatore dovrebbe essere 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, viene visualizzata la console Firebase fornisce un file di configurazione Firebase (app Apple/Android) o una configurazione (app web) che aggiungi direttamente alla directory delle app locali.
- Per le app Apple, devi aggiungere 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.
Puoi ottenere l'oggetto o il file di configurazione Firebase di un'app in qualsiasi momento.
Un oggetto o un file di configurazione Firebase associa un'app a un determinato Firebase progetto e le relative risorse (database, bucket di archiviazione e così via). La configurazione include le "opzioni Firebase", che sono parametri richiesti da Firebase. Servizi Google per comunicare con le API del server Firebase e associare il client con il progetto e l'app Firebase. Ecco le dimensioni minime obbligatorie "Opzioni Firebase":
Chiave API: una semplice stringa criptata utilizzata per chiamare determinate API che non richiedono l'accesso dati utente privati (valore di esempio:
AIzaSyDOCAbC123dEf456GhI789jKl012-MnO)ID progetto: un identificatore univoco definito dall'utente per il progetto in Firebase e Google Cloud. Questo identificatore può essere visualizzato negli URL o nei nomi di alcune risorse Firebase, ma e di solito dovrebbe essere considerato un alias di convenienza per fare riferimento progetto. (valore di esempio:
myapp-project-123)ID applicazione ("AppID"): l'identificatore univoco dell'app Firebase su tutto Firebase con un formato specifico per piattaforma:
- App Firebase 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)
- App Firebase Apple:
Il contenuto del file di configurazione o dell'oggetto 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 Realtime Database URL e Cloud Storage nome bucket. Detto questo, utilizzare Firebase Security Rules per proteggere i tuoi dati e file su Realtime Database, Cloud Firestore, e Cloud Storage.
Per i progetti open source, in genere sconsigliamo di includere il codice oggetto o file di configurazione Firebase nel controllo del codice sorgente perché, nella maggior parte dei casi, gli utenti devono creare i propri progetti Firebase e indirizzare le app ai propri le proprie risorse Firebase (tramite il proprio oggetto o file di configurazione Firebase).
Limiti generali per progetti, app e siti Firebase
Di seguito sono riportati alcuni limiti generali per i siti, le app e i progetti 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: aumenti della quota di creazione di progetti per account sostanzialmente purché l'account Cloud Billing associato sia in in regola.
Il limite della quota per la creazione di progetti raramente rappresenta un problema per la maggior parte degli sviluppatori, ma se necessario puoi richiedere un aumento della quota per i progetti.
Tieni presente che 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 completamente eliminato.
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 le varianti di piattaforma della stessa applicazione dal punto di vista dell'utente finale. Letto scopri di più su multitenancy nella nostra documentazione sulle best practice.
Scopri di più sulle limite di app per progetto nelle Domande frequenti.
Numero di Hosting siti per progetto
La funzionalità multisito Firebase Hosting supporta un massimo di 36 siti per progetto.
Avvio dell'app
- Configura gli avvisi sul budget per il tuo progetto nella console Google Cloud.
- Monitorare l'utilizzo e la fatturazione dashboard nella console Firebase per avere un quadro generale per l'utilizzo in più servizi Firebase.
- Consulta l'elenco di controllo per il lancio di Firebase.