Google is committed to advancing racial equity for Black communities. See how.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

Inizia sul Web

Cloud Storage per Firebase ti consente di caricare e condividere contenuti generati dagli utenti, come immagini e video, che ti consentono di creare contenuti multimediali avanzati nelle tue app. I tuoi dati vengono archiviati in un bucket Google Cloud Storage , una soluzione di archiviazione di oggetti su scala exabyte con disponibilità elevata e ridondanza globale. Cloud Storage ti consente di caricare in modo sicuro questi file direttamente da dispositivi mobili e browser Web, gestendo facilmente le reti irregolari.

Prerequisiti

Aggiungi e configura Firebase SDK nella tua app.

Crea un bucket di archiviazione predefinito

  1. Dal pannello di navigazione della console Firebase , seleziona Archiviazione , quindi fai clic su Inizia .

  2. Esamina i messaggi sulla protezione dei dati di archiviazione utilizzando le regole di sicurezza. Durante lo sviluppo, valuta la possibilità di impostare le tue regole per l'accesso pubblico .

  3. Seleziona una posizione per il bucket di archiviazione predefinito.

    • Questa impostazione di posizione è la posizione delle risorse di Google Cloud Platform (GCP) predefinita del progetto. Tieni presente che questa posizione verrà utilizzata per i servizi GCP nel tuo progetto che richiedono un'impostazione della posizione, in particolare, il tuo database Cloud Firestore e la tua app App Engine (necessaria se utilizzi Cloud Scheduler).

    • Se non sei in grado di selezionare una posizione, il progetto ha già una posizione della risorsa GCP predefinita. È stato impostato durante la creazione del progetto o durante la configurazione di un altro servizio che richiede un'impostazione della posizione.

    Se hai un piano Blaze, puoi creare più bucket , ciascuno con la propria posizione .

  4. Fare clic su Fine .

Configura l'accesso pubblico

Cloud Storage per Firebase fornisce un linguaggio delle regole dichiarative che ti consente di definire come devono essere strutturati i tuoi dati, come devono essere indicizzati e quando i tuoi dati possono essere letti e scritti. Per impostazione predefinita, l'accesso in lettura e scrittura all'archiviazione è limitato, quindi solo gli utenti autenticati possono leggere o scrivere dati. Per iniziare senza configurare l' autenticazione , puoi configurare le tue regole per l'accesso pubblico .

Ciò rende lo spazio di archiviazione aperto a chiunque, anche a chi non utilizza la tua app, quindi assicurati di limitare nuovamente lo spazio di archiviazione quando imposti l'autenticazione.

Aggiungi l'URL del tuo bucket alla tua app

Se non è già incluso, devi aggiungere l'URL del bucket di archiviazione all'oggetto di configurazione dell'app Firebase .

  1. Vai alla dashboard dello spazio di archiviazione nella console Firebase .

  2. Fare clic sulla scheda File , quindi cercare nell'intestazione del visualizzatore di file.

  3. Copia l'URL negli appunti. Di solito è nella forma project-id .appspot.com .

  4. Al tuo oggetto firebaseConfig nella tua app, aggiungi l'attributo storageBucket con l'URL del tuo bucket: 

      // Set the configuration for your app
  // TODO: Replace with your app's config object
  var firebaseConfig = {
    apiKey: '<your-api-key>',
    authDomain: '<your-auth-domain>',
    databaseURL: '<your-database-url>',
    storageBucket: '<your-storage-bucket-url>'
  };
  firebase.initializeApp(firebaseConfig);

  // Get a reference to the storage service, which is used to create references in your storage bucket
  var storage = firebase.storage();

Sei pronto per iniziare a utilizzare Cloud Storage!

Passo successivo? Scopri come creare un riferimento a Cloud Storage .

Impostazioni avanzate

Esistono alcuni casi d'uso che richiedono una configurazione aggiuntiva:

Il primo caso d'uso è perfetto se hai utenti in tutto il mondo e desideri archiviare i loro dati vicino a loro. Ad esempio, puoi creare bucket negli Stati Uniti, in Europa e in Asia per archiviare i dati per gli utenti in quelle regioni per ridurre la latenza.

Il secondo caso d'uso è utile se si hanno dati con modelli di accesso diversi. Ad esempio: puoi configurare un bucket multiregionale o regionale che memorizza immagini o altri contenuti a cui si accede frequentemente e un bucket nearline o coldline che archivia i backup degli utenti o altri contenuti a cui si accede di rado.

In uno di questi casi d'uso, ti consigliamo di utilizzare più bucket di archiviazione .

Il terzo caso d'uso è utile se stai creando un'app, come Google Drive, che consente agli utenti di avere più account collegati (ad esempio, un account personale e un account di lavoro). Puoi utilizzare un'istanza dell'app Firebase personalizzata per autenticare ogni account aggiuntivo.

Utilizza più bucket di archiviazione

Se desideri utilizzare un bucket di archiviazione diverso da quello predefinito fornito sopra o utilizzare più bucket di archiviazione in una singola app, puoi creare un'istanza di firebase.storage che fa riferimento al tuo bucket personalizzato: 

// Get a non-default Storage bucket
var storage = firebase.app().storage("gs://my-custom-bucket");

Lavorare con secchi importati

Quando importi un bucket Cloud Storage esistente in Firebase, dovrai concedere a Firebase la possibilità di accedere a questi file utilizzando lo strumento gsutil , incluso in Google Cloud SDK : 

gsutil -m acl ch -r -u firebase-storage@system.gserviceaccount.com:O gs://<your-cloud-storage-bucket>

Ciò non influisce sui bucket appena creati, poiché quelli hanno il controllo di accesso predefinito impostato per consentire Firebase. Questa è una misura temporanea e verrà eseguita automaticamente in futuro.

Usa un'app Firebase personalizzata

Se stai creando un'app più complicata utilizzando un'app firebase.app.App personalizzata, puoi creare un'istanza di firebase.storage.Storage inizializzata con firebase.storage.Storage : 

// Get the default bucket from a custom firebase.app.App
var storage = customApp.storage();

// Get a non-default bucket from a custom firebase.app.App
var storage = customApp.storage("gs://my-custom-bucket");

Prossimi passi