Cloud Storage 使用入门 (C++)

使用 Cloud Storage for Firebase，您可以上传和共享用户生成的内容（如图片和视频），以便将富媒体内容融入您的应用。您的数据存储在 Google Cloud Storage 存储桶中，这是一个 EB 级对象存储解决方案，具备高可用性和全局冗余性。借助 Cloud Storage for Firebase，您可以直接从移动设备和网络浏览器安全地上传这些文件，轻松应对质量不稳定的网络。

准备工作

在使用 Cloud Storage 之前，您需要：

  • 注册 C++ 项目并将其配置为使用 Firebase。

    如果您的 C++ 项目已在使用 Firebase，那么该项目已经注册并已配置为使用 Firebase。

  • 将 Firebase C++ SDK 添加到您的 C++ 项目。

请注意，将 Firebase 添加到 C++ 项目需要在 Firebase 控制台中和打开的 C++ 项目中执行若干任务（例如，从控制台下载 Firebase 配置文件，然后将配置文件移动到 C++ 项目中）。

创建默认的 Cloud Storage 存储桶

  1. 在 Firebase 控制台的导航窗格中，选择 Storage，然后点击开始使用。

  2. 查看有关使用安全规则保护 Cloud Storage 数据的消息。在开发过程中，请考虑设置公开访问规则。

  3. 选择一个位置作为您的默认 Cloud Storage 存储桶。

    • 此位置设置是您项目的默认 Google Cloud Platform (GCP) 资源位置。请注意，此位置将用于项目中需要位置设置的多项 GCP 服务，具体包括 Cloud Firestore 数据库和 App Engine 应用（如果您使用 Cloud Scheduler，则需要该应用）。

    • 如果您无法选择位置，表明您的项目已经具有默认 GCP 资源位置。它可能是在项目创建期间设置的，也可能是在设置需要位置设置的其他服务时指定的。

    如果您使用的是 Blaze 方案，则可以创建多个存储桶，每个存储桶都有自己的位置。

  4. 点击完成。

设置公开访问权限

Cloud Storage for Firebase 提供了声明式规则语言，可用于定义数据的结构、将数据编入索引的方式，以及何时可以在其中读取和写入数据。默认情况下，对 Cloud Storage 的读写权限是受限的，只有通过身份验证的用户才能读写数据。如需在未设置 Authentication 的情况下开始使用数据库，您可以将您的规则配置为允许公开访问。

这会使得 Cloud Storage 向所有人开放，包括不使用您的应用的用户，因此在设置身份验证时，请务必重新限制对 Cloud Storage 的访问。

创建并初始化 firebase::App

您需要先创建并初始化 firebase::App，然后才能访问 Cloud Storage。

包含 firebase::App 的头文件：

#include "firebase/app.h"

Android

创建 firebase::App，将 JNI 环境和 jobject 引用以参数形式传递到 Java Activity：

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

iOS+

创建 firebase::App：

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

访问 firebase::storage::Storage 类

firebase::storage::Storage 类是 Cloud Storage C++ SDK 的入口点。

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

现在可以开始使用 Cloud Storage 了！

首先，我们来了解如何创建 Cloud Storage 引用。

高级设置

以下几种使用情形需要进行额外的设置：

  • 使用多个地理区域中的 Cloud Storage 存储桶
  • 使用不同存储类别的 Cloud Storage 存储桶
  • 同一个应用中有多个经过身份验证的用户使用 Cloud Storage 存储桶

如果您的用户遍布世界各地，并且您希望将他们的数据存储在各自所在地附近，则非常符合第一种使用情形。例如，您可以在美国、欧洲和亚洲分别创建存储桶，为这些区域的用户存储数据，以减少延迟时间。

如果您的数据有多种不同的访问模式，则符合第二种使用情形。 例如，您可以设置一个多地区或单地区存储分区来存储照片或其他经常访问的内容，并设置一个 Nearline 或 Coldline 存储分区以存储用户备份或其他不常访问的内容。

在这两种使用情形下，您都需要使用多个 Cloud Storage 存储桶。

如果您要构建一个允许用户登录多个账号（例如，一个个人账号和一个工作账号）的应用（例如 Google 云端硬盘），则适合第三种使用情形。您可以使用自定义 Firebase 应用实例来对每个额外的账号进行身份验证。

使用多个 Cloud Storage 存储桶

如果需要使用上文所述的默认存储桶以外的 Cloud Storage 存储桶，或在单个应用中使用多个 Cloud Storage 存储桶，则可以创建一个引用您的自定义存储桶的 firebase::storage::Storage 实例：

// Get a non-default Cloud Storage bucket
Storage* storage = Storage::GetInstance("gs://my-custom-bucket");

使用导入的存储桶

将现有 Cloud Storage 存储桶导入 Firebase 时，您必须使用 Google Cloud SDK 中包含的 gsutil 工具向 Firebase 授予访问这些文件的权限：

gsutil -m acl ch -r -u service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://<your-cloud-storage-bucket>

您可以按 Firebase 项目简介中介绍的方法找到项目编号。

这不会影响新建的存储桶，因为其默认已设置为允许 Firebase 访问。这是一个临时的解决方法，将来不需要再手动执行。

使用自定义 Firebase 应用

如果您要使用自定义 firebase::App 构建更复杂的应用，可以创建使用该应用初始化的 firebase::storage::Storage 实例：

// 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");

后续步骤