Начало работы с облачным хранилищем на Android

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.14.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")
}

Благодаря использованию Firebase Android BoM ваше приложение всегда будет использовать совместимые версии библиотек Firebase Android.

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:21.0.2")
}

Настройте Cloud Storage в своем приложении

1. Убедитесь, что файл конфигурации Firebase ( google-services.json ) в кодовой базе вашего приложения обновлен с использованием имени вашего контейнера Cloud Storage по умолчанию.

   1. Получите обновленный файл конфигурации.

   2. Используйте этот загруженный файл конфигурации для замены существующего файла google-services.json в каталоге модуля вашего приложения (уровня приложения).

      Убедитесь, что в вашем приложении есть только последний загруженный файл конфигурации и что к его имени не добавлены дополнительные символы, например (2) .

2. Получите доступ к своему хранилищу Cloud Storage , создав экземпляр FirebaseStorage :

   Kotlin

   storage = Firebase.storage
   StorageActivity.kt

   // Alternatively, explicitly specify the bucket name URL.
   // val storage = Firebase.storage("gs://BUCKET_NAME")

   Java

   FirebaseStorage storage = FirebaseStorage.getInstance();
   StorageActivity.java

   // Alternatively, explicitly specify the bucket name URL.
   // FirebaseStorage storage = FirebaseStorage.getInstance("gs://BUCKET_NAME");

Вы готовы начать использовать Cloud Storage !

Следующий шаг? Узнайте, как создать ссылку на Cloud Storage .

Расширенная настройка

Есть несколько вариантов использования, требующих дополнительной настройки:

• Использование Cloud Storage в нескольких географических регионах
• Использование контейнеров Cloud Storage в разных классах хранения
• Использование Cloud Storage с несколькими аутентифицированными пользователями в одном приложении

Первый вариант использования идеален, если у вас есть пользователи по всему миру, и вы хотите хранить их данные рядом с ними. Например, вы можете создать контейнеры в США, Европе и Азии для хранения данных пользователей в этих регионах, чтобы сократить задержку.

Второй вариант использования полезен, если у вас есть данные с разными шаблонами доступа. Например: вы можете настроить мультирегиональный или региональный контейнер, который хранит изображения или другой часто используемый контент, и nearline или coldline контейнер, который хранит резервные копии пользователей или другой редко используемый контент.

В любом из этих случаев вам понадобится использовать несколько контейнеров Cloud Storage .

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

Используйте несколько Cloud Storage

Если вы хотите использовать контейнер Cloud Storage отличный от контейнера по умолчанию, описанного ранее в этом руководстве, или использовать несколько контейнеров Cloud Storage в одном приложении, вы можете создать экземпляр FirebaseStorage , который ссылается на ваш пользовательский контейнер:

// Get a non-default Storage bucket
val storage = Firebase.storage("gs://my-custom-bucket")
StorageActivity.kt

// Get a non-default Storage bucket
FirebaseStorage storage = FirebaseStorage.getInstance("gs://my-custom-bucket");
StorageActivity.java

Работа с импортными ковшами

При импорте существующего контейнера 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

Если вы создаете более сложное приложение с использованием пользовательского FirebaseApp , вы можете создать экземпляр FirebaseStorage , инициализированный с этим приложением:

// 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")
StorageActivity.kt

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

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

• Подготовьтесь к запуску вашего приложения:

  • Включите App Check , чтобы гарантировать, что доступ к вашим хранилищам смогут получить только ваши приложения.

  • Настройте оповещения о бюджете для вашего проекта в консоли Google Cloud .

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

  • Ознакомьтесь с контрольным списком запуска Firebase .