Google si impegna a far progredire equità razziale per le comunità nere. Vedi come.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

Comprendere progetti Firebase

Questa pagina offre una breve panoramica di alcuni importanti concetti relativi progetti Firebase. Quando è disponibile, seguire i link per trovare informazioni più dettagliate circa le caratteristiche, i servizi, e anche altre piattaforme. In fondo a questa pagina, trovi una lista di buone pratiche generali per i progetti Firebase.

Relazione tra Firebase progetti, applicazioni e prodotti

Un progetto Firebase è l'entità di livello superiore per Firebase. In un progetto, si creano le applicazioni Firebase registrando le tue app iOS, Android o web. Dopo aver registrato le tue applicazioni con Firebase, è possibile aggiungere gli SDK Firebase per qualsiasi numero di Firebase prodotti , come Analytics, Nube FireStore, monitoraggio delle prestazioni, o Configurazione remota.

Maggiori informazioni più dettagliate su questo processo nelle guide introduttive ( iOS | Android | web | Unità | C ++ ).

Relazione tra i progetti Firebase e Google Cloud Platform (GCP)

Quando si crea un nuovo progetto Firebase nella console Firebase, si sta effettivamente creando un progetto di Google Cloud Platform (GCP) dietro le quinte. Si può pensare a un progetto GCP come un contenitore virtuale per i dati, il codice, la configurazione e servizi. Un progetto di Firebase è un progetto GCP che ha configurazioni e servizi Firebase-specifici aggiuntivi. È anche possibile creare un progetto GCP prima, quindi aggiungere Firebase al progetto in seguito.

Dal momento che un progetto Firebase è un progetto GCP:

La creazione di un progetto di Firebase e registrare le app

È possibile impostare un progetto Firebase e registrare le app nella console Firebase (o, per casi di utilizzo avanzati, tramite la Firebase gestione API REST o la Firebase CLI ). Quando si imposta un progetto e di registrare le applicazioni, è necessario prendere alcune decisioni organizzative e aggiungere Firebase-specifiche informazioni di configurazione per i vostri progetti locali.

Assicurati di rivedere alcune best practice generale a livello di progetto (in fondo a questa pagina) prima di impostare un progetto e la registrazione applicazioni.

Il nome del progetto

Quando si crea un progetto, è necessario fornire un nome di progetto. Questo identificatore è il nome interno-solo per un progetto nella console Firebase , la console GCP , e la Firebase CLI . Il nome del progetto non è esposto in alcun visibile pubblicamente Firebase o GCP prodotto, servizio o di una risorsa; serve semplicemente per aiutare a distinguere più facilmente tra più progetti.

È possibile modificare il nome di progetto in qualsiasi momento nelle impostazioni del progetto della console Firebase. Il nome del progetto viene visualizzata nel riquadro in alto.

Il numero di progetto

Un progetto Firebase (e il suo progetto GCP associata ) ha un numero di progetto. Questo è l'identificatore univoco globale canonica Google-assegnato per il progetto. Utilizza questo identificativo per la configurazione integrazioni e / o effettuare le chiamate API a Firebase, Google, o servizi di terze parti.

chiamate API e il numero di progetto

Per molte chiamate API, è necessario includere un identificatore univoco per un progetto. Anche se molte API accettano l' ID del progetto , si consiglia di utilizzare il numero di progetto per effettuare le chiamate API a Firebase, Google, o servizi di terze parti.

Ulteriori informazioni sull'utilizzo di identificatori di progetto, in particolare il numero di progetto, in Google AIP 2510 di serie .

Trovare il numero di progetto

  • Console Firebase: Fare clic su Impostazioni del progetto . Il numero di progetto viene visualizzato nel riquadro in alto.

  • Firebase CLI: Esegui firebase projects:list . Il numero di progetto viene visualizzato insieme a tutti i progetti Firebase associati al tuo account.

  • Firebase Gestione REST API: Chiamata projects.list . Il corpo di risposta contiene il numero di progetto nel FirebaseProject oggetto.

L'ID del progetto

Un progetto Firebase (e il suo progetto GCP associata ) ha un ID progetto. Questo è un identificatore univoco definito dall'utente per il progetto in tutte Firebase e GCP. Quando si crea un progetto Firebase, Firebase assegna automaticamente un ID univoco per il progetto, ma è possibile modificarlo durante l'installazione del progetto. Questo identificatore dovrebbe essere generalmente trattato come un alias convenienza per fare riferimento al progetto.

Se si elimina un progetto, l'ID del progetto viene anche eliminato e non può mai essere riutilizzato da qualsiasi altro progetto.

risorse Firebase e l'ID del progetto

