前言
JSPatch是一个开源项目(Github链接),只需要在项目里引入极小的引擎文件,就可以使用JavaScript调用任何Objective-C的原生接口,替换任意Objective-C原生方法。目前主要用于下发 JS 脚本替换原生 Objective-C 代码,实时修复线上 bug
集成JSPatch
- 在JSPatch官网上注册帐号,可以任意添加新App,每一个 App 都有一个唯一的 AppKey 作为标识。
2、在JSPatch官网下载SDk解压,将其中的JSPatchPlatform.framework
拖入到项目当中。
3.添加依赖框架:TARGETS-> Build Phases -> Link Binary With Libraries -> +
添加 libz.dylib
和JavaScriptCore.framework
。
4.在AppDelegate.m
中的
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
添加如下代码
// [JSPatch testScriptInBundle]; // 本地测试打开这句代码,注释下面的代码,当本地测试通过,将JS文件上传到JSPatch官网,注释这个代码,打开下面代码
[JSPatch startWithAppKey:@"JSPatch ID"];
#ifdef DEBUG
// 上传JSPatch的时候选择开发预览就会走这里。不会影响线上用户,当测试完毕的时候,把状态改为全量下发
[JSPatch setupDevelopment];
#endif
[JSPatch sync];
JSPatch 的使用
1、 本地修复代码
2、使用OC转JS工具将修复好的OC代码转化为JS代码
3、本地工程添加一个main.js文件
4、然后将转化完的代码粘贴到main.js中。本地测试代码注释打开,其他代码注释掉。
[JSPatch testScriptInBundle]; // 本地测试打开这句代码,注释下面的代码,当本地测试通过,将JS文件上传到JSPatch官网,注释这个代码,打开下面代码
// [JSPatch startWithAppKey:@"JSPatch ID"];
//#ifdef DEBUG
// // 上传JSPatch的时候选择开发预览就会走这里。不会影响线上用户,当测试完毕的时候,把状态改为全量下发
// [JSPatch setupDevelopment];
//#endif
// [JSPatch sync];
5、虽然OC转JS工具很好用,但是转化完还是有很多代码需要修改。在使用JSPatch之前,强烈建议各位看一遍作者的wiki 这里举几个需要修改的例子
-
CGRectMake(100, 100, 50, 20)
需要写成JS的形式{x:100,y:100,width:50,height:20}
。 - OC中的常量/枚举需要用具体值代替
-
@selector(handleBtn)
需要写成字符串格式" handleBtn "
- 私有成员变量需要用
self.valueForKey("变量名")
和self.setValue_forKey(["JSPatch"], "变量名")
来获取和设置值。 - 当变量中带有下划线比如
@property (nonatomic,strong) NSArray *data_array;
这时候对其取值和赋值需要用双下划线data__array
6、当然很多时候可能修改完毕之后JS依然有错误,不起作用。这时候就需要使用Safari 来断点调试JS。这个在刚开始使用JSPatch的时候能帮上大忙,因为不太熟悉,所以自己写的JS代码总是会犯各种错误,这时候使用断点调试工具,很快就能够定位到哪一行代码有错误了。
7、当本地测试完毕之后,将[JSPatch testScriptInBundle];
注释 ,其他代码打开。然后将JS文件上传的JSPatch官网。新建版本号,然后上传JS 先选择开发预览。这样就只会有debug模式的应用会收到补丁。上传完毕,debug模式测试通过,就可以选择全量下发。(以前我直接选择全量下发,发现有可能补丁会发布不成功。不知道是不是JSPatch网站的bug,所以最好先选择开发预览,然后在全量下发)。