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

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

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

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

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

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

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

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

   Kotlin+KTX

   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 с несколькими аутентифицированными пользователями в одном приложении.

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

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

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

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

Используйте несколько сегментов 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 .