JsPatch学习（1）【使用篇】

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

最简单的使用：

1、注册App

到JSPatch官方网站注册App，网站地址：http://www.jspatch.com/
注册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的简单实用，和大家共同学习。如有错误，欢迎指正。