Начало работы с Cloud Storage для C++

Cloud Storage for Firebase позволяет загружать и делиться пользовательским контентом, таким как изображения и видео, что позволяет встраивать мультимедийный контент в ваши приложения. Ваши данные хранятся в контейнере Google Cloud Storage — решении для хранения объектов эксабайтного масштаба с высокой доступностью и глобальной избыточностью. Cloud Storage for Firebase позволяет безопасно загружать эти файлы непосредственно с мобильных устройств и веб-браузеров, легко справляясь с нестабильной работой сетей.

Прежде чем начать

Прежде чем вы сможете использовать Cloud Storage , вам необходимо:

  • Зарегистрируйте свой проект C++ и настройте его для использования Firebase.

    Если ваш проект C++ уже использует Firebase, значит, он уже зарегистрирован и настроен для Firebase.

  • Добавьте Firebase C++ SDK в свой проект C++.

Обратите внимание, что добавление Firebase в ваш проект C++ включает в себя задачи как в консоли Firebase , так и в вашем открытом проекте C++ (например, вы загружаете файлы конфигурации Firebase из консоли, а затем перемещаете их в свой проект C++).

Также убедитесь, что ваш проект Firebase включен в тарифный план Blaze с оплатой по факту использования . Если вы новичок в Firebase и Google Cloud, проверьте, можете ли вы получить кредит в размере 300 долларов США .

Создайте контейнер Cloud Storage по умолчанию

  1. На панели навигации консоли Firebase выберите Хранилище .

    Если ваш проект еще не включен в тарифный план Blaze с оплатой по факту использования, вам будет предложено обновить его.

  2. Нажмите « Начать» .

  3. Выберите местоположение для контейнера по умолчанию.

  4. Настройте Firebase Security Rules для контейнера по умолчанию. В процессе разработки рассмотрите возможность настройки правил для публичного доступа .

  5. Нажмите Готово .

Теперь вы можете просмотреть контейнер на вкладке « Файлы Cloud Storage » консоли Firebase . Формат имени контейнера по умолчанию: PROJECT_ID .firebasestorage.app .

Настроить публичный доступ

Cloud Storage for Firebase предоставляет язык декларативных правил, позволяющий определить, как должны быть структурированы данные, как они должны индексироваться, а также когда данные могут быть прочитаны и записаны. По умолчанию доступ к чтению и записи в Cloud Storage ограничен, поэтому читать и записывать данные могут только аутентифицированные пользователи. Чтобы начать работу без настройки Authentication , вы можете настроить правила для публичного доступа .

Это делает Cloud Storage открытым для всех, даже для людей, не использующих ваше приложение, поэтому не забудьте снова ограничить свое Cloud Storage при настройке аутентификации.

Создать и инициализировать firebase::App

Прежде чем получить доступ к Cloud Storage , вам необходимо создать и инициализировать firebase::App .

Включите заголовочный файл для firebase::App :

#include "firebase/app.h"

Андроид

Создайте 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 .

Третий вариант использования полезен, если вы разрабатываете приложение, например, Google Диск, которое позволяет пользователям иметь несколько учётных записей (например, личную и рабочую). Вы можете использовать отдельный экземпляр Firebase App для аутентификации каждой дополнительной учётной записи.

Используйте несколько контейнеров 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 вам потребуется предоставить Firebase возможность доступа к этим файлам с помощью инструмента gsutil , входящего в состав Google Cloud SDK :

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

Номер вашего проекта можно найти, как описано во введении к проектам 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");

Следующие шаги