正确姿势介入JSPatch

1.简单介绍

在没有JSPatch之前,可能有人会使用过JSCocoa。但是有着一系列复杂问题,比如源码已经多年没有维护,代码规模巨大,不支持ARM64。如果想使用还需要升级libffi,并且尝试兼容ARM64,想编译通过都很困难。

JSPatch的出现基本解决了上述所有问题。在一个项目中接入JSPatch的成本很低,需要动点脑筋的可能就是如何合理的提交和下载。

关于JSPatch的原理作者的博客已经说的很清楚,本文不再说明,本文主要说的时一些接入操作相关。

如果你不是在董铂然博客园看到本文可点击查看原文

2.仓库设置

js文件肯定不能随便往后台某个文件夹一放就让前端去下载了,虽然使用方便但是在App或者版本较多时容易混乱。建议专门搭建一个远端仓库,仓库里 主要就是文件夹和js文件,当需要提交js文件时,从主干迁出一个分支,在合适的地方新建文件夹并添加js文件,然后给主干提Pull Request, 这应该是一个麻烦但是规范的流程。文件夹结构参考下图:

第三层文件夹里,可以用版本名称也可以使用build号。之后在发请求下载的时候应该是需要拼上项目appname,version等参数。

3.安全策略

安全相关工作如果没有做好,最惨的情况是人家可以通过js文件调用你的任何OC方法,我们肯定不能允许此类事情发生。一般在js文件提交到仓库以后 后端应该对这一段js代码进行 md5或者更高手段的编码,并将这段编码与文件存在一起,上图中得meta.json里存的就是这一段编码。 之后在发请求的返回值的结构应该是大致如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
data: {
isUpdate: true,
content: "require('MTPoiFeedbackM')
    defineClass('MTFeedbackRankCell',{
            setPoiFeedback:function(poiFeedback){
                self.ORIGsetPoiFeedback(poiFeedback)
                var temColor = require('UIColor').lightGrayColor();
                self.detailLbl().setTextColor(temColor);
            }
})",
code: "9c944f39e57f2e50bdb85deb878cc0f798efb9b0"
}
}

就是首先有个字段告诉我们较上次下载的js文件是否有更新。如果为true再检测下方返回的code与内容编码后得到的code是否相同。当然这个内容也可以不直接返回而是返回一个下载的url也是完全可以的。

4.更新频率

我之前看到很多人把使用js和下载js的代码都放在了didFinishLaunchingWithOptions: 这个方法。我觉得有所不妥,因为如果这个app用户一直放在手机的后台(比如微信),并且也没出现内存警告的话,这个方法应该一直不会调用。我建议的是: 使用js文件的代码放在didFinishLaunchingWithOptions: 而下载js文件的代码放在applicationDidBecomeActive: 因为这个方法在程序启动和后台回到前台时都会调用。并且我建议设置一个间隔时间,根据一些数据和权衡之后我们采用的是间隔时间设为1小时。 也就是说每次来到这个方法时,先要检测是距离上次发请求的时间间隔是否超过1小时,超过则发请求,否则跳过。

5.接入流程

接入的方式很简单,作者也提供了Demo程序,大致就分为几步:

①在General 的 LinkFrameworks and Libraries里面 添加javascriptcore.framework

这个库里主要用于js与oc语言的桥接,比如一些数据类型间的相互转化。

②podfile添加 pod 'JSPatch' 并pod install

③在代码中添加使用js和下载js的代码

这里作者也给出了示例,使用和下载

1
2
3
4
[JPEngine startEngine];
NSString *sourcePath = [[NSBundle mainBundle] pathForResource:@"demo" ofType:@"js"];
NSString *script = [NSString stringWithContentsOfFile:sourcePath encoding:NSUTF8StringEncoding error:nil];
[JPEngine evaluateScript:script];

 

