Flutter支付安全验证插件opatech_clearsale_flutter的使用

opatech_clearsale_flutter_example

该插件用于注册Android和iOS设备以获取sessionID，此sessionID对于发送ClearSale订单是必需的。要使用该插件，您需要与ClearSale公司签订合同，并获得用于下载Android和iOS包的TOKEN以及用于数据捕获和生成sessionId的指纹TOKEN。

Getting Started CONFIG

Android Config

1. 在项目的build.gradle文件中插入以下内容。
2. 将Token obtained from ClearSale替换为ClearSale提供的token。

buildscript {
    repositories {
        ....
        maven {
            url 'https://pkgs.dev.azure.com/vstscs/Produtos-Agile/_packaging/BehaviorAnalytics.SDK/maven/v1'
            name 'BehaviorAnalytics.SDK.Android'
            credentials {
                username "vstscs"
                password "Token obtained from ClearSale"
            }
        }
    }
    .....
}

dependencies {
      ....
        classpath 'sale.clear.behavior:sdk-behavior:3.0.2'
    }

allprojects {
    repositories {
       ...
        maven {
            url 'https://pkgs.dev.azure.com/vstscs/Produtos-Agile/_packaging/BehaviorAnalytics.SDK/maven/v1'
            name 'BehaviorAnalytics.SDK.Android'
            credentials {
                username "vstscs"
                password "Token obtained from ClearSale"
            }
        }
.....
}

iOS Config

1. 更改项目中的Podfile，修改target 'Runner'并插入源（source）和框架（use_frameworks!），将Token obtained from ClearSale替换为ClearSale提供的token。

source	'https://csbehaviorsdk:|Token obtained from ClearSale|@dev.azure.com/vstscs/Produtos-Agile/_git/BehaviorAnalytics.SDK.IOS.Specs'
use_frameworks!

target 'Runner' do
  pod 'CSBehavior', '3.0.1'
  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))
end

1. 打开项目编辑器，选择项目，并在“构建设置”（Build Settings）标签页中添加标志-ObjC到其他链接器标志（Other Linker Flags）设置中。

2. 向目标项目的Info.plist文件中添加以下条目：

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSExceptionDomains</key>
    <dict>
        <key>clearsale.com.br</key>
        <dict>
            <key>NSTemporaryExceptionMinimumTLSVersion</key>
            <string>TLSv1.0</string>
        </dict>
    </dict>
</dict>

Flutter

1. 从ClearSale获取指纹，并将其替换到下面的代码中的字符串"fingerprint provided by ClearSale"。

2. 导入所需的包到将用于获取sessionId的类中：

import 'package:opatech_clearsale_flutter/opatech_clearsale_flutter.dart';

1. 获取sessionId：

String sessionId;
try {
    await OpatechClearsaleFlutter.config("INSERIR O FINGERPRINT DA CLEARSELE"); // fingerprint id
    sessionId =  await OpatechClearsaleFlutter.sessionId;
} on PlatformException catch (e) {
    sessionId = 'Failed. ${e.message}';
}

完整示例Demo

example/lib/main.dart

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

import 'package:flutter/services.dart';
import 'package:opatech_clearsale_flutter/opatech_clearsale_flutter.dart';

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

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

class _MyAppState extends State<MyApp> {
  String _platformVersion = 'Unknown';

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  // 平台消息是异步的，因此我们在异步方法中初始化。
  Future<void> initPlatformState() async {
    String sessionId;
    // 平台消息可能会失败，所以我们使用带有PlatformException的try/catch。
    try {
      await OpatechClearsaleFlutter.config("INSERIR O FINGERPRINT DA CLEARSELE"); // fingerprint id
      sessionId = await OpatechClearsaleFlutter.sessionId;
    } on PlatformException catch (e) {
      sessionId = 'Failed. ${e.message}';
    }

    try {
      await OpatechClearsaleFlutter.config(
          "INSERIR O FINGERPRINT DA CLEARSELE"); // fingerprint id
      sessionId += '\n' + await OpatechClearsaleFlutter.sessionId;
    } on PlatformException catch (e) {
      sessionId += '\n' + 'Failed. ${e.message}';
    }

    try {
      await OpatechClearsaleFlutter.config(
          "INSERIR O FINGERPRINT DA CLEARSELE"); // fingerprint id
      sessionId += '\n' + await OpatechClearsaleFlutter.sessionId;
    } on PlatformException catch (e) {
      sessionId += '\n' + 'Failed. ${e.message}';
    }

    if (!mounted) return;

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('插件示例应用'),
        ),
        body: Center(
          child: Text('Session Id: $_platformVersion\n'),
        ),
      ),
    );
  }
}