Android Tencent X5 WebView 集成详解

最新推荐文章于 2024-09-06 20:29:03 发布

Jon_Lo

最新推荐文章于 2024-09-06 20:29:03 发布

阅读量1.6k

点赞数

分类专栏： Android_Applet 文章标签： X5 X5WebView Tencent X5 腾讯X5 WebView

Android_Applet 专栏收录该内容

3 篇文章 0 订阅

订阅专栏

Android X5WebView 详细集成步骤

本文意在了解掌握并快速集成腾讯X5系统内核，更好的提高Android与H5在应用上的渲染交互效果；X5web内核下该如何有效的管理cookie；X5webview下的ndk基本配置说明；X5webview常见问题等等。

Android-X5WebView封装（含Cookie管理、进度监听、适配8.1系统等策略）详情请点击！

文章使用到的官方资料：

1：什么是腾讯X5Web？

移动互联网时代，Web成为各超级App的通用基础技术。Web浏览不再局限于传统浏览器，相反已经进入绝大部分App的各类应用场景。越来越多的App基于Hybrid模式开发和部署业务。腾讯浏览服务（TBS，Tencent Browsing Service）整合腾讯底层浏览技术和腾讯平台资源及能力，提供整体浏览服务解决方案。腾讯浏览服务面向应用开发商和广大开发者，提供浏览增强，内容框架，广告体系，H5游戏分发，大数据等服务，能够帮助应用开发商大幅改善应用体验，有效提升开发，运营，商业化的效率。传统系统内核(Webview)存在适配成本高、不安全、不稳定、耗流量、速度慢、视频播放差、文件能力差等问题，这是移动应用开发商在进行Hybrid App开发时普遍面临的难题。腾讯浏览服务基于腾讯X5内核解决方案（包括内核和云服务），能够有效解决传统移动web技术面临的普遍问题，同时能极大扩展应用(Hybrid App)内浏览场景的服务能力。

2：腾讯X5Web的优点：

腾讯X5宣传优点

3：开始集成

A：集成前准备

个人建议还是首先运行腾讯下腾讯的X5Demo，不仅对X5有个初步印象，而且方便对项目中的功能进行筛选使用。下载demo，导入AS（笔者的Android studio 是3.0版本）导入后，就报了第一个错误...

官方Demo的错误

官方项目导入结构图

细心的老司机可能一眼就发现了问题，这里就不多说问题直接给大家提供解决办法：

解决办法

在项目的 build.gradle里面（绿色区域）按照笔者为大家截图（也就是红色区域）的位置，在对应区域添加红色段落内代码即可。（代码内容如下）

buildscript {

repositories{ jcenter() }

dependencies{ classpath "com.android.tools.build:gradle:2.3.3" }

}

repositories {

maven {url 'http://repo1.maven.org/maven2' }

}

按照上面步骤，等待项目构建完毕以后，Demo理论上就可以正常运行了。（如果上述方法还是不行那只能说脸黑自行解决咯）项目成功运行后的Demo效果如下：

X5运行图

B：基本配置

I：权限配置

权限配置

II：jar包配置

jar包jniLibs配置

III：项目 build.gradle配置：

配置ndk

由于X5暂时不提供64位so文件，为保证64位手机能正常加载x5内核，可以在项目依赖中去配置ndk。为什么要配置ndk以及如何配置，详细请参考 X5Web配置ndk的官方详细说明

C：开始使用

首先：将Android系统源码和XML里的系统包和类替换为腾讯X5WebSDK里的包和类，

替换资源

举个例子就是不要使用android系统的webview，而是使用腾讯的webview。当然，具体的替换规则可以参考文章前面的链接，里面有详细的使用说明。

其次：初始化设置

Application的配置

在自定义application里面进行x5内核初始化接口，别忘记了在清单文件里面要配置自定义application。

接着：关于cookie的管理和使用

官方文档告知我们：com.tencent.smtt.sdk.CookieManager和com.tencent.smtt.sdk.CookieSyncManager的相关接口的调用，需要在接入SDK后，放到创建X5的WebView之后（也就是X5内核加载完成）进行；否则，cookie的相关操作只能影响系统内核。

图下给大家提供了一种cookie在X5的使用策略（也是笔者的另一篇文章）需要了解的可以移步下面链接。

Cookie的有效管理

然后：X5Web兼容视频播放的使用

如果有视频播放的需求，需要在享受页面视频的完整播放体验需要在页面的Activity（配置文件）需要声明android:configChanges="orientation|screenSize|keyboardHidden"；

网页中的视频进入屏幕的时候，可能出现闪烁的情况，需要如下设置：Activity在onCreate时需要设置：getWindow().setFormat(PixelFormat.TRANSLUCENT);（这个对宿主没什么影响，建议声明）

值得一提的是，以下接口禁止(直接或反射)调用，避免视频画面无法显示：

webview.setLayerType() ； webview.setDrawingCacheEnabled(true);

最后：建议包装x5webview

如何包装？也就是自定义x5webview，建议：可以先花一点时间看一下官方的Demo，然后根据自身业务集成使用。当然，笔者自己也封装了一些最基本的功能 X5WebView的封装大家可以参考下（写得不好的话请见谅）

常见问题：

问题一：

如何拿到X5webview的加载进度，比如在Html加载前，客户端这边需要展示一张图片，当加载完毕以后这张图片就隐藏，然后显示需要展示的html内容？