关于接入腾讯X5内核的一些坑(不断更新)

前言

根据之前开发的案例来看,原生WebView确实存在着很多的不完善以及一些令人头疼的问题,在WebView一大堆坑的面前腾讯X5内核不失为一种相当好的解决问题,但是X5真的如此完美了么?非也,那么关于X5接入会遇到那些坑,又是如何一一解决呢,本文将带给你一些答案。

事先声明,本文基于2017年4月9日能够获取的腾讯X5内核的最新版本(可到 https://pan.baidu.com/s/1skSVkWd 下载):
Android SDK(完整版)
大小:294KB
版本:v3.1.0.1034
更新日期:2017-03-01
提供解决方案。

问题1,选择图片问题

首先,对于WebView选择图片的问题请参考上一篇《Android WebView选择图片的问题》http://www.jianshu.com/p/d31936511359 在此不再过多表述。

问题2,视频横屏全屏的问题

接入X5内核后一个很重要的就是网页视频的播放问题了,按照腾讯官方的X5内核接入是没有问题的,视频也能播放,但想要全屏播放是不行的,在这块就存在腾讯留下的一些坑了,你可能在腾讯X5官网的疑难解答中会看到这样的接入方法:

视频全屏播放形态、初始播放形态、小窗播放该如何设置?
看如下示例代码:
Bundle data = new Bundle();
data.putBoolean("standardFullScreen", false);
//true表示标准全屏,false表示X5全屏;不设置默认false,
data.putBoolean("supportLiteWnd", false);
//false:关闭小窗;true:开启小窗;不设置默认true,
data.putInt("DefaultVideoScreen", 2);
//1:以页面内开始播放,2:以全屏开始播放;不设置默认:1
mWebView.getX5WebViewExtension().invokeMiscMethod("setVideoParams", data);

1) standardFullScreen 全屏设置
设置为true时,我们会回调WebChromeClient的onShowCustomView方法,由开发者自己实现全屏展示;
设置为false时,由我们实现全屏展示,我们实现全屏展示需要满足下面两个条件:
a. 我们 Webview初始化的Context必须是Activity类型的Context
b. 我们 Webview 所在的Activity要声明这个属性
android:configChanges="orientation|screenSize|keyboardHidden"
如果不满足这两个条件,standardFullScreen 自动置为 true

2) supportLiteWnd 小窗播放设置
前提standardFullScreen=false,这个条件才生效
设置为 true, 开启小窗功能
设置为 false,不使用小窗功能

3) DefaultVideoScreen 初始播放形态设置
a、以页面内形态开始播放
b、以全屏形态开始播放

原文链接:http://x5.tencent.com/tbs/technical.html#/detail/sdk/1/a1f54118-e2b7-43df-8189-8824e4ce5970

按照其文中的设置,你会发现一个相当大的坑,WebView界面出现崩溃,崩溃原因是空指针异常,文中提到的方法“mWebView.getX5WebViewExtension().invokeMiscMethod”为空(null),这是怎么回事呢?
进过一番调查,我们发现在X5内核的WebView的加载方法时出现了意外,但此错误并没有使软件崩溃,直到我们进入WebView所在的界面,调用invokeMiscMethod方法时才出现了崩溃,即X5内核的WebView初始化失败。问题出在哪里呢?我们完全是按照官方接入文档来进行接入的呀。

在X5的官方论坛发现一篇类似问题,也发现了类似的问题出现:http://bbs.mb.qq.com/thread-1450686-1-1.html

但同时,在X5内核官网的一片疑难解答引起了我的注意:《64位手机无法加载x5》
是否是因为64位的CPU不兼容导致加载失败呢?尝试按照文中提供的解决方法对工程进行设置(下文提到的so包可到 https://pan.baidu.com/s/1boYNzAZ 下载):

x5内核暂时不提供64位的so文件,在64位手机上需要让AP以32位模式运行。具体操作如下(文中的so包可到 https://pan.baidu.com/s/1nvx54UX 下载):
1.如果使用是Eclipse则需要将所有的.so文件都放置在so加载目录:lib/armeabi文件夹下(没有该目录则新建一个,AP中没有使用到.so文件则需要拷贝任意一个32位的so文件到该目录下,如果没有合适的so可以到官网http://x5.tencent.com/tbs/sdk.html下载官网“SDK接入示例“,拷贝对应目录下的liblbs.so文件),lib文件夹下不要有其他以”armeabi“开头的文件夹。
2.如果使用的是 Android studio则需要进行两项配置,
(1)打开对应module中的build.gradle文件,在文件的android{}中的defaultConfig{}里(如果没有defaultConfig{}则手动添加)添加如下配置: ndk{abiFilters "armeabi", "armeabi-v7a", "x86", "mips"},如果配置后编译报错,那么需要在gradle.properties文件中加上Android.useDeprecatedNdk=true;
(2)找出build.gradle中配置的so加载目录:jniLibs.srcDir:customerDir,如果没有该项配置则so加载目录默认为:src/main/jniLibs,需要将.so文件都放置在so加载目录的armeabi文件夹下(没有该目录则新建一个,AP中没有使用到.so文件则需要拷贝任意一个32位的so文件到该目录下,如果没有合适的so可以到官网http://x5.tencent.com/tbs/sdk.html下载官网“SDK接入示例“,拷贝对应目录下的liblbs.so文件),so加载目录下不要有其他以”armeabi“开头的文件夹。

原文链接:http://x5.tencent.com/tbs/technical.html#/detail/sdk/1/34cf1488-7dc2-41ca-a77f-0014112bcab7
按照文中的方案进行修改,完成配置后编译运行,网页中的视频终于可以正常全屏横屏了,大功告成。

更多问题

更多问题收录中,如果你有遇到什么问题,欢迎在下边评论区与我一同讨论。
本文会持续更新关于X5内核中更多的坑以及解决方案,让我们共同进步,创作更好用的程序。

    原文作者:kongzue
    原文地址: https://www.jianshu.com/p/405cd05cbb06
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