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

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滚动条有差异。
9 关注 分享
1***@qq.com 7***@qq.com g***@027168.com 1***@qq.com 风之影0539 aq t***@qq.com zr12041019 1***@qq.com

要回复文章请先登录注册

DCloud_Android_ST

DCloud_Android_ST (作者)

回复 风中叶子 :
可以等等alpha版本 会升级x5内核并优化了部分设备可能无法加载内核的问题
4 天前
风中叶子

风中叶子

回复 DCloud_Android_ST :
用了最新班的Hbuilder 打包,安卓4.4加载不了X5内核,7.x没有问题,这还跟安卓屏版本有关吗?
4 天前
DCloud_Android_ST

DCloud_Android_ST (作者)

回复 风中叶子 :
都有可能,最大因素是网络环境,毕竟X5内核内部需要下载一个30M左右的文件
5 天前
风中叶子

风中叶子

回复 DCloud_Android_ST :
云打包5+APP项目之后,发现有时不能及时下载X5内核,是和云服务有关吗,还是网络问题?
5 天前
3***@qq.com

3***@qq.com

E/X5InitImpl: onViewInitFinished is true这是个算集成成功还是失败
2021-07-21 10:24
3***@qq.com

3***@qq.com

离线打包基座怎么看日志是否集成x5完成
2021-07-21 10:23
9***@qq.com

9***@qq.com

使用了X5内核后,在安卓机发现input组件设置focus属性为true的时候,录入框的光标不闪烁,但是能录入。
2021-07-15 17:02
3***@qq.com

3***@qq.com

我想知道如何设置让nvue不跟随系统主题字体
2021-06-22 11:49
1***@qq.com

1***@qq.com

回复 DCloud_Android_ST :
请问有进展吗?
2021-06-04 19:04
风雅

风雅

x5渲染速度好慢啊 轮播组件都会掉帧 还是好好优化下自带的吧
2021-05-27 12:25