TbsSDK是腾讯浏览服务,依托X5内核强大的能力,致力于提供优化移动端浏览体验的整套解决方案的SDK。TbsSDK可用于移动端展示H5页面和在应用内展示各种文档。地址:https://x5.tencent.com
首先说说接入X5内核的方式,腾讯浏览服务提供两种方式接入X5内核。其一是只接入加载接口,共享QQ、微信等已下载的X5内核,若手机没有安装这些软件,则会自行下载该内核,大概27M;另一种是静态加载X5内核,也就是下载X5内核,放置在项目libs的armeabi文件夹下,在运行软件时调用接口加载内核文件。
第一种方式的优点是很大可能加载速度很快,目前百分之九十五以上的手机都会安装并登录了QQ、微信等腾讯软件,所以我们的App大都是可以共享它们的X5内核的,但是还是存在着百分之几的几率无法使用,需要在应用内下载X5内核并加载,这个过程并不短。如果用户是在开流量的情况下,还需要询问用户是否要下载,等到用户进入App页面并打开网页或打开文档,可能已经是一个很长的过程,但是还是有办法可以解决这个问题的,其中的了业务逻辑我就不再这里论述了。
第二种方式静态加载的优点就是不需要依赖的其他腾讯产品的内核,已集成于应用内部。当然缺点也是很明显的,静态加载比较耗时,经测试,静态加载会出现页面显示不正常的情况,重新加载一遍再进入页面又正常了,但是这终究不是个办法啊。目前还没解决这个问题,也不是我等能解决的,在QQ浏览器移动产品论坛里提问也没有收到具体的答复,只是做了已记录的标记。
Android7.0及以上会出现无法加载内核的情况
//初始化X5内核
QbSdk.initX5Environment(this, new QbSdk.PreInitCallback() {
@Override
public void onCoreInitFinished() {
//x5内核初始化完成回调接口,此接口回调并表示已经加载起来了x5,有可能特殊情况下x5内核加载失败,切换到系统内核。
}
@Override
public void onViewInitFinished(boolean b) {
//x5內核初始化完成的回调,为true表示x5内核加载成功,否则表示x5内核加载失败,会自动切换到系统内核。
Log.e("@@","加载内核是否成功:" + b);
}
});
这就是在项目的Application里初始化X5内核的代码,一般情况下是可以加载的,或者加载失败的时候也会打印出来,true或false。但是当我换另一个设备调试的时候就不行了(Huawei Mate5 Android7.0 无其他腾讯软件),既不提示true也不打印false,后来发现是因为此时App还未被授予读写权限,导致App无法下载内核到本地。那么我授权之后再次启动App应该可以了吧,然而这个时候不再执行下载操作,也不会去加载内核了(因为没有)。当然,把内核初始化的代码写在Application是TbsSDK中提供的demo的做法,我的做法是在用户授权之后开始调用初始化代码,
下面该说一下怎么使用sdk在应用内展示各式文档了,首先看一下大拿们的经验与分享:https://www.jianshu.com/p/8bd1c4918857 https://www.jianshu.com/p/90fa8453f706另外还有几篇写的都比较好,都可以拿来借鉴与学习。sdk的导入如下图说明:
代码如下:
1.布局TbsReaderView:
mtbsReaderView = new TbsReaderView(this, this);
FrameLayout rootLayout = (FrameLayout)findViewById(R.id.rl_layout);
rootLayout.addView(mtbsReaderView, new LinearLayout.LayoutParams(-1, -1));
2.展示文档:
//增加下面一句解决没有TbsReaderTemp文件夹存在导致加载文件失败
String bsReaderTemp = "/storage/emulated/0/TbsReaderTemp";
File bsReaderTempFile = new File(bsReaderTemp);
if (!bsReaderTempFile.exists()) {
Log.d("TAG", "准备创建/storage/emulated/0/TbsReaderTemp!!");
boolean mkdir = bsReaderTempFile.mkdir();
if(!mkdir){
Log.e("TAG", "创建/storage/emulated/0/TbsReaderTemp失败!!!!!");
}
}
Bundle bundle = new Bundle();
String path = filePath + fileName;
bundle.putString("filePath", new File(filePath).toString());
bundle.putString("tempPath", Environment.getExternalStorageDirectory() + "/" + "TbsReaderTemp");
boolean result = mtbsReaderView.preOpen(getFileType(new File(path).toString()),false);
if (result) {
mtbsReaderView.openFile(bundle);
}
须知要继承TbsReaderView的接口:@Override
public void onCallBackAction(Integer integer, Object o, Object o1) {
}
demo地址:https://github.com/mezcreate/TbsReaderView.git
如demo中用DownloadManager下载文件的话,在Android7.0以上的就需要将权限授予DownloadManager,因为是两个不同的进程或App,DownLoadManager是系统的App。我这种的这么执着的人去搜索如何用DownLoadManager下载文件都不曾搜得到,搜的得都是千篇一律的抄袭文(无不是说怎么打开使用DownLoadManager下载的APK文件)。如何使用DownLoadManager下载文件到本地,等我研究完之后会分享出来让我等新手能够得到这一部分知识。
我从iOS转学安卓,感觉相当不容易,安卓的坑太多,我自己踩的坑太多了。当然这些坑我觉得并不是安卓本身的,可能与编译器有关吧,现在感觉用Xcode做iOS开发是多么的趁手。然而网上有些前贤们写的文章真的不是给我等看的,我只能说此类文章是高手不需要,新手看不懂。另外再吐槽一下Tbssdk的官方文档,着实没什么用或看不懂,不知道是写给谁看的