接入说明：

SDK支持版本：minSdkVersion 16

亿美免密SDK提供手机账号一键登录能力。

v7a版本更新内容：

全面更新了三大运营商的SDK，整理了提供给客户端接口，使用更直观，更便捷。

通过亿美申请appid和appSecret。

1. Android Studio版本需要使用3.0以上

2.本SDK提供两种接入方式：

1>.远程依赖，此方法不再需要拷贝aar到libs目录下。

allprojects {
 repositories {
   maven { url 'https://jitpack.io' }
 }
}

在 module 的 gradle 中添加依赖：

implementation 'com.android.support:appcompat-v7:28.0.0'
implementation 'com.android.support.constraint:constraint-layout:1.0.2'
implementation 'com.alibaba:fastjson:1.2.58'
implementation 'com.squareup.okhttp3:okhttp:3.14.9'
implementation 'com.github.Antidy:OneLoginSDK:1.4.0'

注：如遇到okio冲突，请在module中加入如下代码：

 configurations {
   compile.exclude module: 'okhttp'
   compile.exclude module: 'okio'
 }

2>.本地集成方式：拷贝loginsdk-release-1.4.0.aar到项目 的libs目录下，并在gradle中做以下配置

 implementation fileTree(include: ['*.jar'], dir: 'libs')
 implementation 'com.android.support:appcompat-v7:28.0.0'
 implementation 'com.android.support.constraint:constraint-layout:1.0.2'
 implementation 'com.alibaba:fastjson:1.2.58'
 implementation 'com.squareup.okhttp3:okhttp:3.14.9'
 implementation(name:'loginsdk-release-1.4.0', ext: 'aar')

3. 在gradle中配置signingConfig签名信息，并在编译apk时，使用该签名。

4. 提交app包名和app签名 将app包名和签名提供给平台审核。 平台需要校验app包名和签名，请务必提供准确信息。信息更改后，需要重新向平台申请。 可使用命令：keytool -v -list -keystore 你的应用签名文件.jks获取签名的MD5信息。

5. 在AndroidManifest.xml配置必要的权限支持，并在代码中做动态权限申请。

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<!--  低版本系统 requestNetwork 接口需要该权限，参考ConnectivityManager requestNetwork 方法  -->
<uses-permission android:name="android.permission.WRITE_SETTINGS" />

权限说明：

权限名称	权限说明	使用说明
INTERNET	允许应用程序联网	用于访问极验、运营商网关和认证服务器
ACCESS_WIFI_STATE	允许访问 WiFi 网络状态信息	允许 SDK 获取 WiFi 网络状态与连接信息
ACCESS_NETWORK_STAT	允许访问网络状态	允许 SDK 判断当前网络处于移动网络或WiFi网络
CHANGE_NETWORK_STATE	允许改变网络连接状态	设备在WiFi跟数据双开时，允许 SDK 内部请求（仅用于网关取号的请求）强行走数据网络通道
CHANGE_WIFI_STATE	允许改变 WiFi 网络连接状态	设备在 WiFi 跟数据双开时，切允许 SDK 内部请求
READ_PHONE_STATE	允许读取手机状态	SDK 取号阶段判断换卡、移动 SDK 判断双卡和换卡(低概率使用场景，非必须权限)
WRITE_SETTINGS	允许读写系统设置项	低版本系统进行数据切换用到的权限，添加后可增加 WiFi+4G下网络环境下的取号成功率，高版本系统以上可去除该权限

6.Android 9.0 以上设备配置对 http 协议的支持：

<application android:usesCleartextTraffic="true">
    //...
</application> //请务必配到application节点上

7. 配置混淆策略

-dontwarn com.geetest.onelogin.**
-keep class com.geetest.onelogin.** {
*;
}
-dontwarn com.geetest.onepassv2.**
-keep class com.geetest.onepassv2.** {
*;
}
-dontwarn com.geetest.deepknow.**
-keep class com.geetest.deepknow.** {
*;
}
-dontwarn com.geetest.mobinfo.**
-keep class com.geetest.mobinfo.** {
*;
}
-dontwarn com.cmic.sso.sdk.**
-keep class com.cmic.sso.sdk.** {
*;
}
-dontwarn com.unigeetest.**
-keep class com.unigeetest.** {
*;
}
-dontwarn cn.com.chinatelecom.account.**
-keep class cn.com.chinatelecom.account.** {
*;
}
#emay
-keep class cn.emay.ql.**{*;}
                      		

