Cloud Storage for Firebase vous permet d'importer et de partager du contenu généré par les utilisateurs, comme des images et des vidéos, ce qui vous permet d'intégrer du contenu multimédia enrichi dans vos applications. Vos données sont stockées dans un Google Cloud Storage bucket, une solution de stockage d'objets à l'échelle de l'exaoctet, avec une haute disponibilité et une redondance mondiale. Cloud Storage for Firebase vous permet d'importer ces fichiers de manière sécurisée directement depuis des appareils mobiles et des navigateurs Web, et de gérer facilement les réseaux instables.
Avant de commencer
Si vous ne l'avez pas déjà fait, assurez-vous d'avoir suivi le guide de démarrage pour les applications Android. Par exemple :
Créer un projet Firebase.
Enregistrer votre application Android dans le projet et la connecter à Firebase en ajoutant les dépendances Firebase, le plug-in Google Services et votre fichier de configuration Firebase (
google-services.json) à votre application.
Assurez-vous que votre projet Firebase est associé au forfait Blaze avec paiement à l'usage, qui est requis pour utiliser Cloud Storage for Firebase. Si vous débutez avec Firebase et Google Cloud, vérifiez si vous êtes éligible à un crédit de 300 $.
Créer un bucket Cloud Storage par défaut
Dans la console Firebase, accédez à Bases de données et stockage > Stockage.
Si votre projet n'est pas encore associé au forfait Blaze avec paiement à l'usage, vous serez invité à le mettre à niveau.
Cliquez sur Commencer.
Sélectionnez un emplacement pour votre bucket par défaut.
Les buckets situés dans les régions
US-CENTRAL1US-EAST1US-WEST1Si vous le souhaitez, vous pouvez créer plusieurs buckets ultérieurement chacun avec son propre emplacement.
Configurez les Firebase Security Rules pour votre bucket par défaut. Pendant le développement, envisagez de configurer vos règles pour l'accès public.
Cliquez sur OK.
Vous pouvez maintenant afficher le bucket dans la Firebase console (accédez à l'
onglet Bases de données et stockage > Stockage >
Fichiers).
Le format du nom de votre bucket par défaut est PROJECT_ID.firebasestorage.app
Configurer l'accès public
Cloud Storage for Firebase fournit un langage de règles déclaratif qui vous permet de définir la structure de vos données, leur indexation et le moment où vos données peuvent être lues et écrites. Par défaut, l'accès en lecture et en écriture à Cloud Storage est limité afin que seuls les utilisateurs authentifiés puissent lire ou écrire des données. Pour commencer sans configurer Authentication, vous pouvez configurer vos règles pour l'accès public.
Cela rend Cloud Storage accessible à tous, même aux personnes qui n'utilisent pas votre application. Veillez donc à limiter à nouveau l'accès à Cloud Storage lorsque vous configurez l'authentification.
Ajouter le Cloud Storage SDK à votre application
Dans le fichier Gradle de votre module (au niveau de l'application) (généralement<project>/<app-module>/build.gradle.kts ou
<project>/<app-module>/build.gradle),
ajoutez la dépendance pour la bibliothèque Cloud Storage pour Android. Nous vous recommandons d'utiliser la
Firebase Android BoM
pour contrôler la gestion des versions de la bibliothèque.
dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:34.12.0")) // Add the dependency for the Cloud Storage library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-storage") }
En utilisant les Firebase Android BoM, votre application utilisera toujours des versions compatibles des bibliothèques Firebase Android.
(Autre solution) Ajouter des dépendances de bibliothèque Firebase sans utiliser la BoM
Si vous choisissez de ne pas utiliser la Firebase BoM, vous devez spécifier chaque version de la bibliothèque Firebase dans sa ligne de dépendance.
Notez que si vous utilisez plusieurs bibliothèques Firebase dans votre application, nous vous recommandons vivement d'utiliser la BoM pour gérer les versions des bibliothèques, ce qui garantit que toutes les versions sont compatibles.
dependencies { // Add the dependency for the Cloud Storage library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-storage:22.0.1") }
Configurer Cloud Storage dans votre application
Assurez-vous que le fichier de configuration Firebase (
google-services.json) du code source de votre application est mis à jour avec le nom de votre bucket par défaut Cloud Storage.Utilisez ce fichier de configuration téléchargé pour remplacer le fichier
google-services.jsonexistant dans le répertoire du module (au niveau de l'application) de votre application.Assurez-vous que vous ne disposez que de ce fichier de configuration téléchargé le plus récemment dans votre application et que son nom de fichier n'est pas suivi de caractères supplémentaires, comme
(2).
Accédez à votre Cloud Storage bucket en créant une instance de
FirebaseStorage:Kotlin
storage = Firebase.storage
// Alternatively, explicitly specify the bucket name URL. // val storage = Firebase.storage("gs://BUCKET_NAME")
Java
FirebaseStorage storage = FirebaseStorage.getInstance();
// Alternatively, explicitly specify the bucket name URL. // FirebaseStorage storage = FirebaseStorage.getInstance("gs://BUCKET_NAME");
Vous êtes prêt à commencer à utiliser Cloud Storage !
Étape suivante ? Découvrez comment créer une Cloud Storage référence.
Configuration avancée
Certains cas d'utilisation nécessitent une configuration supplémentaire :
- Utiliser des Cloud Storage buckets dans plusieurs régions géographiques
- Utiliser des Cloud Storage buckets dans différentes classes de stockage
- Utiliser des buckets Cloud Storage avec plusieurs utilisateurs authentifiés dans la même application
Le premier cas d'utilisation est idéal si vous avez des utilisateurs dans le monde entier et que vous souhaitez stocker leurs données à proximité. Par exemple, vous pouvez créer des buckets aux États-Unis, en Europe et en Asie pour stocker les données des utilisateurs de ces régions afin de réduire la latence.
Le deuxième cas d'utilisation est utile si vous disposez de données avec différents modèles d'accès. Par exemple, vous pouvez configurer un bucket multirégional ou régional qui stocke des images ou d'autres contenus fréquemment consultés, et un bucket nearline ou coldline qui stocke des sauvegardes utilisateur ou d'autres contenus rarement consultés.
Dans l'un ou l'autre de ces cas d'utilisation, vous devrez utiliser plusieurs Cloud Storage buckets.
Le troisième cas d'utilisation est utile si vous créez une application, comme Google Drive, qui permet aux utilisateurs d'avoir plusieurs comptes connectés (par exemple, un compte personnel et un compte professionnel). Vous pouvez utiliser une instance d'application Firebase personnalisée pour authentifier chaque compte supplémentaire.
Utiliser plusieurs Cloud Storage buckets
Si vous souhaitez utiliser un Cloud Storage bucket autre que celui par défaut décrit
précédemment dans ce guide, ou utiliser plusieurs Cloud Storage buckets dans une seule application, vous
pouvez créer une instance de FirebaseStorage qui référence votre bucket personnalisé :
Kotlin
// Get a non-default Storage bucket val storage = Firebase.storage("gs://my-custom-bucket")
Java
// Get a non-default Storage bucket FirebaseStorage storage = FirebaseStorage.getInstance("gs://my-custom-bucket");
Utiliser des buckets importés
Lorsque vous importez un bucket Cloud Storage existant dans Firebase, vous devez autoriser Firebase à accéder à ces fichiers à l'aide de l'gsutil outil, inclus dans le Google Cloud SDK :
gsutil -m acl ch -r -u service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://BUCKET_NAME
Vous trouverez le numéro de votre projet comme décrit dans l' introduction aux projets Firebase.
Cela n'a aucune incidence sur les buckets nouvellement créés, car le contrôle d'accès par défaut est défini pour autoriser Firebase. Il s'agit d'une mesure temporaire qui sera effectuée automatiquement à l'avenir.
Utiliser une application Firebase personnalisée
Si vous créez une application plus complexe à l'aide d'une FirebaseApp personnalisée, vous pouvez créer une instance de FirebaseStorage initialisée avec cette application :
Kotlin
// Get the default bucket from a custom FirebaseApp val storage = Firebase.storage(customApp!!) // Get a non-default bucket from a custom FirebaseApp val customStorage = Firebase.storage(customApp, "gs://my-custom-bucket")
Java
// Get the default bucket from a custom FirebaseApp FirebaseStorage storage = FirebaseStorage.getInstance(customApp); // Get a non-default bucket from a custom FirebaseApp FirebaseStorage customStorage = FirebaseStorage.getInstance(customApp, "gs://my-custom-bucket");
Étapes suivantes
Préparez-vous à lancer votre application :
Activez App Check pour vous assurer que seules vos applications peuvent accéder à vos buckets de stockage.
Configurez des alertes de budget pour votre projet dans la Google Cloud console.
Surveillez le tableau de bord _Utilisation et facturation_ dans la console Firebase pour obtenir une vue d'ensemble de l'utilisation de votre projet sur plusieurs services Firebase. Vous pouvez également consulter le tableau de bord Cloud Storage Utilisation pour obtenir des informations plus détaillées sur l'utilisation.
Consultez la checklist de lancement Firebase.