Flutter云存储管理插件firebase_storage_wrapper的使用

在Flutter开发中，firebase_storage_wrapper 是一个非常实用的插件，用于管理和操作Firebase云存储。通过它，您可以轻松上传、下载、删除文件等。本教程将详细介绍如何使用 firebase_storage_wrapper 插件，并提供完整的代码示例。

开始之前

在开始之前，请确保您已经完成了以下步骤：

1. 配置 Firebase 项目：

   • 创建一个 Firebase 项目并启用 Cloud Storage。
   • 将 Firebase SDK 添加到您的 Flutter 项目中。

2. 安装依赖： 在 pubspec.yaml 文件中添加以下依赖项：

   dependencies:
     firebase_storage: ^10.0.0
     firebase_storage_wrapper: ^0.1.0

3. 初始化 Firebase： 在 main.dart 中初始化 Firebase：

   import 'package:firebase_core/firebase_core.dart';
   
   void main() async {
     WidgetsFlutterBinding.ensureInitialized();
     await Firebase.initializeApp();
     runApp(MyApp());
   }

使用 firebase_storage_wrapper 的基本步骤

1. 导入必要的库

首先，在 Dart 文件中导入所需的库：

import 'package:firebase_storage/firebase_storage.dart';
import 'package:firebase_storage_wrapper/firebase_storage_wrapper.dart';

2. 获取 Firebase 存储实例

使用 FirebaseStorageWrapper 类来获取 Firebase 存储实例：

final storage = FirebaseStorageWrapper(FirebaseStorage.instance);

3. 上传文件

上传文件到 Firebase 存储非常简单。您可以选择上传本地文件或从网络 URL 下载后上传。

上传本地文件

Future<void> uploadFile(String filePath) async {
  try {
    // 获取文件路径
    final file = File(filePath);

    // 上传文件到 Firebase 存储
    final ref = storage.ref().child('files/${file.path.split('/').last}');
    await ref.putFile(file);

    // 获取下载链接
    final url = await ref.getDownloadURL();
    print('文件上传成功，下载链接为: $url');
  } catch (e) {
    print('文件上传失败: $e');
  }
}

上传网络文件

Future<void> uploadNetworkFile(String url) async {
  try {
    // 从网络下载文件并上传到 Firebase 存储
    final response = await http.get(Uri.parse(url));
    final bytes = response.bodyBytes;

    final ref = storage.ref().child('network_files/file.jpg');
    await ref.putData(bytes);

    // 获取下载链接
    final downloadUrl = await ref.getDownloadURL();
    print('网络文件上传成功，下载链接为: $downloadUrl');
  } catch (e) {
    print('网络文件上传失败: $e');
  }
}

4. 下载文件

下载文件也很方便，支持直接下载到本地或获取下载链接。

直接下载到本地

Future<void> downloadFile(String filePath) async {
  try {
    // 获取文件引用
    final ref = storage.ref().child('files/sample.pdf');

    // 下载文件到本地
    final localFile = File(filePath);
    await ref.writeToFile(localFile);

    print('文件下载成功，保存路径为: $filePath');
  } catch (e) {
    print('文件下载失败: $e');
  }
}

获取下载链接

Future<void> getDownloadLink() async {
  try {
    // 获取文件引用
    final ref = storage.ref().child('files/sample.pdf');

    // 获取下载链接
    final url = await ref.getDownloadURL();
    print('文件下载链接为: $url');
  } catch (e) {
    print('获取下载链接失败: $e');
  }
}

5. 删除文件

删除文件也非常简单：

Future<void> deleteFile() async {
  try {
    // 获取文件引用
    final ref = storage.ref().child('files/sample.pdf');

    // 删除文件
    await ref.delete();
    print('文件删除成功');
  } catch (e) {
    print('文件删除失败: $e');
  }
}

完整示例代码

以下是一个完整的示例代码，展示了如何上传、下载和删除文件：

import 'dart:io';
import 'package:flutter/material.dart';
import 'package:http/http.dart' as http;
import 'package:firebase_storage/firebase_storage.dart';
import 'package:firebase_storage_wrapper/firebase_storage_wrapper.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Firebase Storage Example')),
        body: Center(
          child: ElevatedButton(
            onPressed: () async {
              // 上传本地文件
              await uploadFile('/path/to/local/file.pdf');

              // 下载文件到本地
              await downloadFile('/path/to/download/file.pdf');

              // 获取下载链接
              await getDownloadLink();

              // 删除文件
              await deleteFile();
            },
            child: Text('测试 Firebase Storage'),
          ),
        ),
      ),
    );
  }

  Future<void> uploadFile(String filePath) async {
    try {
      final file = File(filePath);
      final ref = storage.ref().child('files/${file.path.split('/').last}');
      await ref.putFile(file);
      final url = await ref.getDownloadURL();
      print('文件上传成功，下载链接为: $url');
    } catch (e) {
      print('文件上传失败: $e');
    }
  }

  Future<void> downloadFile(String filePath) async {
    try {
      final ref = storage.ref().child('files/sample.pdf');
      final localFile = File(filePath);
      await ref.writeToFile(localFile);
      print('文件下载成功，保存路径为: $filePath');
    } catch (e) {
      print('文件下载失败: $e');
    }
  }

  Future<void> getDownloadLink() async {
    try {
      final ref = storage.ref().child('files/sample.pdf');
      final url = await ref.getDownloadURL();
      print('文件下载链接为: $url');
    } catch (e) {
      print('获取下载链接失败: $e');
    }
  }

  Future<void> deleteFile() async {
    try {
      final ref = storage.ref().child('files/sample.pdf');
      await ref.delete();
      print('文件删除成功');
    } catch (e) {
      print('文件删除失败: $e');
    }
  }
}