开发者中心

Android问题

高频问题

1.参数异常问题**【安卓/Android/android+参数+异常】**
开发者打开混淆开关,但是没有配置混淆过滤文件

2.签名校验问题**【签名校验】**
①开发者打开混淆开关,但是没有配置混淆过滤文件
②创建应用时签名填写错误,release和debug版本签名不一致

3.电信卡报:{“result”:“-8001”,“msg”:“请求网络异常”}或{“result”:80102,“msg”:“预登录异常”}

①确认so库是否按照您项目中的架构导入对应的so库,或者项目是否配置了jni路径。
②电信3g网络不支持取号。

**4.今日头条框架导致的适配问题
如果使用今日头条适配框架出现界面错乱问题,需要过滤授权页:AutoSizeConfig.getInstance().getExternalAdaptManager().addCancelAdaptOfActivity(ShanYanOneKeyActivity.class).addCancelAdaptOfActivity(CmccLoginActivity.class).addCancelAdaptOfActivity(LoginAuthActivity.class);
如果授权页是透明的,需要把授权页前一个activity也加入过滤。

5.“公网IP无效”
1. 如果是纯4G状态下出现公网IP无效,请检查您的运营商接入点名称(APN)是否是net接入点,如果是4G+wifi状态下,建议您换台机型试一下。
2. 双开情况强开流量通道失败,需单开流量。
3. 号码欠费。

6.WiFi+4G预取号失败

因为预取号必须使用数据流量。部分OPPO机型,WiFi+4G环境下第一次使用无法强切到数据流量,个别6.0系统机型,WiFi+4G一直无法切换到数据流量,预取号会返回失败,需使用纯4G网络。

系统适配问题

一、webview适配

1.** java.lang.RuntimeException: Using WebView from more than one process at once with the same data directory is not supported**
2.java.lang.NullPointerException: Attempt to invoke virtual method 'java.lang.CharSequence** android.widget.TextView.getText()’ on a null object reference
3.resultCode
":200025,authType:0,authTypeDes:其他,resultDesc:发生未知错误

解决方案:在Application onCrete中调用下面方法(必须放到初始化之前)示例:

 @RequiresApi(api = 28)
    public void webviewSetPath(Context context) {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
            String processName = getProcessName(context);
            if (!getApplicationContext().getPackageName().equals(processName)) {//判断不等于默认进程名称
                WebView.setDataDirectorySuffix(processName);
            }
        }
    }
 
    public String getProcessName(Context context) {
        if (context == null) return null;
        ActivityManager manager = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE);
        for (ActivityManager.RunningAppProcessInfo processInfo : manager.getRunningAppProcesses()) {
            if (processInfo.pid == android.os.Process.myPid()) {
                return processInfo.processName;
            }
        }
        return null;
    }

问题分析:android P之后不支持同时使用多个进程中具有相同数据目录的WebView,因为SDK内部有使用到webview加载协议,如果客户端存在多进程,需要为不同进程webView设置不同目录。

二、横竖屏适配

1.Only fullscreen opaque activities can request orientation
2.android.util.SuperNotCalledException Activity {com.mlwx.fallinlove/com.cmic.sso.sdk.activity.LoginAuthActivity} did not call through to super.onCreate()
解决方案:弹框或者透明主题,授权页不能指定方向。如需指定方向,可以指定授权页前个页面的方向,授权页设置跟随前个界面方向,即:“android:screenOrientation=“behind””

问题分析:在8.0系统版本上,只有全屏不透明的activity才能指定方向

常规问题

1.怎么在安卓授权页页面底部添加协议?【底部+自定义协议、底部+用户协议】
运营商协议不必手动添加,SDK已封装为第一条协议,通过给定的方法用可以添加自己的协议,最多添加三条。

2.授权页的加载loading怎么自定义?【自定义loading】
221版本之前不支持自定义,221版本可按照文档给的setLoadingView方法传入自定义loadingview布局,实现自定义loading;如果不想要loading,参数传入new View(context)即可。

3.授权页上的【其他方式登录】按钮,如何定义点击后的行为?【其他方式登录】
SDK默认不提供其他方式登录按钮,需要按照文档手动设置自定义控件

4.是否需要获取READ_PHONE_STATE权限【READ_PHONE_STATE】
建议开发者申请本权限,本权限只用于移动运营商在双卡情况下,更精准的获取数据流量卡的运营商类型,
缺少该权限,存在取号失败概率上升的风险。

