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() {            @Override            public void onCoreInitFinished() {                Log.e("snow", "========onCoreInitFinished===");            }            @Override            public void onViewInitFinished(boolean b) {            //加载x5内核成功返回值为true，否则返回false，加载失败会调用系统的webview                Log.e("snow", "x5初始化结果====" + b);            }        });

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

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"?>

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() {        @Override        public void onCallBackAction(Integer integer, Object o, Object o1) {        }    };    @Override    protected 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地址

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

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

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

更多相关文章

随机推荐