JsPatch学习(1)【使用篇】

JsPatch的使用很多,简单介绍热修复功能。
JsPatch【使用篇】

最简单的使用:

1、注册App

注册App

分别在对应位置填入要注册的App的名字和AppID(如果不知道AppID是啥的,自行问谷哥或者度娘)。
注册完App是这样子的:

Paste_Image.png

对应App分配了一个appKey,在项目的代码中会用到。

2、SDK配置

点击SDK下载JSPatch最新SDK。


SDK下载

当前的最新版本是:V1.5

SDK下载

Xcode配置SDK:

XCode配置环境

3、错误模拟

因为是测试,我们模拟一个简单的常见错误:数组越界,并尝试使用JSPatch修复。

错误按钮

在页面上添加一个按钮,点击时触发数组越界的错误。

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    // Do any additional setup after loading the view, typically from a nib.
}

- (IBAction)touchError:(id)sender {
    [self errorErray]; //触发越界错误

}
- (void)didReceiveMemoryWarning {
    [super didReceiveMemoryWarning];
    // Dispose of any resources that can be recreated.
}
- (void)errorErray {
    NSString *str = self.array[3];
    NSLog(@"%@",str);
}
- (NSArray *)array {
    if (!_array) {
        _array = [NSArray new];
    }
    return _array;
}
@end

运行,点击按钮,错误日志是这样的:

**2016-06-25 22:52:53.291 JSPatchTestDemo[38819:34942169] *** Terminating app due to uncaught exception 'NSRangeException', reason: '*** -[__NSArray0 objectAtIndex:]: index 3 beyond bounds for empty NSArray'**

4、本地测试

JSPatch的设置配置的.js文件名字是main.js,测试时建议同样适用该名字命名。将main.js文件放在项目工程目录下,并添加到项目中。

添加本地测试使用的main.js文件

因为是demo测试,main.js文件内写了简单的代码,仅做测试,修复一个数组越界的bug。
main.js的内容:

/**
 * Created by Later on 16/6/23.
 */
defineClass("ViewController", {
    errorErray: function () {

        self.setArray(["a","b","c","d"])
        var str = self.array().objectAtIndex(3)
        console.log("JSPatch调用")
    }
})

我们尝试本地测试,使用JSPatch修复。
JSPatch的本地测试,在- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions ;内写代码:

[JSPatch testScriptInBundle];
[JSPatch sync];

表示本地测试。
运行,在点击触发错误的按钮时,JSPatch在bandle里面找寻main.js,执行,替换掉原OC的代码执行,修复了错误。
log日志显示:

