【转载】腾讯TBS SDK 近期热点问题汇总

原文地址：https://docs.qq.com/doc/DYW9QdXJNWFZnbVdz

最新 SDK：44153

一、 近期热点问题：（2022.1.20）

1、SDK版本更新（Maven Central接入）：api 'com.tencent.tbs:tbssdk:44153'

2、（问题更新）首次安装应用，一直加载不起 X5 内核？

首次安装应用时，本应用下没有内核，通常会触发异步内核下载，此时本App下没有x5内核可用，将采用系统内核，下次启动再使用下载的内核。

image.png

二、 历史常见问题：

2.1 隐私合规相关

1、TBS SDK是否有隐私合规相关说明？

请使用最新版TBS SDK 44153，官网下载包内提供了隐私合规说明文档https://x5.tencent.com/docs/privacy.html以及隐私接口调用说明文档

2.2 SDK接入及内核下载相关

1、可以通过什么渠道获取TBS最新版本SDK？

方式一：通过官网下载，手动接入 https://x5.tencent.com/tbs/sdk.html

方式二：MavenCentral接入。在根目录 build.gradle 添加 mavenCentral() 库索引，在模块中引入依赖：api 'com.tencent.tbs:tbssdk:44115'

ps：使用方式二时，请阅读隐私文档（https://x5.tencent.com/docs/privacy.html 及 官网下载包内的隐私接口使用文档

2、（更新）首次安装应用，一直加载不起 X5 内核？

首次安装应用时，本应用下没有内核，通常会触发异步内核下载，此时本App下没有x5内核可用，将采用系统内核，下次启动再使用下载的内核。

image.png

3、经常遇到因为流控而导致无法下载到内核的情况，如何优化解决？

由于庞大的用户量，对于X5下载内核会有带宽压力，后台会根据当前的流量情况去流控请求，稍后再试。建议优化：请求SD卡授权，加载稳定备份内核。

4、本地无内核可用，且TbsListener.onDownLoadFinished()返回错误码 110 ？

该情况在本地无内核时，大概率命中了流控，可通过debugtbs.qq.com手动安装线上内核。

5、是否有静态内核接入方案？

静态接入版本已不再维护与发布，请接入官方最新动态下发内核的SDK版本。

6、多次卸载重装、重启都加载不了内核，通过 debugtbs.qq.com 也下载不了，显示“不需要下载”？（已解决，遇到此问题 Q群请联系 腾讯开发-ater）

A：大概率是DNS出现了问题，尝试链接 Wi-Fi，并调整手机 DNS代理至 114.114.114.114

7、周五周六（18:00-21:00）debugtbs.qq.com下载不了内核？

A：服务器维护期不支持下载。

2.3 常见内核加载问题

1、内核已经下载却加载不起来？debugtbs.qq.com能看到内核信息，但打不开debugx5.qq.com？

A：自查一下是否调用了QbSdk.forceSysWebView()

2.4 x5调试相关

1、如何查看TBS相关信息？如何进行TBS调试？

使用设置了 WebViewClient 的TBS SDK的 webview 打开 https://debugtbs.qq.com，会出现 TBS调试工具页面。

2、下载不到内核时，如何获取并加载内核？

使用debugtbs.qq.com工具，点击安装线上内核。若提示115，在周五周六晚属于正常运维，或者此时环境为x86模拟器等x5内核不支持的环境，请使用真机再次尝试。

2.5 其他能力相关

1、已经实现了CustomView相关方法，但使用TBS SDK的webview时，h5视频全屏按钮不生效？

该问题为系统内核下的已知问题，并于44085版本SDK中修复。

2、使用文件能力的插件依赖于x5内核，但内核有加载失败的情况怎么办？

参考 2.4、2.5，建议通过：

（1）首次打开应用尽量在wifi下

（2） 调用QbSdk.setDownloadWithoutWifi允许4G下载

（3）获取sdcard存储权限使用备份稳定内核

等手段提高x5占比来规避系统内核情况。

3、“插件加载失败” ？

a. app内进入http://debugx5.qq.com,点击第二个“信息”，拉到下面点击“清理本地插件”

b. 手机设置-应用管理-强制停止或结束运行 本app

三、 X5内核常用功能使用文档

【腾讯文档】X5内核常用功能使用说明

https://docs.qq.com/doc/DSndPaG5SSkdDUmxZ