Description:
flutter ali auth
flutter_ali_auth #
Language: 中文
基于阿里云一键登录的 Flutter集成的SDK插件
阿里云一键登录安卓接入文档: Android_V2.12.11
阿里云一键登录IOS接入文档: iOS_V2.12.11
更新历史 🌄 #
现已更新到与官方同步的SDK V2.12.11 版本;
授权页适配夜间/暗色模式(仅全屏，弹窗模式需自定以);
目录 #
效果图
IOS
Android
准备工作
原生SDK代码调用顺序
插件使用
添加监听
初始化SDK配置密钥与UI
检查环境
预取号
调起授权页面，获取Token
注意事项
效果图 📷 #
IOS #
全屏
底部弹窗
中间弹窗
Android #
全屏
底部弹窗
中间弹窗
插件须知 ⚠️ #
关于权限 #
安卓权限，本插件已经添加必要的权限支持：
<uses-permission android:name="android.permission.INTERNET" /> <!-- 网络访问 -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> <!-- 检查wifi网络状态 -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <!-- 检查网络状态 -->
<uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" /> <!-- 切换网络通道 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> <!-- 本地信息缓存 -->
<uses-permission android:name="android.permission.CHANGE_WIFI_STATE" /> <!-- 开关Wi-Fi状态，解决中国内地机型移动网络权限问题需要 -->
copied to clipboard
需要加上自行根据实际情况，设置HTTP白名单
<network-security-config>
<domain-config cleartextTrafficPermitted="true" >
<domain includeSubdomains="true">enrichgw.10010.com</domain> <!-- 联通内部5G请求域名，开发者需要添加 -->
<domain includeSubdomains="true">onekey.cmpassport.com</domain> <!-- 移动内部请求域名，开发者需要添加 -->
</domain-config>
</network-security-config>
copied to clipboard
目前中国移动提供的个别接口为HTTP请求，对于全局禁用HTTP的项目，需要设置HTTP白名单。以下为运营商HTTP接口域名：onekey.cmpassport.com，enrichgw.10010.com，
详情可参见官方文档
2.苹果开发
插件已经集成主库ATAuthSDK.framework，不需要添加-ObjC。
开发工具建议使用Xcode 11及以上。
支持iOS 10及以上系统。
最后，有用请🌟~ #
准备工作 🔧 #
请登录阿里云控制台号码认证服务
分别添IOS和Android的认证方案，从而获取到SDK的秘钥。
注意：Ios只需要输入绑定Bundle name即可，Android则需要包名和和签名。如何获取App的签名
先了解原生SDK代码调用顺序 🔗 #
/*
* 1.初始化获取Token实例
*/
TokenResultListener mTokenListener = new TokenResultListener();
/*
* 2.初始化SDK实例
*/
mAlicomAuthHelper = PhoneNumberAuthHelper.getInstance(context, mTokenListener);
/*
* 3.设置SDK密钥
*/
mAlicomAuthHelper.setAuthSDKInfo();
/*
* 4.检测终端⽹络环境是否⽀持⼀键登录或者号码认证，根据回调结果确定是否可以使⽤⼀键登录功能
*/
mAlicomAuthHelper.checkEnvAvailable(PhoneNumberAuthHelper#SERVICE_TYPE_LOGIN);
/*
* 5.若步骤4返回true，则根据业务情况，调⽤预取号或者⼀键登录接⼝
* 详⻅Demo接⼊⼯程
*/
mAlicomAuthHelper.getLoginToken(context, 5000);
copied to clipboard
插件使用 ☄️ #
1. 添加监听 #
/// 传入回调函数 onEvent
AliAuthClient.handleEvent(onEvent: _onEvent);
/// 移除回调事件
AliAuthClient.removeHandler();
copied to clipboard
在onEvent中监听回调并且自行进行判断
void _onEvent(AuthResponseModel event) async {
//print(event);
}
copied to clipboard
回调实例AuthResponseModel
在原生中已经对事件响应码进行了包装，消息成员如下
参数名
类型
描述
resultCode
String
SDK返回码，600000表示操作成功（初始化/检查环境/预取号/登录成功）,详情参考官网的SDK返回码
requestId
String
SDK请求ID，如出现无法解决问题时候可以根据Id创建工单咨询
msg
String
SDK返回码描述，详情参考官网的SDK返回码
token
String
在 授权页面点击登录按钮成功 认证后resultCode为60000时，会返回认证的Token,此时SDK提供的服务到此结束，可以拿Token到服务端进行自行判断登录认证
innerCode
String
如果初始化认证SDK出现问题，回调信息一般会携带运行商的错误代码和错误信息，详情参考运营商SDK错误码
innerMsg
String
运行商认证时候出现的错误信息
2.初始化SDK (initSdk) #
/// 初始化前需要须对插件进行监听
await AliAuthClient.initSdk(
authConfig: const AuthConfig(),
);
copied to clipboard
需要通过 AuthConfig 来配置安卓和IOS端的秘钥，以及UI的配置 AuthUIConfig,成员如下
参数名
类型
描述
iosSdk
String
IOS秘钥
androidSdk
String
Android秘钥
enableLog
bool
是否打印日志
authUIStyle
Enum
fullScreen(全屏) bottomSheet(底部弹窗) alert(中间弹窗) 目前暂时配置了三种常用竖屏的形式,更多形式参考官方文档 后续将陆续支持
authUIConfig
AuthUIConfig
UI配置类
AuthUIConfig为UI的配置类型,分为全屏UI配置 FullScreenUIConfig 和弹窗UI配置 AlertUIConfig
FullScreenUIConfig 成员如下
参数名
类型
描述
navConfig
NavConfig
导航栏UI配置
backgroundColor
String
十六进制背景颜色,eg: "#ffffff"
backgroundImage
String
本地的背景图片,eg: "/assets/image/background.png"
prefersStatusBarHidden
Boolean
状态栏是否隐藏，默认显示
logoConfig
LogoConfig
LogoUI配置类
sloganConfig
SloganConfig
SloganConfig配置类
phoneNumberConfig
PhoneNumberConfig
PhoneNumberConfig配置类
loginButtonConfig
LoginButtonConfig
LoginButtonConfig配置类
changeButtonConfig
ChangeButtonConfig
ChangeButtonConfig配置类
checkBoxConfig
CheckBoxConfig
CheckBoxConfig配置类
privacyConfig
PrivacyConfig
PrivacyConfig配置，自定义协议（目前只支持三个）
AlertUIConfig 成员如下
参数名
类型
描述
alertTitleBarConfig
AlertTitleBarConfig
弹窗ActionBar的UI配置
alertContentViewColor
String
十六进制背景颜色,eg: "#ffffff"
alertBlurViewColor
String
弹窗蒙层的颜色
alertBlurViewAlpha
double
弹窗蒙层的透明度
alertBorderRadius
double
弹窗圆角
alertBorderWidth
double
边框宽度,仅Android生效
alertBorderColor
String
边框颜色,仅Android生效
alertWindowWidth
double
弹窗宽度
alertWindowHeight
double
弹窗高度
logoConfig
LogoConfig
LogoUI配置类
sloganConfig
SloganConfig
SloganConfig配置类
phoneNumberConfig
PhoneNumberConfig
PhoneNumberConfig配置类
loginButtonConfig
LoginButtonConfig
LoginButtonConfig配置类
changeButtonConfig
ChangeButtonConfig
ChangeButtonConfig配置类
checkBoxConfig
CheckBoxConfig
CheckBoxConfig配置类，弹窗默认隐藏checkbox
privacyConfig
PrivacyConfig
PrivacyConfig配置，自定义协议（目前只支持三个）
3.一键登录获取Token (login) #
调用该接口首先会弹起授权页，点击授权页的登录按钮获取Token,可选参数为Timeout,默认5s
调用此接口后会通过之前注册的监听中回调信息
/// 一键登陆 需要用try-catch[PlatformException]捕获插件返回的异常
/// 无返回内容,调用之后，会在[handleEvent]的[onEvent]返回回调
await AliAuthClient.login({double timeout = 5.0})
copied to clipboard
4.其他方法 #
下面的方法与官网接入文档一致，可以根据个人开发情况进行使用
/// 关闭授权页loading
await AliAuthClient.hideLoginLoading();
/// 退出授权认证页
await AliAuthClient.quitLoginPage();
copied to clipboard
License
For personal and professional use. You cannot resell or redistribute these repositories in their original state.
Files:
Customer Reviews
There are no reviews.
