基于capacitorjs的APP前端资源本地化

最近做了安卓app前端资源本地化的工作,下面说明一下具体实现的一些点。

概览

最近做了安卓app前端资源本地化的工作,下面说明一下具体实现的一些点。

概览

对比

如图所示,原本我们的app基本上是一个纯套壳的app,单webview嵌入了一个线上的h5页面,App提供视图渲染和功能拓展(拍照,定位等),只要去更新线上的前端代码就可以更新当前app了,但是这样会有一个弊端,杀掉程序后,每次进入app都会重新向server发送请求来加载资源,尽管目前我们的前端包不算大,在网速一般的时候不可避免的会出现白屏的情况。如果内嵌的前端资源有大量图片,这种情况会更加糟糕。

改造后,前端资源会缓存在本地,webview的地址也指向了本地的server,这样就可以解决上面说的痛点,但与此同时又带来了新的问题。下面梳理一下这次优化所碰到的坑。

坑点

我们所使用的跨平台框架是capacitorjs,官方文档在这里。

  1. 网络请求,之前前端资源和服务器上的接口属于同域,所以不会出现跨域问题,可是现在页面实际运行的地址是localhost,那么要么后端去做一下跨域处理,这显然不合理。所以最好的方式是走安卓端请求接口的方式,安卓请求接口是比http更底层的tcp,不存在跨域。

在api的http部分,给了一些示例,所以我们要做的就是把目前的访问接口方式批量改成这种吗?早先我也是这么认为的,我们用的ajax请求库是axios,那么动手将两种风格统一,手动去实现拦截器等功能也是一个不小的工作。

后面发现,只要引入这个库,请求似乎都走了native,不难想象出有针对xhr做全局拦截处理的代码。示例是这样写的

import { CapacitorHttp } from '@capacitor/core';

然而如果想当然以为这一部分的代码就在这里,那就错了,翻看源码后得知这一部分的逻辑在native-bridge.js里

所以如果想让网络请求正常工作,需要安卓判断是否有CapacitorHttp相关的处理(低版本的capacitor并没有这些插件),有了插件也要检查native-bridge是否有全局劫持xhr的代码。

即使做了这些,有些特殊的请求还是要手动兼容,目前发现上传文件接口就会出现(本质是multipart和json两种数据类型的原因)。

  1. 热更新,之前说了直接使用线上地址的好处是随时发版,内容可变,那如果做本地化也想要这样的效果需要怎么做呢,这个capacitor实在是过于小众,比较麻烦。最终我找到的方案就是cap-go的插件,具体使用的方法文档说明的还算清晰,不再赘述。需要注意的是压缩包不能包括根目录(选取多文件压缩多项)

  2. 自动化脚本问题,我们没有一个完整的CI工具,所以之前上传前端资源使用的是我基于nodejs写的脚本,根据不同环境打包,然后通过sftp协议传到服务端,实际写过nodejs脚本的人应该知道,设计之初的nodejs包含大量的回调语法,和现在promise风格的API是格格不入的。所以这次我基于zxjs进行了优化,整体流程更加直观易懂。

脚本上传文件的时候,又发现了新的问题,swagger和postman都能通,包括本地起的server模拟文件服务也能成功,但是在线上环境就是无法直接后台访问接口上传,关键时候使用了一下apiFox,明白了其中缺失的部分。

axios({
    url:`${baseUrlMap[env]}/management/web/uploadSource`,
    method:'post',
    data:formData,
    headers:formData.getHeaders() // 关键语句
})

结论

事实上hybrid App在我们日常生活中存在很多,拿支付宝举例,有时需要从应用市场重新下载,有时只需要在页面上点击一下更新资源,这个就是app热更新。只要知道原理,调试的时候就不会毫无头绪。

?著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 214,128评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,316评论 3 388
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事?!?“怎么了?”我有些...
    开封第一讲书人阅读 159,737评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,283评论 1 287
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,384评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,458评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,467评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,251评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,688评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,980评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,155评论 1 342
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,818评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,492评论 3 322
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,142评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,382评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,020评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,044评论 2 352

推荐阅读更多精彩内容