前言:最近项目需要进行APP内预览文档,看网上说了一堆,发现没几个可用的,Android对这个方便的支持真的太少了,最后锁定了腾讯的TBS X5内核,有兴趣的同学可以去官网看看。官方文档过于简洁~对于新手来说真的太痛苦了,这里做一下总结吧,针对文档预览的功能,因为我现在主要涉及到这部分。~希望可以对大家集成TBS有点帮助。
集成TBS的坑:大概的集成就不说了 网上一堆的集成方式,官网也有说明:(这里集成的是最新版的 43903版本 2020-07-21)
然后在Application里初始化:
在AndroidManifest.xml中增加内核首次加载时优化Service声明:
以上步骤就完成了X5的初始化操作,然后你就可以使用强大的X5内核了。
加载文档使用到 TbsReaderView,这里TbsReaderView要动态添加不能直接写在XML里,否则会报错。而且容器最好使用Fragment
然后就是获取文档路径 传进去
“filePath”传的是文件的全路径, "tempPath"传的是目录路径,preOpen方法第一个参数传的是文件后缀就是文件的类型。
然后在界面结束的时候调用
这样文件的加载代码就结束了。本以为这个需求就是这么的简单的,但是我还是太年轻了.........
经测试发现当你的项目添加了 'arm64-v8a' 后在多数的手机里发现了TBS初始化时失败,虽然官网也陈述说有失败率,但是这个失败的概率真的是太高了,严重影响到了这块功能的使用。这是我的项目添加的
发现了问题后就开始一步步排查,找原因~首先要知道它的初始化流程,X5内核是支持共享和动态下发的,在你手机里如果有app(微信、QQ等)已经安装了X5内核的话 那你的app就会共享它的内核,否则就调用下载,去下载支持的内核。
那么调试开始吧:
首先我判断是不是下载出错了,对下载进行了监听
发现下载进度是会到100 下载完成先显示100后又跳到其他码去了 安装的回调是失败的。这里就大概的知道了原因。
估计是X5对目前64的兼容不是很好,在第一次初始化的时候失败率特别的高。
这里卡了我很久,网上收集了一堆的资料,官网也看了,但没有文档,最后在简书看到了一个大佬静态集成的帖子,这里给各大网友参考一下,(静态集成会增大包30M左右)
静态集成腾讯TBS X5内核WebView,从微信提取新版30M浏览器内核打包进apk
按上面的帖子静态集成进去后发现在64位的时候,初始化还是会失败。就是 'arm64-v8a' 的引入。不得不放弃~
难道就没有办法了吗?堂堂的腾讯不可能没考虑到失败的情况呀~于是又苦扎api文档中~请原谅我的菜。我既然啥都没发现,难道真的要放弃'arm64-v8a'了吗? 正当我毫无头绪,而一旁产品又在催的双重压力下,我抱着我最后的一丝希望,打开了简书APP,搜索着腾讯TBS,一篇一篇的看,最后苍天不负有心人。我既然发现一线生机(文章已经找不到了,在这里真的谢谢那作者)
这里解决的思路是:在首次初始化失败后 调用手动下载内核方法。重新下载内核。
实测,调用这个方法会重新下载内核,并且基本都会成功安装。解决了引入了'arm64-v8a'初始化失败的问题。这里为了保险起见,建议可以把TBS的调试界面也加进去,给失败的用户多一种修复的选择,这里直接贴代码
这样问题总算解决了,虽然不完美。但是还好这个不常调用,用户初始化成功后再之后只要不卸载app那就会一直成功的了。希望后期官方可以优化一下吧。文章最后希望可以帮助到您