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

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

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

1. Если вы еще этого не сделали, обязательно пройдите руководство по началу работы с приложениями Flutter . Оно включает в себя:

   • Создание проекта Firebase.

   • Установка и инициализация SDK Firebase для Flutter.

2. Убедитесь, что ваш проект Firebase использует тарифный план Blaze с оплатой по мере использования , это требование вступило в силу в октябре 2024 года (см. наши часто задаваемые вопросы ). Если вы новичок в Firebase и Google Cloud, проверьте, имеете ли вы право на кредит в размере 300 долларов .

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

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

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

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

3. Выберите местоположение для вашего хранилища по умолчанию.

   • Ведра в US-CENTRAL1 , US-EAST1 и Жители региона US-WEST1 могут воспользоваться тарифным планом Google Cloud Storage "Всегда бесплатно" . Для всех остальных регионов действуют тарифные планы и правила использования Google Cloud Storage .

   • При желании вы можете позже создать несколько хранилищ , каждое со своим собственным местоположением.

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

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

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

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

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

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

Добавьте SDK облачного хранилища в свое приложение.

1. Для установки плагина выполните следующую команду из корневой папки вашего Flutter-проекта:

   flutter pub add firebase_storage
   

2. После завершения пересоберите ваше Flutter-приложение:

   flutter run
   

3. Импортируйте плагин в свой код Dart:

   import 'package:firebase_storage/firebase_storage.dart';
   

Настройка облачного хранилища

1. Запустите flutterfire configure из каталога вашего проекта Flutter. Это обновит файл конфигурации Firebase ( firebase_options.dart ) в коде вашего приложения, присвоив ему имя вашего хранилища Cloud Storage по умолчанию.

2. Для доступа к вашему облачному хранилищу создайте экземпляр FirebaseStorage :

   final storage = FirebaseStorage.instance;
   
   // Alternatively, explicitly specify the bucket name URL.
   // final storage = FirebaseStorage.instanceFor(bucket: "gs://<var>BUCKET_NAME</var>");
   

Вы готовы начать использовать облачное хранилище!

Следующий шаг? Узнайте, как создать справочный файл для облачного хранилища .

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

В некоторых случаях может потребоваться дополнительная настройка:

• Использование сегментов облачного хранилища в нескольких географических регионах.
• Использование сегментов облачного хранилища в различных классах хранения.
• Использование облачных хранилищ с несколькими авторизованными пользователями в одном приложении.

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

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

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

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

Используйте несколько сегментов облачного хранилища.

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

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

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

// Use a non-default App
final storage = FirebaseStorage.instanceFor(app: customApp);