产生原因：开发者打开混淆开关，但是没有配置混淆过滤文件
解决方案：请按照文档混淆规则部分核查
产生原因：创建应用时填写的包名/包签名与当前运行APP的不一致
解决方案：确认好所需要的正确的包名/包签名，①如果创建应用时填写错误，请联系运营人员或者重新创建个正确的应用；②如果填写无误，项目配置错误，请按照文档创建应用部分核查
产生原因：so库未引用到或so库版本与SDK版本不对应
解决方案：
①2.3.4.3之前版本请按照下面提示核查so库路径，并确保放入的so库与aar包版本相同 
②2.3.4.3及之后版本，so库已打入aar包中。如果是更新SDK后报错，请删除libCtaApiLib.so、libShanYCore.so。
产生原因：适配框架导致SDK内置界面和app界面获取到的density发生变化 ，导致原有控件和自定义控件参考系不一样。
解决方案：
①如果使用今日头条适配框架出现界面错乱问题，需要过滤授权页：AutoSizeConfig.getInstance().getExternalAdaptManager().addCancelAdaptOfActivity(ShanYanOneKeyActivity.class).addCancelAdaptOfActivity(CmccLoginActivity.class).addCancelAdaptOfActivity(LoginAuthActivity.class);
如果授权页是透明的，需要把授权页前一个activity也加入过滤。
②如果使用JessYanCoding适配，需要过滤调用拉起授权页的界面
AutoSize.autoConvertDensityOfGlobal(MainActivity.this);
③如果是修改系统文字大小后不适配，可以设置字体大小单位用dp，ShanYanUIConfig 中配置setTextSizeIsdp(true)
④目前部分折叠屏手机和分屏显示时，界面适配可能会有问题，暂时没有优化方案。
产生原因：取号原理依赖数据流量，①部分OPPO机型，WiFi和数据流量双开情况下无法使用数据流量，②个别6.0系统机型，系统不支持CHANGE_NETWORK_STATE权限目前统计到的机型如下： 
解决方案：不支持WiFi+数据网络；请关闭WiFi，使用纯数据网络取号
①ShanYanUIConfig配置中，调用：setCheckBoxTipDisable(true);（true：关闭，false：开启，默认：false）
②传一个空的toast对象，调用示例： 
按照文档给的setLoadingView方法传入自定义loadingview布局，调用示例： 
如果需要隐藏loading，传setLoadingView(new RelativeLayout(context))。
如果是插件集成想隐藏loading，需要传空的xml文件，以flutter为例： 
①不授权READ_PHONE_STATE权限，有什么影响？
建议开发者申请本权限，本权限只用于日志服务，比如线上某个客户取号失败，可以辅助查询失败原因，去掉后不影响取号成功率，只影响日志服务。
②是否可以去掉CHANGE_WIFI_STATE权限？
该权限仅用于WiFi+数据网络双开的情况下，提高OPPO机型6.0-9.0系统取号成功率。因为部分OPPO机型，系统底层不支持WiFi+数据网络双开情况下指定使用数据网络，而取号必须在数据网络下进行，所以使用该权限触发系统弹出授权数据网络的弹窗，提高取号成功率。调用SDK初始化方法成功后，并且预取号没有成功过（如首次安装应用）时，会触发一次。
产生原因：资源被压缩，
解决方案：需要添加过滤：“R.anim.umcsdk*”, “R.drawable.umcsdk*”, “R.layout.layout_shanyan*”, “R.id.shanyan_view*”,
①如果配置了shrinkResources true（注意：flutter插件默认配置了），需要把true改false，即：zipAlignEnabled false。如果需要设置shrinkResources true则要在raw/keep里面配置资源过滤。keep.xml添加示例： 
②如果项目中使用AndResGuard资源压缩，需要在module的build.gradle中添加资源过滤。添加示例： 
必须使用setPrivacyState设置，true：选中；false：未选中，默认：true；
不能使用 OneKeyLoginManager.getInstance().setCheckBoxValue(false);
①弹窗样式背景黑屏效果如下： 
②导航栏有黑条遮挡，效果如下：
解决方案：修改AndroidManifest.xml中授权页activity的主题theme，可以参考示例demo源码中的主题配置
通过addCustomPrivacyAlertView添加，具体实现可以参考SDK包中的demo示例源码，A配置示例部分，如下：
报错信息：
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”:“发生未知错误”
产生原因：android P行为变更，不支持同时使用多个进程中具有相同数据目录的WebView，因为SDK内部有使用到webview加载协议，如果客户端存在多进程，需要为不同进程webView设置不同目录
解决方案：在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;
}
报错信息：
1.Only fullscreen opaque activities can request orientation
2.Attempt to invoke virtual method ‘com.cmic.sso.sdk.d.b com.cmic.sso.sdk.a.a()’ on a null object reference
com.cmic.sso.sdk.view.LoginAuthActivity.onCreate(LoginAuthActivity.java:104)
3.java.lang.NullPointerException:Attempt to invoke virtual method ‘com.cmic.sso.sdk.d.b com.cmic.sso.sdk.a.a()’ on a null object reference
4.android.util.SuperNotCalledException Activity {com.mlwx.fallinlove/com.cmic.sso.sdk.activity.LoginAuthActivity} did not call through to super.onCreate()
产生原因：在8.0系统版本上，只有全屏不透明的activity才能指定方向
解决方案：弹框或者透明主题，授权页不能指定方向。如需指定方向，可以指定授权页前个页面的方向，授权页设置跟随前个界面方向，即：“android:screenOrientation=“behind””
在ShanYanUIConfig对象中通过setcheckBoxOffsetXY(10,5)方法设置，该方法可以设置checkbox在协议框父控件中的位置，包含两个参数：1.左偏移量 2.上偏移量（默认：在父控件内居中）
在ShanYanUIConfig对象中通过setCheckBoxMargin(10,10,10,10)方法设置，该方法可以设置checkbox热点局域范围，包含四个参数：1.向左扩大 2.向上扩大 3.向右扩大 4.向下扩大（默认：各10dp），调整协议与文字间的距离即修改第三个参数的值。
产生原因：第一次拉起的授权页没有销毁，又重新调用了拉起授权页
解决方案：等上次拉起的授权页销毁后，才能再次调用拉起授权页方法；如果已经调用了销毁授权页方法仍报该错，可能是因为授权页销毁后回到的界面onStart或者onResume执行耗时操作，阻塞了授权页的onDestroy，导致授权页销毁延迟，请核查修改耗时操作。
注：开启SDK的log开关，用ActivityLifecycleShanYanTask可以过滤生命周期
产生原因：调用的时机不对
解决方案：需要在初始化方法调用之前调用（单位：秒）：OneKeyLoginManager.getInstance().setTimeOutForPreLogin(10);
解决方案：一般点击第三方登录按钮的时候，增加一个中转页，即启动一个透明的或者无界面的activity，在这个activity里面做相关授权处理
产生原因：①授权页activity未配置正确②资源被压缩③两个自定义view使用了相同的控件
解决方案：日志里面会有捕获到的异常日志，按照日志确认是哪种情况导致的
如果是①：请按照对应版本的集成文档核对AndroidManifest里面授权页activity配置（核对activity名称及包名）
如果是②：请按照问题10解决方案排查
如果是③：自定义view的控件不能复用，需要分别创建
产生原因：某些版本的听云SDK的嵌码操作会对SDK的编译造成影响，报错如下：
解决方案：更新听云SDK到2.14.10版本（maven依赖方式可能没有这个版本，需要下载听云SDK包本地集成）
初始化有网络即可；预取号、获取token分两种情况：
一、首次调用：
①预取号：
移动、联通、电信都必须开启数据流量
②获取token（预取号已成功）：
移动：必须有网络（WiFi、数据网络均可）
联通、电信：
a.预取号有效期内：不需要网络，必成功
b.预取号失效：必须开启数据流量
二、非首次（成功过）：
①预取号：
移动：只要有网络就可以成功
联通、电信：
a.预取号有效期内：不需要网络，必成功
b.预取号失效：必须开启数据流量
②获取token：
移动：必须有网络（WiFi、数据网络均可）
联通、电信：
a.预取号有效期内：不需要网络，必成功
b.预取号失效：必须开启数据流量
①由于系统层限制，部分OPPO、vivo、一加机型，WiFi+数据网络环境下必须手动授予数据流量权限才能使用数据网络，而取号（无缓存的情况下）必须使用数据网络才能成功，所以如果没有手动授予数据流量权限时取号会失败；
②部分6.0系统在系统层不支持CHANGE_NETWORK_STATE权限，目前统计到的机型有：
| 机型 | 系统 |
|---|---|
| 红米 Note 4X（Redmi Note 4X） | 6.0 |
| 红米 Note 4X（Redmi Note 4） | 6.0 |
| 华为荣耀 7 (PLK-AL10) | 6.0 |
| 华为mate7（MT7-TL10） | 6.0、6.0.1 |
| 荣耀畅玩5X（KIW-AL10） | 6.0.1 |
| 华为麦芒4（RIO-AL00） | 6.0.1 |
| 华为P8（GRA-UL10） | 6.0 |
| 华为P8max（P8max） | 6.0 |
| 乐视（Le X620） | 6.0 |
| 华为 Mate 8（NXT-AL10） | 6.0 |
| 红米Pro(Redmi Pro) | 6.0 |
产生原因：授权页activity配置错误。
解决方案：按照集成文档核查AndroidManifest.xml中授权页activity配置
产生原因：版本升级导致的so库文件未引用到，或者so库版本跟SDK版本不对应
解决方案：按照升级指南核查so库配置
产生原因：授权页activity未配置正确
解决方案：按照文档核查授权页activity的包名、类名是否配置正确
答：2.3.3.5之前版本可能存在获取频繁的问题；2.3.3.5-2.3.4.7版本一次安装只获取一次，隐私协议中有列举该字段；获取MAC地址的用处是提供日志服务，如线上某个客户取号失败，可以根据Mac辅助定位该客户设备，方便查找失败原因，一般不建议关闭。如果比较在意Mac获取或者不需要该日志服务，可以调用方法关闭，关闭后不影响取号功能，只影响日志服务。关闭方法：初始化之前调用OneKeyLoginManager.getInstance().getMaEnable(false); 2.3.4.8及之后版本已经移除。
产生原因：①app中存在hook系统获取ip地址api的操作，导致SDK取到的IP不准确，取号时通过IP做安全校验失败②取号被运营商标记为风险取号
解决方案：①核查代码中是否有hook系统获取ip的方法，可以用同一台手机在相同网络环境下，安装获取IP列表安装包，获取一组ip地址；再在自己app中按照获取ip列表方法.txt获取一组ip地址，比对结果是否一样，如果结果不一样，说明是hook系统api导致的，需要将下面运营商获取ip地址的调用类加hook白名单。②换手机卡或换测试机
电信调用类："cn.com.chinatelecom.account.api.e.d"
移动调用类："com.cmic.gen.sdk.e.p"
联通调用类："com.sdk.base.framework.utils.app.AppUtils"
"com.sdk.l.a"
"com.unikuwei.mianmi.account.shield.e.j"
解决方案：需要将H5中a标签的target改成_self，即在当前窗口中打开，不支持在新窗口打开
产生原因：因为自定协议内部可能会有多级跳转，所以点击返回时SDK内部先判断canGoBack，如果canGoBack为true，则只执行goBack，而不销毁，从而导致点击无反应|不能销毁的情况，
解决方案：需要自己前端开发对协议页做适配。
解决方案：需要将授权页主题theme中style的parent使用系统dialog相关主题，如：
<style name="dialogStyle" parent="Theme.AppCompat.Light.Dialog">
<!--没有标题-->
<item name="windowNoTitle">true</item>
<!--背景透明-->
<item name="android:windowBackground">@android:color/transparent</item>
<item name="android:windowIsTranslucent">true</item>
<!--dialog的整个屏幕的背景是否有遮障层-->
<item name="android:backgroundDimEnabled">true</item>
</style>
产生原因：大概率是物联网卡，或者VPN开启导致的
解决方案：不支持物联网卡取号，不支持连接网络代理取号。
产生原因：①使用APP端集成了第三方网络请求框架，代理了SDK接口请求②设备开启了代理或连接的WiFi有网络链接安全策略限制的场景
解决方案：不支持网络代理取号
【获取token失败、错误的请求签名、103101】
工程中的Info.plist中添加bundleId对应的key-value。搜索Xcode项目工程中的.strings国际化文件，如果app存在本地国际化文件，请在每个本地国际化文件中添加CFBundleIdentifier，各个语言版本文件中都需要添加。
**2.移动报错[UASDKLogin getAuthorizationWithModel:complete:] has nil model or nil model.currentVC **【**has nil model or nil model.currentVC**】请检查拉起授权页接口配置参数传参，传入模型是否为空或者传入的baseUIConfigure.viewController是否为当前控制器
a.SDK拉起授权页方法 直接回调失败时
b.置换手机号有返回结果时
[self.PresentedViewController dismissViewControllerAnimated:YES completion:nil];
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];
}
});
报错信息：The resource could not be loaded because the App Transport Security policy requires the use of a secure connection.
处理方式：
1.info.plist中添加App Transport Security Settings->Allow Arbitrary Loads->YES
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>
测试过程中 移动、电信正常，联通卡运行项目时直接崩溃，请检查项目中sdk_oauth.bundle资源文件是否正常copy导入
联通SDK内部会读取校验info.plist文件中Bundle identifier、Bundle name、Bundle versions string, short、Bundle version字段，如未配置相关字段Value会导致以下崩溃
Terminating app due to uncaught exception 'NSInvalidArgumentException', reason: '-[CLSDKInitModel cl_modelInitWithCoder:]: unrecognized selector sent to instance 错误 **【运行报错、编译报错】
OtherLinkerFlags项-force_load并添加framework路径，参考 Xcode配置添加-force_loadld: 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
Terminating app due to uncaught exception 'NSInvalidArgumentException', reason: '-[CLSDKInitModel cl_modelInitWithCoder:]: unrecognized selector sent to instance 错误【运行报错、编译报错】
添加OtherLinkerFlags项-force_load并添加framework路径，参考 Xcode配置添加-force_load
手机号查询API是，是否是以form-data格式发送参数：使用AFN或者Alamofire直接发送completeResult.data，使用原生NSURLSession请将completeResult.data的每个字段值进行URLEncode编码再拼接成form-data格式字符串（“key1=value1&key2=value2&…”）再发送，Objc版Demo内有两种方式发送的示例代码application/x-www-form-urlencoded，以及completeResult.data的sign字段带有 + 号时 + 号丢失的情况手机号查询API，请开发者后台也确认后台的发送格式1005 获取移动token失败, resInfoDict,{desc = "request is time out.";resultCode = 200023;} 【200023、time out、超时】运营商限制不允许短时间内连续多次频繁调用登录接口，请过段时间再试，测试时不要短时间内频繁调用
工程中的Info.plist国际化文件，添加bundleId对应的key-value。如果app存在本地国际化文件，请在每个本地国际化文件中添加CFBundleIdentifier，各个语言版本文件中都需要添加。
为了防止恶意刷量攻击，SDK从v2.1.1开始,会限制拉起授权页的调用频率，在短时间内，多次调用将会报频繁操作
release模式,bitCode为NO，developmentTarget 8.0+ 下，ipa增量约1.25M。
理论上凡支持调用原生代码模块的平台或框架，都可以集成闪验SDK，集成方式参考各框架中调用原生代码或制作原生插件教程。目前已确认支持的平台有ReactNative、Weex、Flutter、Hbuild
213版本及之前只支持纯H5链接，如果有js脚本可能导致协议页面web加载异常
213版本之前不支持，213及之后版本支持
支持
[{String:“300011885619”},{String:“STsid00000015591314406938cJcYsd0Hbwue4002SE2qxYcF0NCpNFk”}]–result:{“code”:-6,“message”:“token非法”,“success”:false}或{“resultCode”:“105312”,“taskId”:“ea913ef63aa7430f97e8e1603e2cc290”}
三大运营商token置换手机号码时的接口分别有对应的url，需要调用相对应的地址。
sdk读取的是工程中的CFBundleIdentifier,请确保项目工程中配置的CFBundleIdentifier与闪验后台申请的BundleID一致即可
闪验授权登录页各运营商协议默认勾选，用户可自行设置默认状态且勾选框CheckBox默认不隐藏。当用户设置checkBox隐藏时，电信用户登录就会提示“请勾选协议”，导致用户无法进行登录操作。
暂处理方式：设置checkbox显示，同时checkBox开放了一个尺寸设置属性，只要单独设置checkBox的size为{0,0}即可达到隐藏checkbox的目的
原因是运营商或我们后台配置的问题
SDK返回的device字段或其他字段用户端传入到后台的时候空格被处理了，导致签名验证通不过。
在appdelegate中的didFinishLaunchingWithOptions方法中的[self.window makeKeyAndVisible];上面加上self.window.backgroundColor = [UIColor whiteColor]。
此为iOS15之后，iOS系统导航栏原因，客户需要升级SDK版本2.3.5.0之后的版本即可。
/// 统一事件监听方法
/// @param type 事件类型（1：隐私协议点击， 2：协议勾选框点击，3："一键登录"按钮点击）
/// @param code 事件对应序号 type=1时：code：0,1,2,3（协议页序号），message：协议名|当前运营商类型
/// type=2时：code：0,1（0为未选中，1为选中）
/// type=3时：code：0,1（0为协议勾选框未选中，1为选中）
/// @param message 说明：type=1时：message：协议名_当前运营商类型
- (void)clShanYanActionListener:(NSInteger)type
code:(NSInteger)code
message:(NSString *_Nullable)message;
错误原因：105313非法请求，触发了运营商风控，
解决方案：可以多尝试几次飞行模式之后网络重启、手机重启、APP卸载重装，或者换一个手机设备等尝试一下
可配置项：
报错描述：“code”:1003,“errorDesc”:“未能完成操作。（移动预取号失败错误1023。）”,“innerCode”:103111,“innerDesc”:“WAP网关IP错误”,“message”:“移动预取号失败”}
原因：由于苹果系统在 xcode14.3，iOS 16.4系统上废弃了运营商判断的接口，目前我们的SDK通过该接口来判断运营商类型，所以在这种情况下判断运营商会失效；
解决方案：**使用低版本的xcode进行打包 **用 xcode14.2来打包，然后把 xcode14.3的iOS 16.4的包拉到 xcode14.2上，这样可以实现正确判断运营商类型；
{“message”:“请求非法，appId不能为空”,“code”:“403000”}
问题排查方案：
检查是否传入appId字段。请求数据格式是否正确，本接口不支持发送JSON格式数据。
问题解决方案：
首先，请核对字段名称无误，使用正确的字段名。
其次，请确保请求使用POST方法，参数放到RequestBody中以application/x-www-form-urlencoded或multipart/form-data提交
{“message”:“请求非法，签名验证不通过”,“code”:“403000”}
问题排查方案：
请确保签名生成无误。
问题解决方案：
1、首先确保使用了正确的应用对应的appKey。
2、其次请确保签名方式正确，签名字段的值由客户服务端生成，签名算法 hmacSHA256(所有传入参数按字段名排序后拼接的字符串，应用appKey) 后再进行16进制字符串转换的值。
问题排查方案：
确认接口传入参数是否传入了encryptType字段，encryptType字段值：0 AES算法 、1 RSA算法，不传默认AES算法，检查对应的解密函数是否正确。
问题解决方案：
1、如使用AES算法，则确认使用了应用对应的正确的appKey解密。
2、如使用RSA算法，则确认创建应用时是否填写了RSA公钥，并使用了填入的RSA公钥对应的私钥解密。
{“code”:“500000”,“chargeStatus”:0,“message”:“权限校验失败”}
问题排查：
确认是否为电信运营商
问题解决方案：
如果为电信运营商，那么请将交易流水号记录并联系闪验客服运营人员处理。