原文地址：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内核常用功能使用说明
网友评论