Premiers pas avec Cloud Storage pour C++

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 à vos applications. Vos données sont stockées dans un bucket Google Cloud Storage, une solution de stockage d'objets à l'échelle d'un exaoctet offrant une haute disponibilité et une redondance globale. 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, afin de gérer facilement les réseaux instables.

Avant de commencer

Avant de pouvoir utiliser Cloud Storage, vous devez:

  • Enregistrez votre projet C++ et configurez-le pour utiliser Firebase.

    Si votre projet C++ utilise déjà Firebase, il est déjà enregistré et configuré pour Firebase.

  • Ajoutez le SDK C++ Firebase à votre projet C++.

Notez que l'ajout de Firebase à votre projet C++ implique des tâches à la fois dans la console Firebase et dans votre projet C++ ouvert (par exemple, vous téléchargez des fichiers de configuration Firebase à partir de la console, puis les déplacez dans votre projet C++).

Assurez-vous également que votre projet Firebase est associé au forfait Blaze (paiement à l'usage). Si vous débutez avec Firebase et Google Cloud, vérifiez si vous pouvez bénéficier d'un crédit de 300 $.

Créer un bucket Cloud Storage par défaut

  1. Dans le volet de navigation de la console Firebase, sélectionnez Stockage.

    Si votre projet n'est pas encore associé au forfait Blaze à l'utilisation, vous serez invité à le mettre à niveau.

  2. Cliquez sur Commencer.

  3. Sélectionnez un emplacement pour votre bucket par défaut.

  4. Configurez le Firebase Security Rules pour votre bucket par défaut. Lors du développement, envisagez de configurer vos règles pour l'accès public.

  5. Cliquez sur OK.

Vous pouvez désormais afficher le bucket dans l'onglet Cloud Storage Fichiers de la console Firebase. Le format par défaut du nom de votre bucket 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 et l'indexation de vos données, ainsi que les moments où elles 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 à le restreindre à nouveau lorsque vous configurez l'authentification.

Créer et initialiser firebase::App

Avant de pouvoir accéder à Cloud Storage, vous devez créer et initialiser firebase::App.

Incluez le fichier d'en-tête pour firebase::App:

#include "firebase/app.h"

Android

Créez firebase::App en transmettant l'environnement JNI et une référence jobject à l'activité Java en tant qu'arguments :

app = App::Create(AppOptions(), jni_env, activity);

iOS+

Créez le sous-réseau firebase::App :

app = App::Create(AppOptions());

Accéder à la classe firebase::storage::Storage

La classe firebase::storage::Storage est le point d'entrée du SDK C++ Cloud Storage.

Storage* storage = Storage::GetInstance(app);

Vous pouvez maintenant utiliser Cloud Storage !

Étape suivante ? Découvrez comment créer une référence Cloud Storage.

Configuration avancée

Certains cas d'utilisation nécessitent une configuration supplémentaire:

  • Utiliser des buckets Cloud Storage dans plusieurs pays
  • Utiliser des buckets Cloud Storage dans des classes de stockage différentes
  • 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 vos données présentent 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 consultés fréquemment, et un bucket Nearline ou Coldline qui stocke des sauvegardes utilisateur ou d'autres contenus consultés rarement.

Dans les deux cas, vous devez utiliser plusieurs buckets Cloud Storage.

Le troisième cas d'utilisation est utile si vous créez une application, telle que Google Drive, qui permet aux utilisateurs de posséder 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 buckets Cloud Storage

Si vous souhaitez utiliser un bucket Cloud Storage autre que celui par défaut fourni ci-dessus ou plusieurs buckets Cloud Storage dans une même application, vous pouvez créer une instance de firebase::storage::Storage qui référence votre bucket personnalisé:

// Get a non-default Cloud Storage bucket
Storage* storage = Storage::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'outil gsutil inclus dans le SDK Google Cloud:

gsutil -m acl ch -r -u service-PROJECT_NUMBER@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://BUCKET_NAME

Vous trouverez votre numéro de projet comme décrit dans la présentation des projets Firebase.

Cela n'affecte pas les buckets nouvellement créés, car le contrôle des 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'un firebase::App personnalisé, vous pouvez créer une instance de firebase::storage::Storage initialisée avec cette application:

// Get the default bucket from a custom firebase::App
Storage* storage = Storage::GetInstance(customApp);

// Get a non-default bucket from a custom firebase::App
Storage* storage = Storage::GetInstance(customApp, "gs://my-custom-bucket");

Étapes suivantes