1、调用UniSDK.getInstance().initAuth初始化，并获取初始化回调结果。

方法原型：

UniSDK.getInstance().initAuth(Context context, String appId, String
appSecret,new InitCallback() {
     @Override
     public void onSuccess(String msg) {
       //初始化成功
     }
     @Override
     public void onFailed(String msg) {
     //初始化失败
     }
   });
                        	

参数说明：

context，当前页面上下文

appId，通过亿美拿到的appId

appSecret：通过亿美拿到的appSecret

InitCallback：初始化回调

2、在初始化成功完成之后，调用UniSDK.getInstance().login 接口完成登录

方法原型：

public void login(OneLoginThemeConfig themeConfig,LoginCallback callback) {
}

参数说明：

context，当前页面上下文

callback ：登录回调，需要开发者自己在回调中做出相应处理

themeConfig：授权页的自定义UI参数对象

onSuccess(String msg)
msg参数说明：登录成功后返回获取的token。

onFailed(String msg)
msg参数说明：登录失败返回的错误原因。

3、关闭授权页

用户主动关闭授权页。SDK 除了返回按钮触发关闭以外，默认是不 finsih 授权页的，需要开发者在回调 结束后自行关闭授权页。

代码示例：

OneLoginHelper.with().dismissAuthActivity();

v7a版本将所有的UI自定义部分都以代码接口的形式提供给了接入者，通过实例化 OneLoginThemeConfig 并进行自定义配置，完成授权页面 UI 的个性化设计，每次调用拉起授权页方法前必须先传入该实例，否则授权界面会展示异常。

1：创建实例：

 OneLoginThemeConfig oneLoginThemeConfig = new OneLoginThemeConfig.Builder().build();

2：弹窗模式设置：

setDialogTheme(boolean isDialogTheme, int dialogWidth, int dialogHeight, int dialogX,
                                int dialogY, boolean isDialogBottom,
                                boolean isWebViewDialogTheme)

参数说明

3：添加自定义控件

在login方法之前实现。

OneLoginHelper.with().addOneLoginRegisterViewConfig(id, authRegisterViewConfig);

参数说明

创建自定义控件配置

AuthRegisterViewConfig authRegisterViewConfig =
                                new AuthRegisterViewConfig.Builder().build();

方法说明

4：授权页其他接口

· 设置横竖屏(setRequestedOrientation)

方法描述

建议直接在 AndroidManifest 中配置登录页前一个 Activity 的方向，或者调用系统api`setRequestedOrientation`设置屏幕方向来替换此方法。

public void setRequestedOrientation(Activity activity, boolean isPortrait)

代码示例

setRequestedOrientation(MainActivity.this, true);

参数说明

· 设置授权页面背景(setAuthBGImgPath)

方法描述

设置背景图片。

setAuthBGImgPath(String authBGImgPath)

参数说明

· 设置授权页面视频背景(setAuthBGImgPath)

方法描述

设置页面视频背景。

setAuthBgVideoUri(String authBgVideoUri)

参数说明

· 状态栏设置(setStatusBar)

方法描述

设置状态栏颜色、字体颜色。

setStatusBar(int statusBarColor, int navigationBarColor, boolean isLightColor)

参数说明

· 标题栏设置(setAuthNavLayout)

方法描述

设置标题栏布局

setAuthNavLayout(int navColor, int authNavHeight,
                                boolean authNavTransparent, boolean authNavGone)

参数说明

· 标题栏文字设置(setAuthNavTextView)

方法描述

设置标题栏中间文字相关

setAuthNavTextView(String navText, int navTextColor, int navTextSize,
                                boolean navWebTextNormal,String navWebViewText,
                                int navWebViewTextColor, int navWebViewTextSize)

参数说明

· 标题栏字体设置(setAuthNavTextViewTypeface)

方法描述

设置标题栏中间文字的字体相关

setAuthNavTextViewTypeface(Typeface navTextTypeface, Typeface navWebViewTextTypeface)

参数说明

· 标题栏返回按钮设置(setAuthNavReturnImgView)

方法描述

设置标题栏返回按钮相关

setAuthNavReturnImgView(String returnImgPath, int returnImgWidth, int returnImgHeight,
                                boolean returnImgHidden, int returnImgOffsetX)
setAuthNavReturnImgView(String returnImgPath, int returnImgWidth, int returnImgHeight,
                                boolean returnImgHidden, int returnImgOffsetX,
                                int returnImgOffsetY)