5.资源压缩后找不到ID?【Resource ID】
项目中使用资源压缩的,需要配置对以下R文件的过滤:

"R.anim.umcsdk*",
"R.drawable.umcsdk*",
"R.layout.layout_shanyan*",
"R.id.shanyan_view*",

iOS问题

高频问题


1.移动报 获取移动token失败 Code=1003 “(null)” UserInfo={desc=****错误的请求签名, resultCode=103101}
【获取token失败、错误的请求签名、103101】
工程中的Info.plist中添加bundleId对应的key-value。搜索Xcode项目工程中的.strings国际化文件,如果app存在本地国际化文件**,**请在每个本地国际化文件中添加CFBundleIdentifier,各个语言版本文件中都需要添加。

image.png

2.移动报错[UASDKLogin getAuthorizationWithModel:complete:] has nil model or nil model.currentVC has nil model or nil model.currentVC
请检查拉起授权页接口配置参数传参,传入模型是否为空或者传入的baseUIConfigure.viewController是否为当前控制器

3.拉起授权页面方法无回调【拉不起授权页面、授权页+无回调、授权页+无反应】

  • 请检查拉起授权页接口配置参数传参,传入模型是否为空或者传入的baseUIConfigure.viewController是否为当前控制器
  • 确认配置是否传入vc,拉起页面时vc必须为当前正在显示的vc;若传self,需确认当前self就是当前vc;对于从后台启动等方式需要立即拉起授权页的,需确认调用时机是否为当前vc已经显示出来再调方法
  • 在页面加载完成时 再调用拉起时候去页面方法,不建议APP启动时直接在viewDidLoad方法中直接调用,建议在授权页面加载完成之后调用,如:在viewDidLoad中添加延时加载或直接在viewDidAppear中调用拉起授权页面方法。

4.何时手动销毁授权页 【手动销毁授权页、授权页释放时机】

  • 关闭授权页时机

a.SDK拉起授权页方法 直接回调失败时
      b.置换手机号有返回结果时

  • 当前页面直接销毁
[self.PresentedViewController dismissViewControllerAnimated:YES completion:nil];
  • 找到topVC进行dismiss
dispatch_async(dispatch_get_main_queue(), ^{
    //建议使用授权页面配置对象传入的viewcontroller 调 dismiss
    if (self.navigationController.viewControllers.lastObject.navigationController) {
        [self.navigationController.viewControllers.lastObject dismissViewControllerAnimated:YES completion:nil];
    } else {
        UIViewController *topRootViewController = [[UIApplication  sharedApplication] keyWindow].rootViewController;
        // 在这里加一个这个样式的循环
        while (topRootViewController.presentedViewController) {
            // 这里固定写法
            topRootViewController = topRootViewController.presentedViewController;
        }
        // 然后再进行present操作
        [topRootViewController dismissViewControllerAnimated:YES completion:nil];
    }
});

5**.ATS开关(Http与Https) 【http+白名单、禁用http、App Transport Security、ATS
****报错信息:The resource could not be loaded because the App Transport Security policy requires the use of a secure connection.

屏幕快照 2019-06-24 下午4.23.05.png
**
处理方式:
1.info.plist中添加App Transport Security Settings->Allow Arbitrary Loads->YES

屏幕快照 2019-06-24 下午4.18.52.png
**
2.配置白名单
目前运营商个别接口为http请求,对于全局禁用Http的项目,需要设置Http白名单。以下为运营商http接口host名单:.cmpassport.com、id6.me.wostore.cn、mdn.open.wo.cn、*.zzx9.cn,*为通配符,建议按以下方式配置Info.plist

<key>NSAppTransportSecurity</key>
	<dict>
		<key>NSExceptionDomains</key>
		<dict>
			<key>zzx9.cn</key>
			<dict>
				<key>NSIncludesSubdomains</key>
				<true/>
				<key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key>
				<true/>
			</dict>
			<key>cmpassport.com</key>
			<dict>
				<key>NSIncludesSubdomains</key>
				<true/>
				<key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key>
				<true/>
			</dict>
			<key>id6.me</key>
			<dict>
				<key>NSIncludesSubdomains</key>
				<true/>
				<key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key>
				<true/>
			</dict>
			<key>wostore.cn</key>
			<dict>
				<key>NSIncludesSubdomains</key>
				<true/>
				<key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key>
				<true/>
			</dict>
			<key>mdn.open.wo.cn</key>
			<dict>
				<key>NSIncludesSubdomains</key>
				<true/>
				<key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key>
				<true/>
			</dict>
		</dict>
	</dict>

