安装

在工程 pubspec.yaml 中加入 dependencies

• github 集成

dependencies:
  shanyan:
    git:
      url: git://github.com/253CL/baiban.git
      path: shanyan
      ref: v1.0.4

使用

import 'package:shanyan/shanyan.dart';

Android 开发环境搭建

a.权限配置（AndroidManifest.xml文件里面添加权限）

必要权限：

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE"/>
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE"/>

配置权限说明

b.配置Android 对http协议的支持(任选其一)：

方式①：

android:usesCleartextTraffic="true"

示例代码：

<application
    android:name=".view.MyApplication"
    ***
    android:usesCleartextTraffic="true"
    ></application>

方式②：

运营商个别接口为http请求，对于全局禁用Http的项目，需要设置Http白名单。以下为运营商http接口域名：cmpassport.com；10010.com

c.混淆规则：

-dontwarn com.cmic.sso.sdk.**
-dontwarn com.unikuwei.mianmi.account.shield.**
-dontwarn com.sdk.**
-keep class com.cmic.sso.sdk.**{*;}
-keep class com.sdk.** { *;}
-keep class com.unikuwei.mianmi.account.shield.** {*;}
-keep class cn.com.chinatelecom.account.api.**{*;}

通过上面的几个步骤，工程就配置完成了，接下来就可以在工程中使用闪验SDK进行开发了。

iOS 开发环境搭建

添加插件后无需特殊配置

一、免密登录API使用说明

1.初始化

使用一键登录功能前，必须先进行初始化操作。

调用示例

ClShanyan.init(appId: "******").then((shanYanResult) {
      setState(() {
           _method = "初始化";
           _code = shanYanResult.code ?? 0;
           _msg = shanYanResult.message ?? "";
           _content = shanYanResult.toJson().toString();
     });
    print(shanYanResult.toJson().toString());
});

参数描述

返回为ShanYanResult对象属性如下：

2.预取号

• 建议在判断当前用户属于未登录状态时使用，已登录状态用户请不要调用该方法
• 避免大量资源下载时调用，例如游戏中加载资源或者更新补丁的时候要顺序执行

调用示例：

  ClShanyan.getPrePhoneInfo().then((shanYanResult) {
        setState(() {
        _method = "预取号";
        _code = shanYanResult.code ?? 0;
        _msg = shanYanResult.message ?? "";
        _content = shanYanResult.toJson().toString();
    });
    print(shanYanResult.toJson().toString());
 });

返回为ShanYanResult对象属性如下：

返回示例：

{innerCode: 1022, innerDesc: 预取号成功, number: 173****4253, telecom: CTCC, protocolName: 天翼服务及隐私协议, protocolUrl: https://e.189.cn/sdk/agreement/detail.do?hidetop=true}

3.获取token

• 调用获取token应同步拉起运营商授权页面。
• 授权页具体规则参考 官方文档 上闪验相关部分
• 授权页须包含一键登录按钮、运营商协议名称（可查看协议链接详情）、脱敏手机号

调用示例：

ClShanyan.openLoginAuth().then((shanYanResult) {
    setState(() {
        _method = "获取token";
        _code = shanYanResult.code ?? 0;
        _msg = shanYanResult.message ?? "";
        _content = shanYanResult.toJson().toString();
    });
    print(shanYanResult.toJson().toString());
});

返回为ShanYanResult对象属性如下：

**

4.置换手机号

当一键登录外层code为1000时，您将获取到返回的参数，请将这些参数传递给后端开发人员，并参考「服务端」文档来实现获取手机号码的步骤。

注意：如果添加布局为自定义控件，监听实现请参考demo示例。
**

二、本机认证API使用说明

注：本机认证同免密登录，需要初始化，本机认证、免密登录可共用初始化，两个功能同时使用时，只需调用一次初始化即可。

1.初始化

同免密登录初始化

2.本机号校验

在初始化执行之后调用，本机号校验界面需自行实现，可以在多个需要校验的页面中调用。

调用示例：

//闪验SDK 本机号校验获取token (Android+iOS)
ClShanyan.localAuthentication().then((shanYanResult) {
    setState(() {
        _method = "本机号校验获取token";
        _code = shanYanResult.code ?? 0;
        _msg = shanYanResult.message ?? "";
        _content = shanYanResult.toJson().toString();
    });
    print(shanYanResult.toJson().toString());
});

返回为ShanYanResult对象属性如下：

3.校验手机号

当本机号校验外层code为2000时，您将获取到返回的参数，请将这些参数传递给后端开发人员，并参考「服务端」文档来实现校验本机号的步骤

三、返回码

该返回码为闪验SDK自身的返回码，请注意1003及1023错误内均含有运营商返回码，具体错误在碰到之后查阅「返回码」