JsPatch的使用很多,简单介绍热修复功能。
JsPatch【使用篇】
最简单的使用:
1、注册App
- 到JSPatch官方网站注册App,网站地址:http://www.jspatch.com/
注册App的页面是这样子的:
分别在对应位置填入要注册的App的名字和AppID(如果不知道AppID是啥的,自行问谷哥或者度娘)。
注册完App是这样子的:
对应App分配了一个appKey,在项目的代码中会用到。
2、SDK配置
点击SDK下载JSPatch最新SDK。
当前的最新版本是:V1.5
Xcode配置SDK:
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
文件放在项目工程目录下,并添加到项目中。
因为是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文件修改:
运行,点击触发错误按钮,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的简单实用,和大家共同学习。如有错误,欢迎指正。