QT for Android之嵌入webview的问题及解决方案记录(一)
最近的项目是做国产平板(安卓)上的app,目前项目已落地,回顾并记录一下遇到的问题。
注:整个系列问题针对于QT5.12.4 + QT Creator4.9.1,该帖用于记录遇到的问题与当时的解决方案,若有更好的方法欢迎评论。
1.html资源的存储位置问题
我的项目是用的前端用VSCode打的资源包的内容,内容中一般包含assets/css/imgs/js等文件夹及入口文件index.html。

结论:直接放在运行目录的同级目录android文件夹里的assets文件夹下,相当于将资源包里的文件直接全部复制到android>>assets文件夹下即可。(不能将该部分的文件放在.pro文件中去操作,我操作时的资源包大小在200MB,放在pro文件中去进行查找和复制的话QTCreator会很卡很卡)。
为什么当时要去pro文件中操作,是因为项目里还有些人脸识别的资源需要打包并拷贝到自定义的一个文件夹中,比如取名为android-src,里面放一些音视频资源之类的,后来觉得前端资源也应该放到这个文件夹里,于是就改为去pro文件中操作,结果就变得很卡很卡。切勿这样操作!

资源包里会有成百上千个文件,文件数量多会导致非常耗时!
2.webview访问html资源的方式
注:安卓环境下是不支持webEngine的,所以只能用webview。
这里比较简单,import QtWebView 1.1后直接设置WebView的url属性即可。比如:
webviewComponent.url = "file:///android_asset/index.html" 这里走的是file协议(这是我当时最初的版本,会有很多限制,后期会变成走http协议,后面再更新该部分改动)。
在 Android 应用开发中,assets 文件夹是一个特殊的目录。当你把资源文件(如 HTML、CSS、JS、图片等)放在项目的 assets 目录下时,这些文件会被原封不动地打包进最终的 APK 文件中。
file:///android_asset/index.html 是一个标准的文件 URL,它告诉 Android 系统:
- 协议 (
file://):这是一个本地文件请求,而不是网络请求 (http://)。 - 主机 (
/):在file协议中,主机部分通常为空或为/。 - 路径 (
/android_asset/index.html):这是关键部分。/android_asset/是 Android 系统为assets目录预留的一个特殊的、固定的虚拟路径。系统知道,当看到这个路径时,就应该去 APK 包内的assets文件夹里查找对应的文件。这是 Android 操作系统规定的访问其内部assets目录的标准方式。
但是,这样会存在一个问题,从别的地方切回该app时或者触发了返回事件导致Activity生命周期变更后,再次进入app时会白屏(原因:
file:///android_asset/index.html:系统认为这是一个固定的地址。当 Activity 恢复时,WebView 尝试加载这个地址,它可能会从内存中的缓存、渲染状态或一个不完整的恢复进程中加载,从而导致白屏。
)
结论:在访问时的url中加入时间戳即可,这样每次加载时都是新的URL,即最终语句为:
webviewComponent.url = "file:///android_asset/index.html?ts=" + Date.now()
这样每次webview加载时都是一次新的加载读取,该方式有优有劣,但是很高效地解决了缓存问题。
3.侧边快捷栏返回事件拦截
有的平板有侧边栏快捷方式,比如侧边滑一下会退出当前app,存在误触的风险,可根据实际使用场景决定是否需要屏蔽或拦截。该实现方式比较简单:

根据应用场景去做,我当前使用的平板是滑动一下侧边栏相当于触发一次回退,故这样操作起到拦截的作用。