Загрузка файлов с помощью Cloud Storage на Flutter

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

Создать ссылку

Для загрузки файла сначала создайте ссылку на файл в Cloud Storage .

Вы можете создать ссылку, добавив дочерние пути к корню вашего сегмента Cloud Storage, или же вы можете создать ссылку на основе существующего URL-адреса gs:// или https:// ссылающегося на объект в Cloud Storage.

// Create a storage reference from our app
final storageRef = FirebaseStorage.instance.ref();

// Create a reference with an initial file path and name
final pathReference = storageRef.child("images/stars.jpg");

// Create a reference to a file from a Google Cloud Storage URI
final gsReference =
    FirebaseStorage.instance.refFromURL("gs://YOUR_BUCKET/images/stars.jpg");

// Create a reference from an HTTPS URL
// Note that in the URL, characters are URL escaped!
final httpsReference = FirebaseStorage.instance.refFromURL(
    "https://firebasestorage.googleapis.com/b/YOUR_BUCKET/o/images%20stars.jpg");

Скачать файлы

Получив ссылку, вы можете загрузить файлы из облачного хранилища, вызвав метод getData() . Если вы предпочитаете загружать файл с помощью другой библиотеки, вы можете получить URL-адрес для загрузки с помощью getDownloadUrl() .

Загрузка в память

Загрузите файл в UInt8List с помощью метода getData() . Это самый простой способ загрузки файла, но он должен загрузить в память всё его содержимое. Если вы запросите файл размером больше, чем доступная вашему приложению память, приложение завершится с ошибкой. Для защиты от проблем с памятью getData() устанавливает максимальный размер загружаемого файла. Установите максимальный размер на значение, которое, как вы знаете, может обработать ваше приложение, или используйте другой метод загрузки.

final islandRef = storageRef.child("images/island.jpg");

try {
  const oneMegabyte = 1024 * 1024;
  final Uint8List? data = await islandRef.getData(oneMegabyte);
  // Data for "images/island.jpg" is returned, use this as needed.
} on FirebaseException catch (e) {
  // Handle any errors.
}

Скачать в локальный файл

Метод writeToFile() загружает файл непосредственно на локальное устройство. Используйте его, если ваши пользователи хотят иметь доступ к файлу в автономном режиме или для обмена файлом в другом приложении. writeToFile() возвращает объект DownloadTask , который можно использовать для управления загрузкой и отслеживания ее статуса.

final islandRef = storageRef.child("images/island.jpg");

final appDocDir = await getApplicationDocumentsDirectory();
final filePath = "${appDocDir.absolute}/images/island.jpg";
final file = File(filePath);

final downloadTask = islandRef.writeToFile(file);
downloadTask.snapshotEvents.listen((taskSnapshot) {
  switch (taskSnapshot.state) {
    case TaskState.running:
      // TODO: Handle this case.
      break;
    case TaskState.paused:
      // TODO: Handle this case.
      break;
    case TaskState.success:
      // TODO: Handle this case.
      break;
    case TaskState.canceled:
      // TODO: Handle this case.
      break;
    case TaskState.error:
      // TODO: Handle this case.
      break;
  }
});

Скачать данные по URL

Если у вас уже есть инфраструктура для загрузки файлов на основе URL-адресов или вы просто хотите поделиться URL-адресом, вы можете получить URL-адрес для загрузки файла, вызвав метод getDownloadURL() в ссылке на Cloud Storage.

final imageUrl =
    await storageRef.child("users/me/profile.png").getDownloadURL();

Обработка ошибок

При загрузке могут возникать ошибки по ряду причин, включая отсутствие файла или отсутствие у пользователя прав доступа к нужному файлу. Более подробную информацию об ошибках можно найти в разделе «Обработка ошибок» документации.

Полный пример

Полный пример загрузки с обработкой ошибок показан ниже:

final islandRef = storageRef.child("images/island.jpg");

final appDocDir = await getApplicationDocumentsDirectory();
final filePath = "${appDocDir.absolute}/images/island.jpg";
final file = File(filePath);

final downloadTask = islandRef.writeToFile(file);
downloadTask.snapshotEvents.listen((taskSnapshot) {
  switch (taskSnapshot.state) {
    case TaskState.running:
      // TODO: Handle this case.
      break;
    case TaskState.paused:
      // TODO: Handle this case.
      break;
    case TaskState.success:
      // TODO: Handle this case.
      break;
    case TaskState.canceled:
      // TODO: Handle this case.
      break;
    case TaskState.error:
      // TODO: Handle this case.
      break;
  }
});

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