Flutter阿里云签名服务插件aliyun_sign的使用

Flutter 阿里云签名服务插件 aliyun_sign 的使用

快速通过 Query Map 获得多数阿里云 SDK 通用的签名。

使用方法

传入服务所需的 Access Key Secret 及所有参数，可选 GET 或 POST 方式。

// 获取签名
final String signature = AliyunSign.signFromQueries(
  accessKeySecret: 'my_access_key_secret',
  queries: <String, String>{
    'AccessKeyId': 'my_access_key_id',
    'Action': 'CreateToken',
    'Format': 'JSON',
    'RegionId': 'cn-shanghai',
    'SignatureMethod': 'HMAC-SHA1',
    'SignatureNonce': 'b924c8c3-6d03-4c5d-ad36-d984d3116788', // 通常使用 Uuid().v4
    'SignatureVersion': '1.0',
    'Timestamp': '2019-04-18T08:32:31Z', // 通常使用 DateTime.now().toUtc().toIso8601String()
    'Version': '2019-02-28',
  },
  method: 'POST', // 默认为 GET
);

完整示例 Demo

以下是一个完整的 Flutter 应用程序示例，展示如何使用 aliyun_sign 插件来生成阿里云签名。

步骤 1: 添加依赖

在 pubspec.yaml 文件中添加 aliyun_sign 依赖：

dependencies:
  flutter:
    sdk: flutter
  aliyun_sign: ^1.0.0 # 请根据实际情况选择正确的版本

步骤 2: 创建签名工具类

创建一个工具类用于生成阿里云签名。

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

class AliyunSignService {
  static Future<String> getSignature() async {
    final String signature = AliyunSign.signFromQueries(
      accessKeySecret: 'my_access_key_secret',
      queries: <String, String>{
        'AccessKeyId': 'my_access_key_id',
        'Action': 'CreateToken',
        'Format': 'JSON',
        'RegionId': 'cn-shanghai',
        'SignatureMethod': 'HMAC-SHA1',
        'SignatureNonce': 'b924c8c3-6d03-4c5d-ad36-d984d3116788', // 通常使用 Uuid().v4
        'SignatureVersion': '1.0',
        'Timestamp': '2019-04-18T08:32:31Z', // 通常使用 DateTime.now().toUtc().toIso8601String()
        'Version': '2019-02-28',
      },
      method: 'POST', // 默认为 GET
    );
    return signature;
  }
}

步骤 3: 在应用中调用签名生成方法

在 Flutter 应用程序中调用签名生成方法，并将签名添加到请求中。

import 'package:flutter/material.dart';
import 'aliyun_sign_service.dart'; // 导入上面创建的工具类

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('阿里云签名测试')),
        body: Center(child: SignatureButton()),
      ),
    );
  }
}

class SignatureButton extends StatefulWidget {
  [@override](/user/override)
  _SignatureButtonState createState() => _SignatureButtonState();
}

class _SignatureButtonState extends State<SignatureButton> {
  String _signature = '';

  Future<void> _generateSignature() async {
    setState(() {
      _signature = '';
    });
    final String signature = await AliyunSignService.getSignature();
    setState(() {
      _signature = signature;
    });
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Column(
      mainAxisAlignment: MainAxisAlignment.center,
      children: [
        ElevatedButton(
          onPressed: _generateSignature,
          child: Text('生成签名'),
        ),
        SizedBox(height: 20),
        Text(_signature),
      ],
    );
  }
}