Flutter阿里云OSS存储插件bm_aliyun_oss的使用

bm_aliyun_oss 是一个用于在 Flutter 应用中集成阿里云 OSS 存储功能的插件。通过此插件，开发者可以轻松实现文件上传、下载、删除等操作。

开始使用

项目简介

本项目是一个 Flutter 插件包，包含针对 Android 和/或 iOS 平台的特定实现代码。它允许开发者在 Flutter 应用中访问阿里云 OSS 的功能。

对于如何开始使用 Flutter，您可以参考 Flutter 官方文档，其中提供了教程、示例代码、移动开发指南以及完整的 API 参考。

示例代码

以下是一个简单的示例，展示如何在 Flutter 中初始化并使用 bm_aliyun_oss 插件。

示例代码

import 'package:flutter/material.dart';
import 'dart:async';

import 'package:flutter/services.dart';
import 'package:bm_aliyun_oss/bm_aliyun_oss.dart'; // 导入 bm_aliyun_oss 插件

void main() {
  runApp(const MyApp()); // 启动应用
}

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  State<MyApp> createState() => _MyAppState(); // 初始化状态
}

class _MyAppState extends State<MyApp> {
  String _platformVersion = 'Unknown'; // 平台版本信息

  @override
  void initState() {
    super.initState();

    // 初始化插件时获取平台版本信息
    initPlatformState();
  }

  Future<void> initPlatformState() async {
    String platformVersion;
    try {
      platformVersion = await BmAliyunOss.platformVersion; // 获取插件版本
    } on PlatformException {
      platformVersion = 'Failed to get platform version.';
    }

    setState(() {
      _platformVersion = platformVersion; // 更新 UI
    });
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('BM Aliyun OSS 示例'), // 设置标题
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
            Text('运行环境: $_platformVersion\n'), // 显示平台版本
            ElevatedButton(
              onPressed: () {
                // 点击按钮执行上传操作
                uploadFileToOSS();
              },
              child: Text('上传文件到 OSS'), // 按钮文本
            ),
          ],
        ),
      ),
    );
  }

  Future<void> uploadFileToOSS() async {
    try {
      // 调用插件方法上传文件
      String result = await BmAliyunOss.uploadFile(
        ossAccessKeyId: 'your_access_key_id', // 替换为您的 Access Key ID
        ossAccessKeySecret: 'your_access_key_secret', // 替换为您的 Access Key Secret
        ossBucketName: 'your_bucket_name', // 替换为您的 Bucket 名称
        ossEndpoint: 'your_endpoint', // 替换为您的 OSS Endpoint
        localFilePath: '/path/to/local/file', // 替换为本地文件路径
        objectName: 'your_object_name', // 替换为您希望存储的对象名称
      );

      print('上传结果: $result'); // 打印上传结果
    } catch (e) {
      print('上传失败: $e'); // 打印错误信息
    }
  }
}

代码说明

1. 导入插件：

   import 'package:bm_aliyun_oss/bm_aliyun_oss.dart';
   

   导入 bm_aliyun_oss 插件以使用其功能。

2. 初始化插件： 在 initState 方法中调用 initPlatformState，用于获取插件版本信息。

   Future<void> initPlatformState() async {
     String platformVersion;
     try {
       platformVersion = await BmAliyunOss.platformVersion;
     } on PlatformException {
       platformVersion = 'Failed to get platform version.';
     }
   
     setState(() {
       _platformVersion = platformVersion;
     });
   }
   

3. 上传文件到 OSS： 使用 BmAliyunOss.uploadFile 方法上传文件到阿里云 OSS。

   Future<void> uploadFileToOSS() async {
     try {
       String result = await BmAliyunOss.uploadFile(
         ossAccessKeyId: 'your_access_key_id',
         ossAccessKeySecret: 'your_access_key_secret',
         ossBucketName: 'your_bucket_name',
         ossEndpoint: 'your_endpoint',
         localFilePath: '/path/to/local/file',
         objectName: 'your_object_name',
       );
   
       print('上传结果: $result');
     } catch (e) {
       print('上传失败: $e');
     }
   }