Облачное хранилище для Firebase позволяет загружать и делиться созданным пользователями контентом, таким как изображения и видео, что позволяет встраивать мультимедийный контент в ваши приложения. Ваши данные хранятся в корзине Google Cloud Storage — объектном хранилище эксабайтного масштаба с высокой доступностью и глобальной избыточностью. Облачное хранилище для Firebase позволяет безопасно загружать эти файлы непосредственно с мобильных устройств и веб-браузеров, с легкостью обрабатывая нестабильные сети.
Предпосылки
Если вы еще этого не сделали, добавьте Firebase в свой проект Android .
Создание корзины Cloud Storage по умолчанию
На панели навигации консоли Firebase выберите «Хранилище» , затем нажмите «Начать» .
Ознакомьтесь с сообщениями о защите ваших данных в облачном хранилище с помощью правил безопасности. Во время разработки подумайте о настройке правил для общего доступа .
Выберите расположение для корзины Cloud Storage по умолчанию.
Этот параметр местоположения является расположением ресурса Google Cloud Platform (GCP) по умолчанию для вашего проекта . Обратите внимание, что это местоположение будет использоваться для сервисов GCP в вашем проекте, для которых требуется настройка местоположения, в частности, для вашей базы данных Cloud Firestore и вашего приложения App Engine (что требуется, если вы используете Cloud Scheduler).
Если вы не можете выбрать местоположение, значит, в вашем проекте уже есть местоположение ресурса GCP по умолчанию. Он был установлен либо при создании проекта, либо при настройке другого сервиса, требующего настройки местоположения.
Если вы пользуетесь тарифным планом Blaze, вы можете создать несколько сегментов , каждый из которых будет иметь собственное местоположение .
Щелкните Готово .
Настроить публичный доступ
Облачное хранилище для Firebase предоставляет язык декларативных правил, который позволяет вам определять, как ваши данные должны быть структурированы, как они должны индексироваться и когда ваши данные могут быть прочитаны и записаны. По умолчанию доступ к облачному хранилищу для чтения и записи ограничен, поэтому только пользователи, прошедшие проверку подлинности, могут читать или записывать данные. Чтобы начать работу без настройки аутентификации , вы можете настроить свои правила для общего доступа .
Это делает облачное хранилище открытым для всех, даже для людей, не использующих ваше приложение, поэтому не забудьте снова ограничить свое облачное хранилище при настройке аутентификации.
Добавьте SDK Cloud Storage в свое приложение.
В файл Gradle вашего модуля (на уровне приложения) (обычно<project>/<app-module>/build.gradle.kts или <project>/<app-module>/build.gradle ) добавьте зависимость для облачного хранилища Android-библиотека. Мы рекомендуем использовать Firebase Android BoM для управления версиями библиотеки. Kotlin+KTX
dependencies {
// Import the BoM for the Firebase platform
implementation(platform("com.google.firebase:firebase-bom:32.3.1"))
// 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-ktx")
}
Используя Firebase Android BoM , ваше приложение всегда будет использовать совместимые версии библиотек Firebase Android.
(Альтернатива) Добавить зависимости библиотеки Firebase без использования BoM
Если вы решите не использовать Firebase BoM, вы должны указать каждую версию библиотеки Firebase в строке зависимостей.
Обратите внимание: если вы используете несколько библиотек Firebase в своем приложении, мы настоятельно рекомендуем использовать BoM для управления версиями библиотек, что гарантирует совместимость всех версий.
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-ktx:20.2.1")
}
Java
dependencies {
// Import the BoM for the Firebase platform
implementation(platform("com.google.firebase:firebase-bom:32.3.1"))
// 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")
}
Используя Firebase Android BoM , ваше приложение всегда будет использовать совместимые версии библиотек Firebase Android.
(Альтернатива) Добавить зависимости библиотеки Firebase без использования BoM
Если вы решите не использовать Firebase BoM, вы должны указать каждую версию библиотеки Firebase в строке зависимостей.
Обратите внимание: если вы используете несколько библиотек Firebase в своем приложении, мы настоятельно рекомендуем использовать BoM для управления версиями библиотек, что гарантирует совместимость всех версий.
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:20.2.1")
}
Настроить облачное хранилище
Первым шагом в доступе к вашей корзине Cloud Storage является создание экземпляра FirebaseStorage :
Kotlin+KTX
storage = Firebase.storage
Java
FirebaseStorage storage = FirebaseStorage.getInstance();
Вы готовы начать использовать облачное хранилище!
Во-первых, давайте узнаем, как создать ссылку на облачное хранилище .
Advanced Setup
Есть несколько вариантов использования, которые требуют дополнительной настройки:
- Использование сегментов Cloud Storage в нескольких географических регионах
- Использование сегментов Cloud Storage в разных классах хранилищ
- Использование сегментов Cloud Storage с несколькими пользователями, прошедшими проверку подлинности, в одном приложении
Первый вариант использования идеален, если у вас есть пользователи по всему миру и вы хотите хранить их данные рядом с ними. Например, вы можете создавать корзины в США, Европе и Азии для хранения данных для пользователей в этих регионах, чтобы уменьшить задержку.
Второй вариант использования полезен, если у вас есть данные с разными шаблонами доступа. Например: вы можете настроить многорегиональную или региональную корзину, в которой хранятся изображения или другое часто используемое содержимое, а также корзину ближней или холодной линии, в которой хранятся резервные копии пользователей или другое редко используемое содержимое.
В любом из этих вариантов использования вам понадобится несколько сегментов Cloud Storage .
Третий вариант использования полезен, если вы создаете приложение, такое как Google Диск, которое позволяет пользователям иметь несколько учетных записей (например, личную учетную запись и рабочую учетную запись). Вы можете использовать собственный экземпляр приложения Firebase для аутентификации каждой дополнительной учетной записи.
Используйте несколько сегментов облачного хранилища
Если вы хотите использовать ведро облачного хранилища, отличное от указанного выше по умолчанию, или использовать несколько ведер облачного хранилища в одном приложении, вы можете создать экземпляр FirebaseStorage , который ссылается на ваше пользовательское ведро:
Kotlin+KTX
// 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");Работа с импортированными сегментами
При импорте существующей корзины Cloud Storage в Firebase вам нужно будет предоставить Firebase возможность доступа к этим файлам с помощью инструмента gsutil , включенного в Google Cloud SDK :
gsutil -m acl ch -r -u service-<project number>@gcp-sa-firebasestorage.iam.gserviceaccount.com gs://<your-cloud-storage-bucket>
Вы можете найти номер своего проекта, как описано во введении к проектам Firebase .
Это не влияет на вновь созданные сегменты, так как для них установлен контроль доступа по умолчанию, разрешающий использование Firebase. Это временная мера, и в будущем она будет выполняться автоматически.
Используйте собственное приложение Firebase
Если вы создаете более сложное приложение с использованием пользовательского FirebaseApp , вы можете создать экземпляр FirebaseStorage , инициализированный этим приложением:
Kotlin+KTX
// 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");
Следующие шаги
Подготовьтесь к запуску вашего приложения:
Включите проверку приложений , чтобы убедиться, что только ваши приложения могут получить доступ к сегментам хранилища.
Настройте оповещения о бюджете для своего проекта в Google Cloud Console.
Следите за панелью управления «Использование и выставление счетов» в консоли Firebase, чтобы получить общую картину использования вашего проекта в нескольких сервисах Firebase. Вы также можете посетить панель управления Cloud Storage Usage для получения более подробной информации об использовании.
Ознакомьтесь с контрольным списком запуска Firebase .