I display ID progetto in termini di risorse Firebase visibili pubblicamente, ad esempio:

  • Predefinito Hosting sottodominio - PROJECT_ID .web.app e PROJECT_ID .firebaseapp.com
  • Predefinito in tempo reale URL del database - PROJECT_ID .firebaseio.com
  • Predefinito Cloud Storage nome bucket - PROJECT_ID .appspot.com

Per tutte le risorse di cui sopra, è possibile creare istanze non predefinite. I nomi visibili pubblicamente di non-valori predefiniti sono completamente personalizzabile. È possibile collegare i domini personalizzati a un sito Firebase-hosted, coccio il database in tempo reale , e creare più secchi di cloud storage (visita la pagina di piattaforma specifica Introduzione).

Il Firebase CLI e l'ID del progetto

Per alcuni casi di utilizzo, si potrebbe avere più progetti Firebase associati alla stessa directory applicazione locale. In queste situazioni, quando si utilizza il Firebase CLI , è necessario passare alla --project bandiera con la firebase comandi di comunicare quale progetto Firebase si desidera interagire.

È anche possibile impostare un alias di progetto per ogni progetto Firebase in modo che non c'è bisogno di ricordare gli ID di progetto.

chiamate API e l'ID del progetto

Per molte chiamate API, è necessario includere un identificatore univoco per un progetto. Anche se molte API accettare l'ID del progetto, si consiglia di utilizzare il numero di progetto per effettuare le chiamate API a Firebase, Google, o servizi di terze parti.

Ulteriori informazioni sull'utilizzo di identificatori di progetto, in particolare il numero di progetto, in Google AIP 2510 di serie .

Trovare l'ID del progetto

  • Console Firebase: Fare clic su Impostazioni del progetto . L'ID del progetto viene visualizzata nel riquadro in alto.

  • Firebase CLI: Esegui firebase projects:list . L'ID progetto viene visualizzato insieme a tutti i progetti Firebase associati al tuo account.

  • Firebase Gestione REST API: Chiamata projects.list . Il corpo di risposta contiene l'ID progetto nel FirebaseProject oggetto.

i file di configurazione Firebase e oggetti

Quando si registra un app con un progetto Firebase, la console Firebase fornisce un file di configurazione Firebase (iOS / Android app) o di un oggetto di configurazione (applicazioni web), che si aggiunge direttamente alla cartella app locale.

  • Per le app iOS, si aggiunge un GoogleService-Info.plist file di configurazione.
  • Per le applicazioni Android, si aggiunge un google-services.json file di configurazione.
  • Per applicazioni web, si aggiunge un oggetto di configurazione Firebase.

In qualsiasi momento, è possibile ottenere file di configurazione Firebase di un'applicazione o di un oggetto .

Un file di configurazione o di un oggetto Firebase associa un app con uno specifico progetto Firebase e delle sue risorse (banche dati, bucket di archiviazione, ecc). La configurazione comprende "opzioni Firebase", che sono i parametri richiesti dai servizi Firebase e Google per comunicare con le API di server Firebase e ai dati dei clienti associare il progetto Firebase e Firebase app. Qui ci sono i minimi, "opzioni" Firebase richiesto:

  • Chiave API : una semplice stringa crittografata utilizzata quando si chiama alcune API che non hanno bisogno di accedere ai dati degli utenti privati (ad esempio il valore: AIzaSyDOCAbC123dEf456GhI789jKl012-MnO )

  • Progetto ID : un identificativo univoco definito dall'utente per il progetto in tutte Firebase e GCP. Questo identificatore può apparire negli URL o nomi di alcune risorse Firebase, ma dovrebbe essere generalmente trattato come un alias convenienza per fare riferimento al progetto. (valore di esempio: myapp-project-123 )

  • ID applicazione ( "AppID"): l'identificatore univoco per l'applicazione Firebase in tutte Firebase con un formato piattaforma specifica:

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

Il contenuto del file di configurazione Firebase o un oggetto è considerato pubblico, tra cui ID dell'app specifiche della piattaforma (iOS fascio ID o Android nome del pacchetto) ei valori Firebase specifici del progetto, come l'API Key, ID del progetto, l'URL del database in tempo reale, e Stoccaggio nome secchio. Dato questo, la sicurezza utilizzare le regole per proteggere i dati e file in tempo reale del database , Nuvola FireStore , e Cloud Storage .

Per i progetti open source, in genere non è consigliabile tra cui file di configurazione Firebase dell'app o l'oggetto nel controllo del codice sorgente, perché, nella maggior parte dei casi, gli utenti devono creare i propri progetti Firebase e indicare le loro applicazioni alle proprie risorse Firebase (tramite il proprio Firebase config file o oggetto).

Gestione di un progetto di Firebase

Assicurati di rivedere le migliori pratiche generali a livello di progetto (in fondo a questa pagina) per le considerazioni che potrebbero influenzare il modo di gestire un progetto Firebase.