参数说明

· 返回事件屏蔽设置(setBlockReturnEvent)

方法描述

设置是否屏蔽返回键与返回按钮返回事件，屏蔽后仍然会发生对应的错误码回调，只是 SDK 默认不关闭授权页。

setBlockReturnEvent(boolean blockReturnKey, boolean blockReturnBtn)

参数说明

· logo设置(setLogoImgView)

方法描述

设置logo相关

setLogoImgView(String logoImgPath, int logoWidth, int logoHeight,
                                boolean logoHidden, int logoOffsetY,
                                int logoOffsetY_B, int logoOffsetX)

参数说明

· 号码显示设置(setNumberView)

方法描述

设置号码相关

setNumberView(int numberColor, int numberSize, int numberOffsetY, int numberOffsetY_B,
                                int numberOffsetX)

参数说明

· 号码字体设置(setNumberText)

方法描述

设置号码栏富文本样式，配置后将使用该富文本填充脱敏手机号内容

setNumberText(CharSequence numberText)

参数说明

· 号码字体设置(setNumberViewTypeface)

方法描述

设置号码栏字体相关

setNumberViewTypeface(Typeface numberTypeface)

参数说明

· 切换账号视图设置(setSwitchView)

方法描述

设置切换账号相关

setSwitchView(String switchText, int switchColor, int switchSize, boolean switchHidden,
                                int switchOffsetY, int switchOffsetY_B, int switchOffsetX)

参数说明

· 切换账号视图背景设置(setSwitchViewLayout)

方法描述

设置切换账号背景图片与宽高相关

setSwitchViewLayout(String switchImgPath, int switchWidth, int switchHeight)

参数说明

· 切换账号字体设置(setSwitchViewTypeface)

方法描述

设置切换账号字体相关

setSwitchViewTypeface(Typeface switchTypeface)

参数说明

· 登录按钮布局设置(setLogBtnLayout)

方法描述

设置登录按钮布局

setLogBtnLayout(String logBtnImgPath, int logBtnWidth, int logBtnHeight,
                                int logBtnOffsetY, int logBtnOffsetY_B, int logBtnOffsetX)
setLogBtnLayout(String logBtnImgPath, String logBtnUncheckedImgPath, int logBtnWidth,
                                int logBtnHeight, int logBtnOffsetY, int logBtnOffsetY_B,
                                int logBtnOffsetX)

参数说明

· 登录按钮文字设置(setLogBtnLayout)

方法描述

设置登录按钮中间文字相关

setLogBtnTextView(String logBtnText, int logBtnColor, int logBtnTextSize)

参数说明

· 登录按钮文字字体设置(setLogBtnTextViewTypeface)

方法描述

设置登录按钮中间文字的字体相关

setLogBtnTextViewTypeface(Typeface logBtnTextTypeface)

参数说明

· 登录按钮可用状态随选择框选择状态变化设置(setLogBtnDisableIfUnChecked)

方法描述

设置登录按钮在选择框未选择时禁用状态

setLogBtnDisableIfUnChecked(boolean disableBtnIfUnChecked)

参数说明

· 登录加载视图设置(setLogBtnLoadingView)

方法描述

设置loading图片相关

setLogBtnLoadingView(String loadingView, int loadingViewWidth, int loadingViewHeight,
                                int loadingViewOffsetRight)
setLogBtnLoadingView(String loadingView, int loadingViewWidth, int loadingViewHeight,
                                int loadingViewOffsetRight, int loadingViewOffsetY)

参数说明

· 标语设置(setSloganView)

方法描述

设置 Slogan 相关

setSloganView(int sloganColor, int sloganSize, int sloganOffsetY,
                                int sloganOffsetY_B, int sloganOffsetX)

参数说明

· 标语字体设置(setSloganViewTypeface)

方法描述

设置 Slogan 文字的字体相关

setSloganViewTypeface(Typeface sloganTypeface)

参数说明

· 隐私栏布局设置(setPrivacyLayout)

方法描述

设置隐私条款布局

setPrivacyLayout(int privacyLayoutWidth, int privacyOffsetY, int privacyOffsetY_B,
                                int privacyOffsetX, boolean isUseNormalWebActivity)
setPrivacyLayout(int privacyLayoutWidth, int privacyOffsetY, int privacyOffsetY_B,
                                int privacyOffsetX, boolean isUseNormalWebActivity,
                                int gravity)

参数说明

