DCloud_Android_ST
DCloud_Android_ST
  • 发布:2020-01-06 19:20
  • 更新:2 天前
  • 阅读:71821

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

分类:HTML5+

此文档将不再维护,请参考新文档:https://uniapp.dcloud.io/tutorial/app-android-x5

腾讯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组件。

云端打包配置

打开应用的manifest.json文件,可配置使用X5内核

可视化界面配置

在“App模块配置”项下勾选“Android X5 Webview(腾讯TBS)”

源码视图配置

切换到“源码视图”,根据项目类型修改manifest.json文件

  • uni-app项目
    在"app-plus" -> "modules" 节点下添加"Webview-x5",配置如下:
        "Webview-x5": {}
  • 5+ App项目
    在"permissions" 节点下添加"Webview-x5",配置如下:
    "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滚动条有差异。

x5内核自更新

x5内核存在自更新机制。所以可能存在历史版本升级了x5内核导致的兼容性问题。集成的同学需要注意!

适配问题:

目前已知 TBS45738版本更新后会导致 uniapp vue页面的input组件adjust-position=false失效!使用x5内核的同学请知晓尽快适配,可以改为nvue或不适用x5内核。版本信息可通过plus.navigator.getUserAgent()获取。
x5内核的UserAgent如下:

Mozilla/5.0 (Linux; Android 11; PEXM00 Build/RKQ1.201217.002; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/77.0.3865.120 MQQBrowser/6.2 TBS/045738
9 关注 分享
1***@qq.com 7***@qq.com g***@027168.com 1***@qq.com 风之影0539 aq t***@qq.com zr12041019 1***@qq.com

要回复文章请先登录注册

小怪兽RUA

小怪兽RUA

回复 2***@qq.com :
重启手机
2 天前
小怪兽RUA

小怪兽RUA

回复 w***@126.com :
重启手机
2 天前
小怪兽RUA

小怪兽RUA

回复 3***@qq.com :
重启手机
2 天前
w***@126.com

w***@126.com

回复 3***@qq.com :
+1+1+1
2022-05-27 12:18
3***@qq.com

3***@qq.com

按照要求配置,都是最新版,怎么运行检查UserAgent就是没有MQQBrowser,删除进程重新进入也没有
2022-05-27 11:19
2***@qq.com

2***@qq.com

为哈我按照这样的要求配置,云打包后运行检查UserAgent还是没有MQQBrowser
2022-04-27 08:50
2***@qq.com

2***@qq.com

回复 t***@163.com :
我也是啊
2022-04-26 21:59
DCloud_Android_ST

DCloud_Android_ST (作者)

回复 7***@qq.com :
不能 x5自身有热更新机制
2022-04-19 17:41
7***@qq.com

7***@qq.com

能指定X5的版本吗?
2022-04-19 16:39
1***@qq.com

1***@qq.com

怎么判断x5下载完没有?或者怎么判断渲染内核
2022-04-13 17:04