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

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

 

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

一、集成(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文件中配置:


    <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"/>
    <application
        android: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 ...>
    <application
        android: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() {
        @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地址

 

评论 19
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值