崩溃问题

1.联通崩溃【联通+崩溃、资源找不到】
测试过程中 移动、电信正常,联通卡运行项目时直接崩溃,请检查项目中**sdk_oauth.bundle**资源文件是否正常copy导入

2.联通预取号崩溃【预取号+联通+崩溃、NSDictionary + setObject、空指针】
联通SDK内部会读取校验info.plist文件中Bundle identifier、Bundle name、Bundle versions string, short、Bundle version字段,如未配置相关字段Value会导致以下崩溃
image.png

image.png**

3.运行Terminating app due to uncaught exception 'NSInvalidArgumentException', reason: '-[CLSDKInitModel cl_modelInitWithCoder:]: unrecognized selector sent to instance** 错误 
【运行报错、编译报错****】**

  • 添加OtherLinkerFlags-force_load并添加framework路径,参考 Xcode配置添加-force_load
  • 或工程项目->Genaral->Linked Frameworks and Libraries 中添加CL_ShanYanSDK.framework

4. iOS12.0beta版系统奔溃问题 【12.0beta+ 崩溃】

  • 问题描述:所有12.0 beta版本找不到serviceSubscriberCellularProviders系统方法导致[CTTelephonyNetworkInfo serviceSubscriberCellularProviders]: unrecognized selector send to  instance崩溃

5. iOS13.0beta版系统奔溃问题 【13.0beta+ 崩溃】

  • 问题描述:所有13.0 beta版本[UIApplication valueForKey@“statusBar”]:崩溃
  • 解决方案:2.1.3到2.2.0.3之间版本(包含),需接入方手动加入版本判断,当判断为iOS13.0系统时跳过闪验。从2.2.0.4版本开始sdk内部使用兼容方式修复

**

常规问题

1.编译报 ld: 38 duplicate symbols for architecture arm64 ****clang: error: linker command failed with exit code 1 (use -v to see invocation)编译报错、OtherLinkerFlags、framework路径错误
OtherLinkerFlags项去掉-all_load添加-force_load并添加framework路径,参考 Xcode配置添加-force_load

2.运行报**Terminating app due to uncaught exception 'NSInvalidArgumentException', reason: '-[CLSDKInitModel cl_modelInitWithCoder:]: unrecognized selector sent to instance**** 错误
【运行报错、编译报错】**
添加OtherLinkerFlags-force_load并添加framework路径,参考 Xcode配置添加-force_load

3.报 403000 6006 请求非法,签名验证不通过 【请求非法、签名验证通不过、验签失败、403000、6006】

  • 替换Demo中appid/appkey和bundleID为自己申请的,运行Demo确定Demo是否可以正常完成流程,如果不能,请联系客服。
  • 如果Demo正常运行,用开发者自己的工程运行报403000,请检查最后一步用获取到的token调用手机号查询API是,是否是以form-data格式发送参数:使用AFN或者Alamofire直接发送completeResult.data,使用原生NSURLSession请将completeResult.data的每个字段值进行URLEncode编码再拼接成form-data格式字符串(“key1=value1&key2=value2&…”)再发送,Objc版Demo内有两种方式发送的示例代码
  • 关于如何确定最终是否以formData形式发送,可以使用charls抓包工具,查看request的headers里的Content-Type是否为application/x-www-form-urlencoded,以及completeResult.data的sign字段带有 + 号时 + 号丢失的情况
  • 如果开发者后台已经接入手机号查询API,请开发者后台也确认后台的发送格式

**4.移动连续报1005 获取移动token失败, ****resInfoDict,{desc = "request is time out.";resultCode = 200023;}**200023、time out、超时
运营商限制不允许短时间内连续多次频繁调用登录接口,请过段时间再试,测试时不要短时间内频繁调用

5.移动报 获取移动token失败 Code=1003 “(null)” UserInfo={desc=****错误的请求签名, resultCode=103101}【获取token失败、错误的请求签名、103101】
工程中的Info.plist国际化文件,添加bundleId对应的key-value。如果app存在本地国际化文件
,**请在每个本地国际化文件中添加CFBundleIdentifier,各个语言版本文件中都需要添加。

6.****关于频繁调用 【频繁调用、操作频繁】
为了防止恶意刷量攻击,SDK从v2.1.1开始,会限制拉起授权页的调用频率,在短时间内,多次调用将会报频繁操作