· 隐私栏勾选框设置(setPrivacyCheckBox)

方法描述

设置隐私条款选择框相关

setPrivacyCheckBox(String unCheckedImgPath, String checkedImgPath, boolean privacyState,
                                int privacyCheckBoxWidth, int privacyCheckBoxHeight)
setPrivacyCheckBox(String unCheckedImgPath, String checkedImgPath, boolean privacyState,
                                int privacyCheckBoxWidth, int privacyCheckBoxHeight,
                                int privacyCheckBoxOffsetY)
setPrivacyCheckBox(String unCheckedImgPath, String checkedImgPath, boolean privacyState,
                                int privacyCheckBoxWidth, int privacyCheckBoxHeight,
                                int privacyCheckBoxOffsetY,
                                int privacyCheckBoxMarginRight)

参数说明

· 隐私条款文字显示设置(setPrivacyClauseView)

方法描述

设置隐私条款字体相关

setPrivacyClauseView(int baseClauseColor, int clauseColor, int privacyClauseTextSize)

参数说明

· 隐私条款文字设置(setPrivacyTextView)

方法描述

设置除了隐私条款其他的字体相关

setPrivacyTextView(String privacyTextViewTv1, String privacyTextViewTv2,
                                String privacyTextViewTv3, String privacyTextViewTv4)

参数说明

· 设置隐私栏文字的字体(setPrivacyClauseViewTypeface)

方法描述

设置隐私栏文字的字体相关

setPrivacyClauseViewTypeface(Typeface privacyClauseBaseTypeface,
                                Typeface privacyClauseTypeface)

参数说明

· 开发者隐私条款设置(setPrivacyClauseText)

方法描述

设置开发者隐私条款相关。

自定义隐私条款顺序。按顺序设置，当有条款名称与条款 URL 一起为空时，则使用默认的运营商隐私条款。否则按照顺序排列，自定义隐私条款最多只能两个。

setPrivacyClauseText(String clauseNameOne, String clauseUrlOne, String clauseNameTwo,
                                String clauseUrlTwo, String clauseNameThree,
                                String clauseUrlThree)

参数说明

· 开发者隐私条款设置(setPrivacyClauseTextStrings)

方法描述

设置多个开发者隐私条款相关。

自定义多个隐私条款。按顺序设置，长度为 4 的倍数，配置后优先使用该接口的配置，否则使用`setPrivacyClauseText`的配置。可通过预留一组空字符串配置让 SDK 自动添加运营商协议。

setPrivacyClauseTextStrings(String... privacyClauseTextStrings)

参数说明

代码示例

/**
 *连续四个参数为一组隐私协议条款 第一个为条款说明前缀或者分隔字符，第二个为条款名称，第三个为条款 URL，
                                第四个为说明后缀或者分隔字符
 *任意一组留空，SDK 会自动添加运营商隐私条款，留空的位置可前后调整。
 */
.setPrivacyClauseTextStrings("登录即同意", "应用自定义服务条款一", "http://a.b.c", "",
                        "和", "应用自定义服务条款二", "http://x.y.z", "",
                        "和", "应用自定义服务条款三", "http://x.y.z", "",
                        "和", "", "", "并使用本机号码登录")

注:运营商隐私协议必须显示，开发者需保留一组条款参数留空

隐私条款名称显示书名号相关(setPrivacyAddFrenchQuotes)

方法描述

设置授权页面隐私条款名称显示书名号。

setPrivacyAddFrenchQuotes(boolean privacyAddFrenchQuotes)

注: 个别第三方系统可能存在对包含中文字符的富文本渲染异常，出现文字超出控件右边界显示被截断的情况，建议不要添加书名号。

参数说明

· 隐私条款文字对齐方式(setPrivacyTextGravity)

方法描述

设置隐私条款文字对齐方式。

setPrivacyTextGravity(int privacyTextGravity)

参数说明

· 隐私条款文字行间距(setPrivacyLineSpacing)

方法描述

设置隐私条款文字行间距，参考`TextView.setLineSpacing`方法。

setPrivacyLineSpacing(float lineSpacingExtra, float lineSpacingMultiplier)

参数说明

· 未同意隐私条款时的文字提示(setPrivacyUnCheckedToastText)

方法描述

设置未同意隐私条款时的文字提示相关。

setPrivacyUnCheckedToastText(String privacyUnCheckedToastText)
setPrivacyUnCheckedToastText(boolean enableToast, String privacyUnCheckedToastText)

参数说明