Flutter阿里巴巴认证插件ali_auth_plugin的使用

简介

ali_auth_plugin 是一个用于实现阿里巴巴认证功能的 Flutter 插件。它支持 Android 和 iOS 平台，并提供了多种方法来集成阿里巴巴的认证服务。

使用步骤

1. 添加依赖

在 pubspec.yaml 文件中添加 ali_auth_plugin 作为依赖项：

dependencies:
  ali_auth_plugin: ^版本号

运行以下命令以安装依赖：

flutter pub get

2. 初始化插件

在项目中初始化插件并配置必要的参数。以下是完整的示例代码：

import 'package:flutter/material.dart';
import 'package:ali_auth_plugin/ali_auth_plugin_method_channel.dart';
import 'package:ali_auth_plugin/ali_auth_plugin_platform_interface.dart';
import 'package:ali_auth_plugin/ali_auth_ui_config.dart';

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';
  final _aliAuthPlugin = AliAuthPlugin();
  String? _sdkVersion = "";
  bool _checkEnvAvailable = false;
  String? loginToken = "";

  @override
  void initState() {
    super.initState();
    initPlatformState();
    _aliAuthPlugin.getSdkVersion().then((value) {
      print("初始化结果：$value");
      setState(() {
        _sdkVersion = value;
      });
    });
    _aliAuthPlugin.checkEnvAvailable().then((value) {
      print("检查登录结果：$value");
      setState(() {
        _checkEnvAvailable = value;
      });
    });
  }

  // 获取平台版本
  Future<void> initPlatformState() async {
    String platformVersion;
    try {
      platformVersion = await _aliAuthPlugin.getPlatformVersion() ?? 'Unknown platform version';
    } on Exception {
      platformVersion = 'Failed to get platform version.';
    }

    if (!mounted) return;

    setState(() {
      _platformVersion = platformVersion;
    });
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('阿里认证插件示例'),
        ),
        body: Center(
          child: Column(
            mainAxisSize: MainAxisSize.min,
            children: [
            // 显示平台版本
            Text('运行于平台: $_platformVersion\n'),

            // 检查 SDK 版本
            MaterialButton(
              onPressed: () {
                AliAuthPluginPlatform.instance.getSdkVersion().then((value) {
                  print("初始化结果：$value");
                  setState(() {
                    _sdkVersion = value;
                  });
                });
              },
              child: Text("SDK版本: $_sdkVersion"),
            ),

            // 设置 App Secret
            MaterialButton(
              onPressed: () {
                AliAuthPluginPlatform.instance
                    .setAuthSDKInfo("androidkey", "ioskey")
                    .then((value) {});
              },
              child: Text("设置 App Secret"),
            ),

            // 检查环境是否可用
            MaterialButton(
              onPressed: () {
                AliAuthPluginPlatform.instance
                    .checkEnvAvailable()
                    .then((value) {
                  print("检查环境：$value");
                  setState(() {
                    _checkEnvAvailable = value;
                  });
                });
              },
              child: Text("检查环境: $_checkEnvAvailable"),
            ),

            // 获取登录 Token
            MaterialButton(
              onPressed: () {
                print("获取登录 token 点击");
                AliAuthPluginPlatform.instance
                    .getLoginToken(
                        uiConfig: AuthUiConfig(
                  navColor: "#FFFFFFFF",
                  lightColor: true,
                  navTextColor: "#FF000000",
                  navReturnImgPath: "icon_return_333",
                  logoImgPath: "ic_launcher",
                  logBtnBackgroundPath: "ali_auth_log_btn_background",
                  logBtnTextColor: "#FFFFFFFF",
                  checkedImgPath: "icon_agreement_select",
                  uncheckedImgPath: "icon_agreement_normal",
                ))
                    .then((value) {
                  print("获取登录 token：$value");
                  setState(() {
                    loginToken = value;
                  });
                });
              },
              child: Text("获取登录 Token: $loginToken"),
            ),
          ],
        ),
      ),
    );
  }
}

3. 配置 UI 参数

AuthUiConfig 是用于配置认证界面的参数类。以下是一些常用字段的说明：

• navColor: 导航栏背景颜色。
• lightColor: 是否启用浅色模式。
• navTextColor: 导航栏文字颜色。
• navReturnImgPath: 返回按钮图标路径。
• logoImgPath: 应用图标路径。
• logBtnBackgroundPath: 登录按钮背景图片路径。
• logBtnTextColor: 登录按钮文字颜色。
• checkedImgPath: 已选中状态的图片路径。
• uncheckedImgPath: 未选中状态的图片路径。

4. 发布到 Pub.dev

修改版本号并打 Tag 标签

1. 修改 pubspec.yaml 中的版本号。
2. 打标签：

   git tag -a v版本号 -m "版本说明"
   git push origin v版本号
   

发布到 Pub.dev

执行以下命令发布插件：

flutter packages pub publish --server=https://pub.dartlang.org