Flutter AWS S3存储插件aws_s3_storage的使用

aws_s3_storage 是一个简单且方便的 Flutter 插件，用于将文件上传到 AWS S3 存储。它受到 Stack Overflow 上的回答 的启发。

动机/免责声明

已经存在许多与 S3 交互的 Flutter 插件，其中一些维护得更好。这个小库之所以被创建，是因为我尝试过的少数插件要么无法正常工作，要么需要使用 Pool ID 和 AWS Cognito，而我的项目并不使用这些功能。具体情况可能因项目而异（YMMV）。

开始使用

在 AWS 上创建凭证后，可以使用以下方式上传文件：

import 'package:path_provider/path_provider.dart'; // 用于获取文件路径
import 'package:file/file.dart'; // 文件操作
import 'package:aws_s3_storage/aws_s3_storage.dart'; // 导入 aws_s3_storage 插件

void uploadFileToS3() async {
  // 获取临时目录
  final directory = await getTemporaryDirectory();
  
  // 创建一个测试文件
  final filePath = '${directory.path}/test.txt';
  final file = File(filePath);
  await file.writeAsString('Hello, AWS S3!');

  // 使用 AwsS3.uploadFile 方法上传文件
  try {
    await AwsS3.uploadFile(
      accessKey: "AKxxxxxxxxxxxxx", // AWS 访问密钥
      secretKey: "xxxxxxxxxxxxxxxxxxxxxxxxxx", // AWS 秘密访问密钥
      file: file, // 要上传的文件
      bucket: "bucket_name", // S3 存储桶名称
      region: "us-east-2" // S3 区域
    );
    print("文件上传成功！");
  } catch (e) {
    print("文件上传失败: $e");
  }
}

完整示例代码

以下是一个完整的示例代码，展示了如何使用 aws_s3_storage 插件上传文件到 AWS S3：

import 'package:flutter/material.dart';
import 'package:path_provider/path_provider.dart'; // 用于获取文件路径
import 'package:file/file.dart'; // 文件操作
import 'package:aws_s3_storage/aws_s3_storage.dart'; // 导入 aws_s3_storage 插件

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('AWS S3 文件上传示例'),
        ),
        body: Center(
          child: ElevatedButton(
            onPressed: () {
              uploadFileToS3();
            },
            child: Text('上传文件到 S3'),
          ),
        ),
      ),
    );
  }
}

void uploadFileToS3() async {
  // 获取临时目录
  final directory = await getTemporaryDirectory();
  
  // 创建一个测试文件
  final filePath = '${directory.path}/test.txt';
  final file = File(filePath);
  await file.writeAsString('Hello, AWS S3!');

  // 使用 AwsS3.uploadFile 方法上传文件
  try {
    await AwsS3.uploadFile(
      accessKey: "AKxxxxxxxxxxxxx", // AWS 访问密钥
      secretKey: "xxxxxxxxxxxxxxxxxxxxxxxxxx", // AWS 秘密访问密钥
      file: file, // 要上传的文件
      bucket: "bucket_name", // S3 存储桶名称
      region: "us-east-2" // S3 区域
    );
    print("文件上传成功！");
  } catch (e) {
    print("文件上传失败: $e");
  }
}