Android 使用腾讯的TBS浏览器X5内核的集成加载pdf等文件

我们正常项目使用原生webview加载h5页面也是没问题的，但是当使用原生webview加载h5出问题了，h5地址在微信等可以正常使用，前端就会丢锅给我们，为了杜绝不是我们Android的问题，那我们也集成TBS浏览器X5内核替换原生webview。。。

腾讯的TBS浏览器X5内核（文章中统一简称X5内核）的优点直接看文档介绍就有，文章主要将集成点和加载X5内核失败怎么解决、在应用内打开pdf等文件的功能（此功能官方文档没有）；关于官方文档和sdk下载看下面链接：

腾讯TBS官网接入步骤
SDK下载
TBS浏览服务SDK接入问题
github集成Demo

一、集成（Android studio 依赖库集成）

关于jar包集成方法自行参考文档或者百度吧！

1、在app的build.gradle中添加

dependencies {//x5内核Sdk=====在下载sdk说明处有直接复制api 'com.tencent.tbs.tbssdk:sdk:43697'
}

2、在application类中添加：

          //下载x5内核，可以不需要，因为会共用其他软件的x5内核，比如微信、QQ等         QbSdk.setDownloadWithoutWifi(true);QbSdk.initX5Environment(this, new QbSdk.PreInitCallback() {@Overridepublic void onCoreInitFinished() {Log.e("snow", "========onCoreInitFinished===");}@Overridepublic void onViewInitFinished(boolean b) {//加载x5内核成功返回值为true，否则返回false，加载失败会调用系统的webviewLog.e("snow", "x5初始化结果====" + b);}});

3、在AndroidManifest.xml文件中配置：

<uses-permission android:name="android.permission.INTERNET" /><uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" /><uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" /><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /><uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /><!-- 硬件加速对X5视频播放非常重要，建议开启 --><uses-permission android:name="android.permission.GET_TASKS"/><applicationandroid:usesCleartextTraffic="true"android:hardwareAccelerated="true"></application>

4、使用x5内核的webview替换原生webview，使用方法一致，这里就不贴代码了，可以直接去demo中查看

到这里就集成完成了，运行查看application是否返回true，要是返回true那恭喜你很顺利完成了集成，要是返回false，那继续往下看

二、集成遇到的问题排查：

1、使用写的webview加载链接：

http://soft.imtt.qq.com/browser/tes/feedback.html

显示结果000000表示加载的是系统内核，显示大于零的数字表示加载了x5内核（该数字是x5内核版本号）

2、使用 写的webview加载链接：

http://debugtbs.qq.com

2.1、加载成功如下图

2.2、加载失败提示：请检查网络是否可用

你的手机应该是9.0以上的系统：google从Android 9.0开始，默认情况下禁用明文支持。因此http的url均无法在webview中加载

在AndroidManifest.xml添加属性android:usesCleartextTraffic="true" 如下：

<?xml version="1.0" encoding="utf-8"?>
<manifest ...><applicationandroid:usesCleartextTraffic="true"...></application>
</manifest>

3、记载自测链接成功后，最好先点击“安装线上内核”下载内核，然后重启页面后点击“合作方加载检测”，查看提示：

3.1、加载内核成功：

3.2、加载失败检测原因：如：下面这个提示就是64位手机不能加载x5内核，x5内核目前只支持32位

x5内核不支持64位的解决方法：

官方关于x5内核64位手机不能使用解决方案

出现其他问题都可以通过检测查看哪里出了问题；

三、关于使用x5内核加载pdf等文件

几点重要提示：

1、加载文件核心类是 TbsReaderView，腾讯文档没有写，TbsReaderView建议通过动态创建，不要使用xml中引用；

2、TBS目前只支持加载本地文件。所以远程文件需要先下载，后用TBS加载文件显示；

3、加载文件的界面，离开本界面之后务必销毁TbsReaderView，否则再次加载文件无法加载成功，会一直显示加载文件进度条；代码如下：tbsReaderView.onStop();

加载文件我直接贴代码了

重点核心代码：

private void openFile() {File file = new File(url);if (!file.exists()) {Toast.makeText(this, "文件不存在", Toast.LENGTH_LONG).show();}Bundle bundle = new Bundle();bundle.putString("filePath", url);bundle.putString("tempPath", Environment.getExternalStorageDirectory().getPath());boolean result = tbsReaderView.preOpen(parseFormat(parseName(url)), false);if (result) {tbsReaderView.openFile(bundle);}}private String parseFormat(String fileName) {return fileName.substring(fileName.lastIndexOf(".") + 1);}private String parseName(String url) {String fileName = null;try {fileName = url.substring(url.lastIndexOf("/") + 1);} finally {if (TextUtils.isEmpty(fileName)) {fileName = String.valueOf(System.currentTimeMillis());}}return fileName;}TbsReaderView.ReaderCallback readerCallback = new TbsReaderView.ReaderCallback() {@Overridepublic void onCallBackAction(Integer integer, Object o, Object o1) {}};@Overrideprotected void onDestroy() {super.onDestroy();//销毁界面的时候一定要加上，否则后面加载文件会发生异常。tbsReaderView.onStop();}

调用代码：

tbsReaderView = new TbsReaderView(this, readerCallback);rlRoot.addView(tbsReaderView, new RelativeLayout.LayoutParams(RelativeLayout.LayoutParams.MATCH_PARENT, RelativeLayout.LayoutParams.MATCH_PARENT));openFile();

到此完成了x5内核的集成和打开文件的功能！感觉有用给一个star支持下！

demo地址