Flutter本地存储管理插件storage_client的使用

storage_client 是一个用于与Supabase Storage交互的Dart客户端库。它可以帮助开发者轻松地在Flutter应用中实现文件上传、下载和删除等操作。本文将详细介绍如何使用storage_client进行这些操作，并提供完整的示例代码。

文档

• Dart参考文档
• 实时指南

示例代码

以下是一个完整的示例，展示了如何使用storage_client进行文件上传、下载和删除操作。请确保您已经安装了storage_client包，并且已经在Supabase上创建了一个项目并获取了API密钥。

1. 添加依赖

首先，在您的pubspec.yaml文件中添加storage_client依赖：

dependencies:
  flutter:
    sdk: flutter
  storage_client: ^0.2.0

然后运行flutter pub get以安装依赖项。

2. 初始化客户端

在您的Dart文件中导入必要的库，并初始化SupabaseStorageClient：

import 'dart:io';
import 'dart:typed_data';

import 'package:storage_client/storage_client.dart';

void main() async {
  const supabaseUrl = 'https://your-supabase-url.supabase.co'; // 替换为您的Supabase URL
  const supabaseKey = 'your-supabase-key'; // 替换为您的Supabase API密钥
  final client = SupabaseStorageClient(
    '$supabaseUrl/storage/v1',
    {
      'Authorization': 'Bearer $supabaseKey',
    },
  );

  // ...后续操作
}

3. 文件上传

上传二进制文件

您可以将字符串或任何二进制数据上传到Supabase Storage：

// 上传二进制文件
final List<int> listBytes = 'Hello world'.codeUnits;
final Uint8List fileData = Uint8List.fromList(listBytes);
final uploadBinaryResponse = await client.from('public').uploadBinary(
      'binaryExample.txt',
      fileData,
      fileOptions: const FileOptions(upsert: true),
    );
print('upload binary response : $uploadBinaryResponse');

上传文件到指定桶

您还可以上传本地文件到指定的桶（例如public）：

// 上传文件到 bucket "public"
final file = File('example.txt');
file.writeAsStringSync('File content');
final storageResponse =
    await client.from('public').upload('example.txt', file);
print('upload response : $storageResponse');

4. 获取下载链接

通过创建签名URL来获取文件的下载链接：

// 获取下载链接
final urlResponse =
    await client.from('public').createSignedUrl('example.txt', 60); // 60秒有效期
print('download url : $urlResponse');

5. 下载文件

您可以直接从Supabase Storage下载文件内容：

// 下载文本文件
try {
  final fileResponse = await client.from('public').download('example.txt');
  print('downloaded file : ${String.fromCharCodes(fileResponse)}');
} catch (error) {
  print('Error while downloading file : $error');
}

6. 删除文件

最后，您可以删除不再需要的文件：

// 删除文件
final deleteResponse = await client.from('public').remove(['example.txt']);
print('deleted file id : ${deleteResponse.first.id}');

7. 清理本地文件

如果您在本地创建了临时文件，请记得在操作完成后清理它们：

// 清理本地文件
if (file.existsSync()) file.deleteSync();

完整示例代码

以下是完整的示例代码，包含了所有上述操作：

// ignore_for_file: avoid_print

import 'dart:io';
import 'dart:typed_data';

import 'package:storage_client/storage_client.dart';

Future<void> main() async {
  const supabaseUrl = 'https://your-supabase-url.supabase.co'; // 替换为您的Supabase URL
  const supabaseKey = 'your-supabase-key'; // 替换为您的Supabase API密钥
  final client = SupabaseStorageClient(
    '$supabaseUrl/storage/v1',
    {
      'Authorization': 'Bearer $supabaseKey',
    },
  );

  // 上传二进制文件
  final List<int> listBytes = 'Hello world'.codeUnits;
  final Uint8List fileData = Uint8List.fromList(listBytes);
  final uploadBinaryResponse = await client.from('public').uploadBinary(
        'binaryExample.txt',
        fileData,
        fileOptions: const FileOptions(upsert: true),
      );
  print('upload binary response : $uploadBinaryResponse');

  // 上传文件到 bucket "public"
  final file = File('example.txt');
  file.writeAsStringSync('File content');
  final storageResponse =
      await client.from('public').upload('example.txt', file);
  print('upload response : $storageResponse');

  // 获取下载链接
  final urlResponse =
      await client.from('public').createSignedUrl('example.txt', 60);
  print('download url : $urlResponse');

  // 下载文本文件
  try {
    final fileResponse = await client.from('public').download('example.txt');
    print('downloaded file : ${String.fromCharCodes(fileResponse)}');
  } catch (error) {
    print('Error while downloading file : $error');
  }

  // 删除文件
  final deleteResponse = await client.from('public').remove(['example.txt']);
  print('deleted file id : ${deleteResponse.first.id}');

  // 清理本地文件
  if (file.existsSync()) file.deleteSync();
}

通过以上步骤，您可以在Flutter应用中轻松地使用storage_client插件进行文件的上传、下载和删除操作。希望这对您有所帮助！