1
2
3
4
[NSURLConnection sendAsynchronousRequest:[NSURLRequest requestWithURL:[NSURL URLWithString:@"http://cnbang.net/test.js"]] queue:[NSOperationQueue mainQueue] completionHandler:^(NSURLResponse *response, NSData *data, NSError *connectionError) {
    NSString *script = [[NSString alloc] initWithData:data encoding:NSUTF8StringEncoding];
    [JPEngine evaluateScript:script];
}];

但是如果你是企业级app,肯定不能直接使用这么朴素的方式,肯定至少也要封装一个manager之类的。我们公司的源码不会在这里贴出来,但是提供一个建立这个manager大概的思路:

  

6.JSPatch语法

这里是作者列出的语法总结:作者原文  不用刻意去看,在写的过程中逐渐就熟悉了。

下面给出一段示例代码解决两个简单的bug。

①假设有一个按钮我们默认应该是让他不可点击的,但是之前忘了设置。

OC代码

1
2
3
4
5
- (void)viewWillAppear:(BOOL)animated
{
    [super viewWillAppear:animated];
    self.confirm.enabled = NO;
}

jspatch 

1
2
3
4
5
6
defineClass('MTBRegisterPage',{
            viewWillAppear: function(animated) {
            self.super().viewWillAppear(animated);
            self.confirm().setEnabled(NO);
            }
})

②假设有一个列表页有特殊情况临时想叫我们由黑色改成灰色,并展示一个弹窗

OC代码

1
2
3
4
5
6
7
8
- (void)setDealFeedback:(MTDealFeedbackM *)dealFeedback
{
    // ------先调用原来的方法,旧代码保留
    self.detailLbl.textColor = [UIColor lightGrayColor];
    UIAlertView *temAlertView = [[UIAlertView alloc]initWithTitle:@"提示" message:@"已购物品用灰色展示" delegate:self cancelButtonTitle:@"OK" otherButtonTitles:nil, nil];
    [temAlertView show];
  
}

jsPatch

1
2
3
4
5
6
7
8
9
10
11
require('MTPoiFeedbackM')
defineClass('MTFeedbackRankCell',{
            setPoiFeedback:function(poiFeedback){
            self.ORIGsetPoiFeedback(poiFeedback)
            var temColor = require('UIColor').lightGrayColor();
            self.detailLbl().setTextColor(temColor);
            var temAlertView = require('UIAlertView').alloc().
initWithTitle_message_delegate_cancelButtonTitle_otherButtonTitles("提示","已购物品用灰色展示", self, "OK", null);
            temAlertView.show()
            }
})

诸如此类的代码,觉得在使用的过程中出现频率最高的bug,就是调用原方法然后加一个判断用来容错或return。

也许作者也觉得毕竟这个JSPatch语法 并不是一个正式的语种,大家不会投入太大的精力来仔细学习,所以作者本人也提供了一个简单粗暴的OC到JS直接转换地址:http://bang590.github.io/JSPatchConvertor/

这个地址亲测一些简单的写法是正确转换的,但是比较复杂的语法还是不能让机器直接搞定,还是需要人工修改的。作者也在不断完善这个工具。 这个转换器的实现原理:http://blog.cnbang.net/tech/2915/

7.更多思考

①.接入了JSPatch之后,iOS的线上BUG 看上去就不向以前那样“猛如虎”了,但是这仅仅是一个紧急预案措施,以前规范的流程还是需要遵守。

②.每一次本版本用JSPatch解决的线上Bug,下个版本必须用OC代码写入项目中,不能允许补丁代码的存留超过一个版本。

③.倡导使用敏捷开发的思想,类似于主逻辑或者是功能模块入口的方法可以抽的更细,这样即使需要修改,成本也不会太大,作者本人也提到,如果有一行 代码必须要在一个大方法的中间进行修改,那我也没办法了,你只能把这整个方法都用js写一遍了,所以才设置了JSPatchConvertor。

④.每次用JSPatch解决掉的线上BUG 应当有一个专门的文档记录,遇到重复错误必须写casestudy。

 

暂时想到这些,希望本文能对准备接入JSPatch的开发人员有所帮助。

posted @ 2016-04-05 14:23  沧海小鱼儿  阅读(1281)  评论(0编辑  收藏  举报