DCloud_Android_ST
DCloud_Android_ST
  • 发布:2020-01-06 19:20
  • 更新:2021-01-11 11:13
  • 阅读:33386

DCloud App集成 X5 内核(腾讯浏览服务TBS)说明

分类:HTML5+

腾讯TBS x5内核仅支持Android平台。iOS只能使用自带的WKWebview

以下说明文中的“腾讯TBS x5内核“精简为“x5内核”。
集成x5内核说明:

  1. 首先你需要升级HBuilderX2.5.3 版本或更高。
  2. 按以下说明配置相关应用的manifest.json。然后云打包(含自定义基座)才可生效。

集成x5内核后哪些页面会由x5内核渲染?

  1. 所有plus.webview.create创建的webview。
  2. uni-app中所有vue页面。
  3. uni-app中的web-view组件。

uni-app项目

manifest.json配置"Webview-x5"模块具体如下:

"app-plus"{  
    "modules" : {  
        ...,  
        ...,  
        ...,  
        "Webview-x5": {}  
    }  
}

5+ App项目

manifest.json配置"Webview-x5"模块具体如下:

"permissions":{  
    ...,  
    ...,  
    ...,  
    "Webview-x5": {}  
}

离线打包配置

离线打包集成x5教程

Tips

NDK 配置时请去除x86 cpu的配置 建议仅配置"armeabi-v7a" 否则可能无法正常使用X5内核。3.0.7+版本开始支持 “arm64-v8a”

unimp小程序打包配置

unimp小程序集成x5教程

Tips

NDK 配置时请去除x86的配置 建议仅配置"armeabi-v7a" 否则可能无法正常使用X5内核。3.0.7+版本开始支持 “arm64-v8a”

使用X5内核能解决什么问题:

  1. x5适配了rom的自定义主题字体,与原生字体保持一致。不会出现一个界面部分字体为原生字体、部分字体为webview字体的问题。之前系统webview在部分手机上不能适配rom自定义主题的字体。
  2. 系统的webview有浏览器兼容问题,低端Android的webview有很多新语法都不支持。使用x5可以拉齐webview内核。对于5+App和wap2app,可以全部拉齐。对于uni-app,由于uni-app自带js引擎,在js和组件层面本身就不存在浏览器兼容问题,只有vue页面的css涉及浏览器兼容问题。如果你想使用比如sticky等新css语法,此时可通过x5拉齐。如果开发者比较注意,不使用太新的语法的话,其实此时x5在这方面没有用处。
  3. x5内核自带的video实现强于html的video,支持视频格式更多。(这个只能用于5+app和wap2app的html里的自带video,以及uni-app的web-view组件里的video。uni-app默认的video组件本身就是原生的,和x5无关)
  4. 远程web页面防劫持是x5内核的一大亮点

集成X5内核的注意事项:

  1. 由于x5使用动态热更新加载x5内核。在Google Play审核是不允许的。所以无法提交Google Play。
  2. x5不支持在PC模拟器上运行。一切真机为主。
  3. x5内核对webview嵌套支持的不友好。使用x5渲染的页面尽量不要使用webview嵌套(父子页面等)容易出现动画卡顿等现象。
  4. 因x5加载内核机制问题,云打包APK第一次安装运行可能x5还没有下载,此时不是x5内核渲染页面,而是系统webview渲染页面。但x5下载完毕后,杀掉进程重新运行,就会使用x5内核渲染页面。
  5. 并非所有手机都有x5内核,当手机端没有时x5内核时,App启动后会先下载内核,在x5加载成功前,调用webview仍然是系统webview。
  6. html5 嵌入iframe视频fixed定位会导致应用闪退
  7. 部分系统(华为)修改字体后不会重启系统。导致x5页面不能够立即更换字体库重新进行渲染。需要杀掉进程重新启动应用(back退出应用无效)才可以重置字体库进行页面渲染。
  8. APK本身已经集成了X5才能通过wgt升级。如果apk本身没集成X5则不可以通过WGT升级支持X5。需要改为APK升级!
  9. 可通过plus.navigator.getUserAgent判断UA中是否包含MQQBrowser关键字判断当前webview是否为X5渲染。 HX2.6.16+支持
  10. x5内核渲染页面的滚动条。会随着页面内容的长短显示滚动滑块。可按住滚动滑块拖动实现快速滚动。与普通webview滚动条有差异。
6 关注 分享
1152155861@qq.com 772899871@qq.com gvbkxc97153@027168.com 1736715515@qq.com 风之影0539 aq

要回复文章请先登录注册

四方上下

四方上下

使用 X5 webview时,rem适配会出现问题,元素大小要比预期的大,如果不适用X5就正常显示。
2021-01-11 11:13
bless_lee@126.com

bless_lee@126.com

回复 DCloud_Android_ST :
离线集成的X5引擎 安装apk后第一次打开app非x5加载,杀掉进程第二次进入是使用的x5加载。离线集成了也是这样加载吗?
2020-12-28 16:34
DCloud_Android_ST

DCloud_Android_ST (作者)

回复 178668653@qq.com :
该问题我们已经注意到了。会尽快想出对策 目前还发现X5有提供某些配置控制videocache的大小
2020-12-23 12:00
178668653@qq.com

178668653@qq.com

回复 DCloud_Android_ST :
使用X5之后,APP体积变得很大,看一点儿视频,体积增加,一直看,一直在增加,这种有什么优化方案吗
2020-12-23 09:36
373654981@qq.com

373654981@qq.com

X5   集成造成启动页面变慢,怎么优化我看网上https://www.h3399.cn/201805/581920.html 但是我找不到这些类怎么做
2020-12-15 17:29
程序员Tom

程序员Tom

回复 DCloud_Android_ST :
哦。那只能等稳定了再说了。
2020-12-11 15:28
DCloud_Android_ST

DCloud_Android_ST (作者)

回复 程序员Tom :
实际测试并不如意,在华为部分手机无法下载tbs库导致无法使用。
2020-12-10 17:37
程序员Tom

程序员Tom

腾讯官方TBS 5.1在2020年1月就支持x64位了,请问官方什么时候支持?
https://x5.tencent.com/docs/version_list.html
2020-12-10 16:24
847364864@qq.com

847364864@qq.com

按照文档说明,离线打包与在线打包之后,通过plus.navigator.getUserAgent判断都不包含MQQBrowser关键字。这可怎么办
2020-12-02 12:13
啊是的

啊是的

回复 DCloud_Android_ST :
什么时候,能自动清进程,或者提供接口回调
2020-11-25 10:57