简介
- 项目主页: https://github.com/bang590/JSPatch
- 示例下载: https://github.com/ios122/ios122
JSPatch 可以让你用 JavaScript 书写原生 iOS APP。只需在项目引入极小的引擎,就可以使用 JavaScript 调用任何 Objective-C 的原生接口,获得脚本语言的优势:为项目动态添加模块,或替换项目原生代码动态修复 bug。
优势
在项目中引入JSPatch,就可以在发现bug时下发JS脚本替换原生方法,可以做到无需更新整个APP即时修复bug!
JSPatch用iOS内置的 JavaScriptCore.framework作为引擎;JSPatch也符合苹果的规则。苹果不允许动态下发可执行代码,但通过苹果 JavaScriptCore.framework 或 WebKit 执行的代码除外,JS 正是通过 JavaScriptCore.framework 执行的。
JSPatch非常小巧
实例预览
@implementation AppDelegate- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { [JPEngine startEngine]; NSString *sourcePath = [[NSBundle mainBundle] pathForResource:@"demo" ofType:@"js"]; NSString *script = [NSString stringWithContentsOfFile:sourcePath encoding:NSUTF8StringEncoding error:nil]; [JPEngine evaluateScript:script]; self.window = [[UIWindow alloc] initWithFrame:[UIScreen mainScreen].bounds]; [self.window addSubview:[self genView]]; [self.window makeKeyAndVisible]; return YES;}- (UIView *)genView{ return [[UIView alloc] initWithFrame:CGRectMake(0, 0, 320, 320)];}@end
require('UIView, UIColor, UILabel')defineClass('AppDelegate', { genView: function() { var view = self.ORIGgenView(); view.setBackgroundColor(UIColor.greenColor()) var label = UILabel.alloc().initWithFrame(view.frame()); label.setText("JSPatch"); label.setTextAlignment(1); view.addSubview(label); return view; }});
安装
通过Cocopods安装
pod 'JSPatch'
手动导入
下载https://github.com/bang590/JSPatch并解压
复制JSPatch文件夹到你的工程
使用
objective-C:
导入头文件#import "JPEngine.h"
导入本地JS(demo.js)见文首github示例demo(可选,实际项目中,根据自己实际需要进行.)
调用[JPEngine startEngine]
加载引擎
- 通过
[JPEngine evaluateScript:@""]
接口执行 JavaScript。
[JPEngine startEngine];[JPEngine evaluateScript:@"\ var alertView = require('UIAlertView').alloc().init();\ alertView.setTitle('Alert');\ alertView.setMessage('AlertView from js'); \ alertView.addButtonWithTitle('OK');\ alertView.show(); \"];[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];}];NSString *sourcePath = [[NSBundle mainBundle] pathForResource:@"sample" ofType:@"js"];NSString *script = [NSString stringWithContentsOfFile:sourcePath encoding:NSUTF8StringEncoding error:nil];[JPEngine evaluateScript:script];
[JPEngine startEngine];NSString *sourcePath = [[NSBundle mainBundle] pathForResource:@"demo" ofType:@"js"];NSString *script = [NSString stringWithContentsOfFile:sourcePath encoding:NSUTF8StringEncoding error:nil];[JPEngine evaluateScript:script]
JavaScript:
基础使用方式
require('UIView, UIColor, UISlider, NSIndexPath')var redColor = UIColor.redColor();var view = UIView.alloc().init();view.setNeedsLayout();view.setBackgroundColor(redColor);var bgColor = view.backgroundColor();var indexPath = NSIndexPath.indexPathForRow_inSection(0, 1);JPObject.__privateMethod()var arr = require('NSMutableArray').alloc().init()arr.addObject("JS")jsArr = arr.toJS()console.log(jsArr.push("Patch").join('')) var view = UIView.alloc().initWithFrame({x:20, y:20, width:100, height:100});var x = view.bounds.x;require('JPObject').request(block("NSString *, BOOL", function(ctn, succ) { if (succ) log(ctn)}));dispatch_after(function(1.0, function(){ }))dispatch_async_main(function(){ })
详细文档请参考wiki页面:基础用法
定义类/替换方法
用 defineClass()
定义 Objective-C 的类,对类和实例方法进行动态替换。
@implementation JPTableViewController...- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath{ NSString *content = self.dataSource[[indexPath row]]; JPViewController *ctrl = [[JPViewController alloc] initWithContent:content]; [self.navigationController pushViewController:ctrl];}- (NSArray *)dataSource{ return @[@"JSPatch", @"is"];}- (void)customMethod{ NSLog(@"callCustom method")}@end
defineClass("JPTableViewController", { tableView_didSelectRowAtIndexPath: function(tableView, indexPath) { var row = indexPath.row() if (self.dataSource().count() > row) { var content = self.dataSource().objectAtIndex(row); var ctrl = JPViewController.alloc().initWithContent(content); self.navigationController().pushViewController(ctrl); } }, dataSource: function() { var data = self.ORIGdataSource().toJS(); return data.push('Good!'); }}, {})
详细文档请参考wiki页面:defineClass的用法
扩展
一些自定义的struct类型、C函数调用以及其他功能可以通过扩展实现,调用 +addExtensions:
可以加载扩展接口:
@implementation AppDelegate- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { [JPEngine startEngine]; [JPEngine addExtensions:@[@"JPInclude", @"JPCGTransform"]]; NSString *sourcePath = [[NSBundle mainBundle] pathForResource:@"demo" ofType:@"js"]; NSString *script = [NSString stringWithContentsOfFile:sourcePath encoding:NSUTF8StringEncoding error:nil]; [JPEngine evaluateScript:script];}
include('test.js') var view = require('UIView').alloc().init()view.setTransform({a:1, b:0, c:0, d:1, tx:0, ty:100})
扩展可以在JS动态加载,更推荐这种加载方式,在需要用到时才加载:
require('JPEngine').addExtensions(['JPInclude', 'JPCGTransform'])
可以通过新增扩展为自己项目里的 struct 类型以及C函数添加支持,详情请见wiki页面:添加新扩展
安全性
JSPatch非常强大,因而最好将通过服务器获取JS的链接进行加密,本地JS也最好加密处理