2016-06-25 23:06:04.360 JSPatchTestDemo[38857:34954757] JSPatch: request http://7xkfnf.com1.z0.glb.clouddn.com/(null)/(null)?v=1466867164.360383
2016-06-25 23:06:04.437 JSPatchTestDemo[38857:34954839] App Transport Security has blocked a cleartext HTTP (http://) resource load since it is insecure. Temporary exceptions can be configured via your app's Info.plist file.
2016-06-25 23:06:04.449 JSPatchTestDemo[38857:34954788] JSPatch: request error Error Domain=NSURLErrorDomain Code=-1022 "The resource could not be loaded because the App Transport Security policy requires the use of a secure connection." UserInfo={NSUnderlyingError=0x7fa638e9e3b0 {Error Domain=kCFErrorDomainCFNetwork Code=-1022 "(null)"}, NSErrorFailingURLStringKey=http://7xkfnf.com1.z0.glb.clouddn.com/(null)/(null)?v=1466867164.360383, NSErrorFailingURLKey=http://7xkfnf.com1.z0.glb.clouddn.com/(null)/(null)?v=1466867164.360383, NSLocalizedDescription=The resource could not be loaded because the App Transport Security policy requires the use of a secure connection.}
2016-06-25 23:06:05.383 JSPatchTestDemo[38857:34954757] JSPatch.log: JSPatch调用

打印了JSPatch调用表示我们的本地测试成功了。

5、在线测试

我们的热修复是针对已经发版的App的,所以仅仅是本地测试是不够的。本地测试仅是验证我们的js执行是否能够修复原bug。下面我们进行在线测试。
首先,我们将项目里面的main.js上传到JSPatch的官方后台(后台是存放在七牛云存储上的)。
在我们的App管理界面,点击添加版本。

添加版本
添加版本

将你要修复bug的App版本填写到App版本号一栏,我们的测试demo是1.0.0版本,所以,我们直接填写1.0.0版本。
创建好版本之后是这样子的:

创建版本

点击1.0.0版本,并选择我们的main.js进行上传。

上传文件

选择开发预览,并点击提交。

开发预览

在开发预览界面查看我们的信息是否正确,如果不正确,删除该版本重新创建或者重新上传文件,直到正确为止。
注:点击“当前补丁版本号”可以查看我们的main.js的代码,核对是否使我们需要的补丁。

核对补丁

如果一切无误,点击“全量下发”。
此时只是补丁发布了,而我们的测试代码还没有修改,还不能进行在线测试。下面我们修改我们的测试代码。
复制我们在JSPatch注册的App的appKey,并在- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions ;书写代码:

 [JSPatch startWithAppKey:@"842fc1737db1137b"];
 [JSPatch sync];

注意:[JSPatch testScriptInBundle]是在本地测试时使用,而[JSPatch startWithAppKey:@"842fc1737db1137b"]是在实际生产开发中使用,两者不可同时出现。故建议以下写法:

#if debug
    [JSPatch testScriptInBundle];
#endif

表示在debug模式下使用测试模式,在release模式下,使用生产开发模式。
完整配置代码如下:

  - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [JSPatch startWithAppKey:@"842fc1737db1137b"];
#if debug
    [JSPatch testScriptInBundle];
#endif
    [JSPatch sync];

    return YES;
}

切记,七牛云存储的下载使用的是http协议,在iOS适配中,注意info.plist文件修改:

info.plist修改

运行,点击触发错误按钮,log日志如下:

2016-06-25 23:38:34.647 JSPatchTestDemo[39056:34993122] JSPatch: runScript
2016-06-25 23:38:34.648 JSPatchTestDemo[39056:34993122] JSPatch: request http://7xkfnf.com1.z0.glb.clouddn.com/842fc1737db1137b/1.0.0?v=1466869114.647924
2016-06-25 23:38:36.105 JSPatchTestDemo[39056:34993157] JSPatch: request success {
    v = 1;
}
2016-06-25 23:38:36.106 JSPatchTestDemo[39056:34993157] JSPatch: updateToVersion: 1
2016-06-25 23:38:36.106 JSPatchTestDemo[39056:34993157] JSPatch: request file http://7xkfnf.com1.z0.glb.clouddn.com/842fc1737db1137b/1.0.0/file1?v=1466869116.106488
2016-06-25 23:38:36.178 JSPatchTestDemo[39056:34993156] JSPatch: request file success, data length:3072
2016-06-25 23:38:36.189 JSPatchTestDemo[39056:34993156] JSPatch: updateToVersion: 1 success
2016-06-25 23:38:36.190 JSPatchTestDemo[39056:34993156] JSPatch: runScript
2016-06-25 23:38:36.201 JSPatchTestDemo[39056:34993156] JSPatch: evaluated script, length: 237
2016-06-25 23:38:43.392 JSPatchTestDemo[39056:34993122] JSPatch.log: JSPatch调用

和本地测试一样,都打印了JSPatch调用,我们的在线测试成功。

JSPatch,作为一个开源项目,对于开发人员,要学习的内容颇多。本着先选会使用,再搞懂原理的原则,本文简单描述了JSPatch的简单实用,和大家共同学习。如有错误,欢迎指正。

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

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,761评论 25 707
  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 12,060评论 4 62
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,629评论 18 139
  • 亲爱的TA阅读 111评论 0 0
  • 其实最简单的运动就是迈开步子,如果你连步子都也不愿意迈出,就不要每天把我又胖了,我要减肥,我要戒酒,我要健...
    AI大叔阅读 502评论 0 0