/JSPatch-iOS-APP

JSPatch 可以让你用 JavaScript 书写原生 iOS APP。只需在项目引入极小的引擎，就可以使用 JavaScript 调用任何 Objective-C 的原生接口，获得脚本语言的优势：动态修复 bug的神器。

Primary LanguageObjective-C

JSPatch-iOS-APP

JSPatch 是一个开源项目Github链接，只需要在项目里引入极小的引擎文件，就可以使用 JavaScript 调用任何 Objective-C 的原生接口，替换任意 Objective-C 原生方法。目前主要用于下发 JS 脚本替换原生 Objective-C 代码，实时修复线上 bug。

BuglyHotfix简介

BuglyHotfix 基于 JSPatch 封装，完全兼容 JSPatch 编写的脚本文件。本文实例基于集成BuglyHotfix环境进行总结编写实例的。

SDK集成

  • 下载Bugly iOS 热更新 SDK
  • 添加以下依赖库
    • SystemConfiguration.framework
    • Security.framework
    • JavascriptCore.framework
    • libz.tbd
    • libc++.tbd

SDK初始化

  • 在工程的AppDelegate.m文件导入头文件 #import <BuglyHotfix/Bugly.h>
  • 在工程AppDelegate.m的application:didFinishLaunchingWithOptions:方法中初始化BuglyHotfix，示例代码如下：
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    
    BuglyConfig *config = [[BuglyConfig alloc] init];
    config.hotfixDebugMode = YES;
    [Bugly startWithAppId:@"e1d8b8f150"
#ifdef DEBUG
        developmentDevice:YES
#endif
                   config:config];
    
    return YES;
}

发布补丁

  • 编写规则参见JSPatch介绍;
  • 将补丁文件main.js拖拽到工程内；
  • 将本地测试通过的main.js文件压缩成zip，点击 Bugly 平台 热更新 功能的发布新补丁 (热更新菜单在应用升级模块下);
  • 选择目标版本（即应用版本）及开发设备，其它按默认值进行下发；
  • iOS 热更新 SDK 使用指南;

示例

 @interface ViewController : UIViewController

- (void)JSPatchWithParam:(NSString *)param;

@end
@interface ViewController ()

@property(nonatomic, strong) NSString *titleName;

@end

@implementation ViewController

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

- (void)didReceiveMemoryWarning {
    [super didReceiveMemoryWarning];
    // Dispose of any resources that can be recreated.
}

- (void)JSPatchWithParam:(NSString *)param
{

}

@end
require('ViewController, UIColor')

defineClass("ViewController", ['totalCount'], {
        viewDidLoad: function() {
        
            self.ORIGviewDidLoad();
            var redColor = UIColor.redColor();
            self.view().setBackgroundColor(redColor);
            
            
            self.JSPatchWithParam("JSPatch 测试成功");
            
        },
    })


defineClass("ViewController", {
        JSPatchWithParam: function(param) {
            
            var alertView = require('UIAlertView').alloc().initWithTitle_message_delegate_cancelButtonTitle_otherButtonTitles("提示",param, self, "确定",  null);
            alertView.show()
            
        },
    })

JSPatchConvertor工具

用xcode来编辑js非常困难，基本上没有缩进，完全需要手写；经过研究发现使用 Sublime text3 结合 jsformat 插件，可以很好的编辑js。

  • 注意一：自动转化会丢失@字符。

Objective-c

NSString *urlString = [NSString stringWithFormat:@"%@%@", serverUrl, action];

JSPatch错误转化

require('NSString');
var urlString = NSString.stringWithFormat("%@%", serverUrl, action);

JSPatch修正

require('NSString');
var urlString = NSString.stringWithFormat("%@%@", serverUrl, action);
  • 注意二：block 里使用 self 变量。 在 block 里无法使用 self 变量，需要在进入 block 之前使用临时变量保存它:
- (void)viewDidLoad
{
    [Utils execute:userId success:^(NSString *name) {
        
        // TODO:
        self.doSomething();
        
    } failure:^(NSError *error) {
        
        // TODO:
        self.doSomething();
        
    }];
}


defineClass("TestViewController", {
  viewDidLoad: function() {
  
    var slf = self; // 这里的self需要保存，才能使用
    
    Utils.execute_success_failure(userId,block('NSString*', function(name) {
     
          // TODO:
          slf.doSomething();
     
    }),block('NSError*', function(error) {
    
          // TODO:
          slf.doSomething();
          
    }));
  }
});
  • 注意三：若要把这个从 OC 传过来的 block 再传回给 OC，同样需要再用 block() 包装，因为 OC 中Block会被转成 JS function。
+ (void)execute:(NSString *)userId success:(void (^)(NSString *name))success
           failure:(void (^)(NSError *error))failure
{
    // TODO:
    
}



defineClass("TestViewController", {
            
 },
 {
    Utils: function(userId,succBlock,failBlock) {
          var slf = self;
          var succ = block('NSString*', blockDic); // 参数是block时，在js中变成js function,再回调到oc时，需要block括起来
          var fail = block('NSError*', failBlock);
          Utils.execute_success_failure(userId, block('NSString *', function(name) {
     
               slf.doSuccess(succ);
     
          }), block('NSError*', function(error) {
    
               slf.doFailed(fail);
          
          }));
});

运行效果

alt tag