7.集成sdk后app包体增量 【bitCode、包体大小、包体增量】
release模式,bitCode为NO,developmentTarget 8.0+ 下,ipa增量约950Kb。

8.其他移动端开发框架或平台支持说明 【跨平台开发、插件集成、支持平台】
理论上凡支持调用原生代码模块的平台或框架,都可以集成闪验SDK,集成方式参考各框架中调用原生代码或制作原生插件教程。目前已确认支持的平台有ReactNative、Weex、Flutter、Hbuild

9.iOS****系统集成一键登录时,内嵌的协议页面中无法执行脚本吗? 【协议打不开、协议页面加载失败】
213版本及之前只支持纯H5链接,如果有js脚本可能导致协议页面web加载异常

10.是否支持控制自由关闭授权页,方便我们逻辑的衔接 【授权页销毁、手动销毁授权页】
213版本之前不支持,213及之后版本支持

11.是否支持BitCode 【bitcode】
支持

12.置换手机号时报错 【置换手机号报错、token非法、105312】
[{String:“300011885619”},{String:“STsid00000015591314406938cJcYsd0Hbwue4002SE2qxYcF0NCpNFk”}]–result:{“code”:-6,“message”:“token非法”,“success”:false}或{“resultCode”:“105312”,“taskId”:“ea913ef63aa7430f97e8e1603e2cc290”}
三大运营商token置换手机号码时的接口分别有对应的url,需要调用相对应的地址。

13.关于重签名打包【重签名】
sdk读取的是工程中的_CFBundleIdentif_ier,请确保项目工程中配置的_CFBundleIdentif_ier与闪验后台申请的BundleID一致即可

14.220版本CheckBox隐藏时电信用户提示“请勾选协议”【CheckBox、CheckBox 隐藏、请勾选协议】
闪验授权登录页各运营商协议默认勾选,用户可自行设置默认状态且勾选框CheckBox默认不隐藏。当用户设置checkBox隐藏时,电信用户登录就会提示“请勾选协议”,导致用户无法进行登录操作。
暂处理方式:设置checkbox显示,同时checkBox开放了一个尺寸设置属性,只要单独设置checkBox的size为{0,0}即可达到隐藏checkbox的目的

15.2204版本出现网络服务异常 failure:Error Domain=EAccountError Code=30910 “(null)” UserInfo={result=30910, msg=topClass not found in config, responseData=null}
原因是运营商或我们后台配置的问题

16.置换手机号:签名验证不通过
SDK返回的device字段或其他字段用户端传入到后台的时候空格被处理了,导致签名验证通不过。

17.跳转隐私协议:导航条有黑边
在appdelegate中的didFinishLaunchingWithOptions方法中的[self.window makeKeyAndVisible];上面加上self.window.backgroundColor = [UIColor whiteColor]。
**

服务端问题

1.错误**:appId不能为空**
{“message”:“请求非法,appId不能为空”,“code”:“403000”}
问题排查方案:
检查是否传入appId字段。请求数据格式是否正确,本接口不支持发送JSON格式数据。
问题解决方案:
首先,请核对字段名称无误,使用正确的字段名。
其次,请确保请求使用POST方法,参数放到RequestBody中以application/x-www-form-urlencoded或multipart/form-data提交
 
**2.错误请求非法,签名验证不通过
{“message”:“请求非法,签名验证不通过”,“code”:“403000”}
问题排查方案:
请确保签名生成无误。
问题解决方案:
1、首先确保使用了正确的应用对应的appKey。
2、其次请确保签名方式正确,签名字段的值由客户服务端生成,签名算法 hmacSHA256(所有传入参数按字段名排序后拼接的字符串,应用appKey) 后再进行16进制字符串转换的值。
 **
3.返回参数mobileName密文无法解密
问题排查方案:
确认接口传入参数是否传入了encryptType字段,encryptType字段值:0 AES算法 、1 RSA算法,不传默认AES算法,检查对应的解密函数是否正确。
问题解决方案:
1、如使用AES算法,则确认使用了应用对应的正确的appKey解密。
2、如使用RSA算法,则确认创建应用时是否填写了RSA公钥,并使用了填入的RSA公钥对应的私钥解密。

4.错误:权限校验失败
{“code”:“500000”,“chargeStatus”:0,“message”:“权限校验失败”}
问题排查:
确认是否为电信运营商
问题解决方案:
如果为电信运营商,那么请将交易流水号记录并联系闪验客服运营人员处理。