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

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滚动条有差异。
7 关注 分享
1152155861@qq.com 772899871@qq.com gvbkxc97153@027168.com 1736715515@qq.com 风之影0539 aq tiandiweb@qq.com

要回复文章请先登录注册

DCloud_Android_ST

DCloud_Android_ST (作者)

回复 2459450271@qq.com :
https://x5.tencent.com/docs/video.html 看下这个文章是否有帮助。目前还没遇到video不能全屏情况。
3 天前
2459450271@qq.com

2459450271@qq.com

回复 lhhlove0805@gmail.com :
是HX alpha版本嘛?
3 天前
lhhlove0805@gmail.com

lhhlove0805@gmail.com

回复 2459450271@qq.com :
为什么我使用3.1.14打的包还是检测不出来 MQQBrowser。。。
3 天前
2459450271@qq.com

2459450271@qq.com

回复 DCloud_Android_ST :
我这里能检测出来plus.navigator.getUserAgent里面有MQQBrowser了,但是执行播放视频时,依然不能使用X5内核横屏播放。全屏按钮是灰色的,不能被点击。请问是什么原因呢。
3 天前
DCloud_Android_ST

DCloud_Android_ST (作者)

回复 tt2470@163.com :
请使用HX3.1.14重新打包 已经优化了X5加载过慢导致无法正常使用的问题
4 天前
2539026749@qq.com

2539026749@qq.com

离线打包如何第一次启动就加载x5内核
4 天前
tiandiweb@qq.com

tiandiweb@qq.com

回复 tiandiweb@qq.com :
你们继续维护crosswalk 或许 做一个 强化的webview,支持视频友好的播放,webrtc等
2021-05-02 21:28
tiandiweb@qq.com

tiandiweb@qq.com

建议支持 crosswalk 内核好一点,起码第一次加载内核没问题,体积大一点起码也比加载不了x5内核好,本机webview播放不了视频是硬伤。
2021-05-02 21:13
tt2470@163.com

tt2470@163.com

回复 DCloud_Android_ST :
现在X5内核不能加载是云端服务器打包出问题了吗?
2021-04-30 15:22