Flutter数据同步插件aerosync_flutter_sdk的使用

介绍

本Flutter SDK提供了一个接口，通过flutter_inappwebview在Flutter应用中加载Aerosync-UI。安全地通过银行网站链接您的银行账户。通过快速、安全且令牌化的连接登录。您的信息不会被共享或出售。

1. 安装

步骤1：在pubspec.yaml文件中添加依赖

首先，在pubspec.yaml文件中添加aerosync_flutter_sdk作为依赖项。我们目前正在进行持续开发以进行微调和改进，当前使用版本为^1.1.0，它包含最新的功能和修复。

dependencies:
  aerosync_flutter_sdk: ^1.1.0

步骤2：导入库

在需要使用该插件的文件中导入库。

import 'package:aerosync_flutter_sdk/aerosync_flutter_sdk.dart';

2. 使用/示例

Aerosync插件作为一个单独的窗口启动，该窗口使用Flutter InAppWebView插件并加载Aerosync的起始URL。在这个示例中，当按下ElevatedButton时，小部件将导航到指定页面。

示例代码

import 'dart:convert';

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

void main() => runApp(UrlLauncherPage());

class UrlLauncherPage extends StatefulWidget {
  UrlLauncherPage({Key? key}) : super(key: key);
  @override
  UrlLauncherExample createState() => UrlLauncherExample();
}

class UrlLauncherExample extends State<UrlLauncherPage> {
  static const String _title = 'URL Launcher Example';
  late String _token = "";
  late String _env = "sandbox";
  late String _deeplink = "";
  late String _consumerId = "";
  late bool _handleMFA = false;
  late String _jobId = "";
  late String _userId = "";
  Map _style = {};
  late bool isLoading;

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: _title,
      home: Scaffold(
        appBar: AppBar(title: const Text(_title)),
        body: isLoading
            ? LaunchButton(
                env: _env,
                token: _token,
                style: _style,
                deeplink: _deeplink,
                consumerId: _consumerId,
                handleMFA: _handleMFA,
                jobId: _jobId,
                userId: _userId,
              )
            : SizedBox(), // 这里包括所有按钮和功能
      ),
    );
  }

  @override
  void initState() {
    super.initState();
    isLoading = false;
  }
}

class LaunchButton extends StatelessWidget {
  var env;
  var token;
  var style;
  var deeplink;
  var consumerId;
  var handleMFA;
  var jobId;
  var userId;
  LaunchButton(
      {Key? key,
      required this.env,
      required this.token,
      required this.style,
      required this.deeplink,
      this.consumerId,
      this.handleMFA,
      this.jobId,
      this.userId})
      : super(key: key);

  // 处理来自aerosync的OnEvent回调
  handleOnEventAerosync(eventType, data) {
  }

  // 处理来自aerosync的OnSuccess回调
  handleOnSuccessAerosync(eventType, data) {
    Map<String, dynamic> successData = jsonDecode(data);
    print(data);
  }

  // 处理来自aerosync的OnClose回调
  handleOnCloseAerosync(eventType, data) {
  }

  // 处理来自aerosync的OnLoad回调
  handleOnLoadAerosync(eventType, data) {
  }

  // 处理来自aerosync的OnError回调
  handleOnErrorAerosync(eventType, data) {
  }

  @override
  Widget build(BuildContext context) {
    return SafeArea(
        child: Column(
      mainAxisAlignment: MainAxisAlignment.center,
      mainAxisSize: MainAxisSize.min,
      children: [
        ElevatedButton(
          onPressed: () => {
            Navigator.of(context).push(MaterialPageRoute(
                builder: (context) => AerosyncSDKPage(
                      env: env,
                      token: token,
                      style: style,
                      onEvent: handleOnEventAerosync,
                      onSuccess: handleOnSuccessAerosync,
                      onClose: handleOnCloseAerosync,
                      onLoad: handleOnLoadAerosync,
                      onError: handleOnErrorAerosync,
                      deeplink: deeplink,
                      consumerId: consumerId,
                      handleMFA: handleMFA,
                      jobId: jobId,
                      userId: userId,
                    )))
          },
          child: Text(
            'Connect',
            style: TextStyle(fontSize: 20),
          ),
        ),
      ],
    ));
  }
}

参数说明

AerosyncSDKPage 小部件接受 env 参数、token 参数、style 参数、deeplink 参数以及回调事件通知，这些对于您的实现都是必需的。要生成一个token，请查看我们的集成指南这里。

每个回调返回一个 eventType 值和从 aerosync-ui 返回的数据。

📘 DeepLink参数是一个必填字段，用于链接回您的Flutter应用，以获得最佳的oAuth认证体验。

美国最大的金融机构使用oAuth体验来安全地验证其最终用户的银行，以提供最佳的用户体验。

要使用Flutter实现DeepLink，请参阅官方Flutter DeepLink指南这里。

存储已连接的账户

存储onSuccess() 数据属性以使用Aerosync API进行身份验证并检索账户信息。成功调用返回的数据值是一个JSON编码的值，您可以将其解码为jsonDecode(data) 以将其用作Map。查看给定示例。

{
  "payload": {  
      "clientName": "client3",
      "FILoginAcctId": "{\"u_guid\":\"USR-701a457e-5b93-4598-b7a1-b968c495ee3f\", \"m_guid\": \"MBR-d699c457-90f7-4b96-96c1-c50a445eabec\", \"a_guid\": \"ACT-9f5549d6-e402-43f4-8351-cd4018de7a80\"}",
      "user_id": "a2c7f64f-3df9-4090-b3bd-ad6fc3003c90",  
      "user_password": "735e33b9-78ec-4887-99d7-a3056997ceb9"},
  "type": "pageSuccess"
}