Strumenti per la gestione di un progetto

console Firebase

Il Firebase console offre un ambiente più ricco per la gestione dei prodotti Firebase, applicazioni e impostazioni a livello di progetto.

console Firebase - schermo panoramica del progetto

Il pannello di sinistra delle liste di console i prodotti Firebase, organizzati per categorie di livello superiore. Nella parte superiore del pannello di sinistra-side, l'accesso le impostazioni di un progetto facendo clic . Impostazioni di un progetto includono integrazioni , autorizzazioni di accesso , e la fatturazione .

La metà dei pulsanti della console mostra che l'installazione di lancio flussi di lavoro di registrare vari tipi di applicazioni. Dopo aver avviato utilizzando Firebase, l'area principale dei cambiamenti console in un dashboard che visualizza le statistiche sui prodotti che usano.

Firebase CLI (una linea di ordine)

Firebase offre anche la Firebase CLI per la configurazione e la gestione di specifici Firebase prodotti, come le funzioni cloud Firebase Hosting e per Firebase.

Dopo aver installato il CLI, si ha accesso al globale firebase di comando . Utilizzare la CLI per collegare il tuo cartella app locale per un progetto Firebase , quindi distribuire nuove versioni di contenuti Firebase-hosted o aggiornamento di funzioni.

Firebase Gestione API REST

Utilizzando l' API REST Firebase di gestione , è possibile gestire a livello di programmazione un progetto Firebase. Ad esempio, è possibile a livello di codice registrare un app con un progetto o di elencare le applicazioni che sono già registrati ( iOS | Android | web ).

migliori pratiche generali

Aggiunta di app a un progetto

Garantire che tutte le applicazioni all'interno di un progetto sono varianti della piattaforma della stessa applicazione dal punto di vista dell'utente finale. Si consiglia di registrare l'iOS, Android, e le versioni web della stessa applicazione o gioco con lo stesso progetto Firebase. Tutte le applicazioni di un progetto in generale condividono le stesse risorse Firebase (database, bucket di archiviazione, ecc).

Se si dispone di creare più varianti con differenti iOS fascio ID o nomi dei pacchetti Android definiti, è possibile registrare ogni variante con un progetto Firebase separata. Tuttavia, se si dispone di varianti che condividono le stesse risorse Firebase, li registri con lo stesso progetto Firebase.

Mentre non v'è alcuna restrizione sul numero di applicazioni all'interno di un progetto, registrando un app in grado di creare uno o più sottostanti ID client OAuth 2.0. C'è un limite di circa 30 client ID che possono essere creati all'interno di un unico progetto.

Multi-tenancy

Non è consigliabile il collegamento di più applicazioni diverse logicamente indipendenti e / o siti web ad un singolo progetto (spesso chiamato "multi-tenancy"). Multi-tenancy può portare a gravi di configurazione e la privacy dei dati riguarda i problemi, comprese le questioni impreviste con analisi di aggregazione, di autenticazione condivisa, strutture di database eccessivamente complesse, e le difficoltà con le regole di sicurezza.

In generale, se un insieme di applicazioni non condividono gli stessi dati e configurazioni, prendere in seria considerazione la registrazione ogni applicazione con un diverso progetto di Firebase.

Ad esempio, se si sviluppa un'applicazione etichetta bianca, ogni app etichettata in modo indipendente dovrebbe avere il proprio progetto di Firebase. Ogni applicazione fa e non deve (per motivi di privacy) condividere i dati con gli altri.

Nota alcuni limiti generali per progetti Firebase, applicazioni e siti:

  • Numero di progetti per conto

    • Free-tier plan Spark - quota Project-creazione è limitata ad un numero minore di progetti (di solito circa 5-10).
    • piani di pagamento - Contingente Project-creazione per fatturazione aumenta conto sostanzialmente fino a quando l'account di fatturazione cloud associata è in regola.

    Il limite delle quote di progetto-creazione è raramente una preoccupazione per la maggior parte degli sviluppatori, ma, se necessario, è possibile richiedere un aumento della quota di progetto .

    Essere consapevoli del fatto che la cancellazione completa di un progetto richiede 30 giorni e conteggi verso quota progetto fino a quando il progetto è completamente cancellato.

  • Numero di applicazioni per progetto

    Mentre non v'è alcuna restrizione sul numero di applicazioni all'interno di un progetto, registrando un app in grado di creare uno o più sottostanti ID client OAuth 2.0. C'è un limite di circa 30 client ID che possono essere creati all'interno di un unico progetto.

  • Numero di siti di hosting per progetto

    Il Firebase Hosting funzione multisito supporta un massimo di 36 siti per progetto.

Lancio la vostra applicazione