TTPatch

热修复、热更新、JS代码动态下发、动态创建类

1. 使用文档

2. 基础用法

风险提示: 请配合服务器下发开关使用, 通过配置决定APP是否初始化TTPatch模块

1. 功能列表

2. 安装

CocoaPods pod 0.3.0

1. 在 Podfile 中添加 pod 'TTPatch'。
2. 执行 pod install 或 pod update。
3. 导入 "TTPatch.h"

演示项目:Example.xcodeproj

运行效果图

在线下发补丁执行

重启后加载已下发补丁

3. 基础用法

我要参照TTPatch-JS模板

0. build

TTPatch的使用流程
1. 源文件编写(伪js代码,不可直接执行).
2. 执行 build.js脚本
3. 通过build.js语法转义,变成js可执行代码.输出路径./outputs(具体要下发到app的js文件)

??./outputs目录不要修改,每次执行过build.js后会替换./outputs目录

1. import

在使用Objective-C类之前需要调用 _import('className’) :

_import('UIView')
var view = UIView.alloc().init()

可以用逗号 , 分隔，一次性导入多个类:

_import('UIView, UIColor')
var view = UIView.alloc().init()
var red = UIColor.redColor()

2. 调用OC方法

调用类方法

var redColor = UIColor.redColor();

调用实例方法

var view = UIView.alloc().init();
view.setNeedsLayout();

参数传递

跟在OC一样传递参数:

这里要注意下有参数的情况,参数前需要加_
Obj-C方法中的:和js中的_是一一对应的,如果有遗漏会error

var view = UIView.alloc().init();
var superView = UIView.alloc().init()
superView.addSubview_(view)

Property

声明和实例方法平级

data:property(),

获取/修改 要通过 getter / setter 方法，获取时记得加 ():

view.setBackgroundColor_(redColor);
var bgColor = view.backgroundColor();

方法名转换

多参数方法名使用 _ 分隔：

var indexPath = require('NSIndexPath').indexPathForRow_inSection_(0, 1);

若原 OC 方法名里包含下划线 _，在 JS 使用双下划线 __ 代替：

// Obj-C: [JPObject _privateMethod];
JPObject.__privateMethod()

3. defineClass

声明Class,实现协议Protocol

API

// class:superClass<protocolA,protocolB,...>
defineClass('ViewController:UIViewController<UITableViewDelegate,UITableViewDataSource>',
{
    instanceMethods...
},
{
    classMethods...
});

@param classDeclaration: 字符串: 类名:父类名<Protocol>
@param instanceMethods: 要添加或覆盖的实例方法
@param classMethods: 要添加或覆盖的类方法

覆盖方法

1.在 defineClass 里定义 OC 已存在的方法即可覆盖，方法名规则与调用规则一样，使用 _ 分隔:

// OC
@implementation JPTableViewController
- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath
{
}
@end

// JS
defineClass("JPTableViewController", {
  tableView_didSelectRowAtIndexPath: function(tableView, indexPath) {
    ...
  },
})

2.使用双下划线 __ 代表原OC方法名里的下划线 _ :

// OC
@implementation JPTableViewController
- (NSArray *) _dataSource {
}
@end

// JS
defineClass("JPTableViewController", {
  __dataSource: function() {
  },
})

3.在方法名前加 tt 即可调用未覆盖前的 OC 原方法:

// OC
@implementation JPTableViewController
- (void)viewDidLoad {
}
@end

// JS
defineClass("JPTableViewController", {
  viewDidLoad: function() {
     self.ttviewDidLoad();
  },
})

覆盖类方法

defineClass() 第三个参数就是要添加或覆盖的类方法，规则与上述覆盖实例方法一致：

// OC
@implementation JPTestObject
+ (void)shareInstance
{
}
@end

// JS
defineClass("JPTableViewController", {
  //实例方法
}, {
  //类方法
  shareInstance: function() {
    ...
  },
})

覆盖 Category 方法

覆盖 Category 方法与覆盖普通方法一样：

@implementation UIView (custom)
- (void)methodA {
}
+ (void)clsMethodB {
}
@end

defineClass('UIView', {
  methodA: function() {
  }
}, {
  clsMethodB: function() {
  }
});

Super

使用 Super() 接口代表 super 关键字，调用 super 方法:

// JS
defineClass("JPTableViewController", {
  viewDidLoad: function() {
     Super().viewDidLoad();
  }
})

Property

获取/修改 OC 定义的 Property

用调用 getter / setter 的方式获取/修改已在 OC 定义的 Property:

动态新增 Property

可以在 name:property() 为属性

defineClass("JPTableViewController", {
  //添加属性
  name:property()
  init: function() {
     self = Super().init()
     self.setData_(["a", "b"])     //添加新的 Property (id data)
     self.setTotalCount_(2)
     return self
  },
  viewDidLoad: function() {
     var data = self.data()     //获取 Property 值
     var totalCount = self.totalCount()
  },
})

私有成员变量

使用 valueForKey() 和 setValue_forKey() 获取/修改私有成员变量:

// OC
@implementation JPTableViewController {
     NSArray *_data;
}
@end

// JS
defineClass("JPTableViewController", {
  viewDidLoad: function() {
     var data = self.valueForKey_("_data")     //get member variables
     self.setValue_forKey_(["Patch"], "_data")     //set member variables
  },
})

添加新方法

可以给一个类随意添加 OC 未定义的方法，但所有的参数类型都是 id:

// OC
@implementation JPTableViewController
- (void)viewDidLoad
{
     NSString* data = [self dataAtIndex:@];
     NSLog(@"%@", data);      //output: Patch
}
@end

// JS
var data = ["JS", "Patch"]
defineClass("JPTableViewController", {
  dataAtIndex: function(idx) {
     return idx < data.length ? data[idx]: ""
  }
})

4. 特殊类型

Struct

支持 CGRect / CGPoint / CGSize / UIEdgeInsets 这四个 struct 类型，用 JS 对象表示:

// Obj-C
UIView *view = [[UIView alloc] initWithFrame:CGRectMake(20, 20, 100, 100)];
[view setCenter:CGPointMake(10,10)];
[view sizeThatFits:CGSizeMake(100, 100)];

// JS
var view = UIView.alloc().initWithFrame(new TTReact(x:20, y:20, width:100, height:100))
view.setCenter_(new TTPoint(x: 10, y: 10))
view.sizeThatFits_(new TTSize(width: 100, height:100))

Selector

在JS使用字符串代表 Selector:

//Obj-C
[self performSelector:@selector(viewWillAppear:) withObject:@(YES)];

//JS
self.performSelector_withObject_("viewWillAppear:", 1)

5. Block

调用Obj-C传入的block

callBlock_:function(callback){
    if(callback){
        callback(10);
    }
},

Obj-C调用js传入block,并接受回调

JavaScript的block传入Obj-c时要注意, block应声明方法参数及返回值类型 , 分割.
返回值在第一位

runBlock:function(){

    self.testCall2_(block("NSString*,NSString*"),function(arg){
        Utils.log_info('--------JS传入OC方法,接受到回调--------- 有参数,有返回值:string  '+arg);
        return '这是有返回值的哦';
    });
}

6. 调试

目前支持3中级别日志

Utils.log 只会在debug环境下的js中输出
Utils.log_info 在js 和 xcode中输出
Utils.log_error 在js 和 xcode中输出,并输出error信息

log不支持多参数,只支持参数拼接

var view = UIView.alloc().init();
var str = "test";
var num = 1;
Utils.log(str + num);   //直接在JS拼接字符串

也可以通过 Safari 的调试工具对 JS 进行断点调试，详见 JS 断点调试

4. 环境配置及使用

简单体验 I

首先要下载我们的demo工程,然后你只要修改src目录下的.js文件，然后运行 npm run build.这条命令会将我们刚刚修改的工作区代码(src)经过转义压缩输出到outputs目录下, outputs目录下的文件供app读取使用.

????app不能直接读取src工作区的文件哦!!!!

简单体验 II

如果你已经熟练使用了步骤 I是不是觉得每次要经过下面三步,很麻烦. 那么你可以往下看

• save
• run build
• run xocde

目前demo已经支持模拟器/真机 在线实时预览修改内容了~~~~~

下面为实时预览的准备工作

1. 将JS目录下的node.js依赖下载成功.执行npm install即可.
2. 执行npm run server 开启本地服务
3. 将真机/模拟器调至同一WIFI下
4. 运行demo

如步骤1.失败请检查本地npm,node版本,下面给出我电脑版本供参考npm -v 6.9.0

/node -v v10.16.0

此时你的准备工作已经全部完成, 接下来用你最喜欢的IDE打开src目录下的任意js文件进行编辑, 在点击保存之后你会发现手机数据也跟着刷新了~~~~

实际使用 III

实际使用的话，就需要一些JS相关的支持，要确保本机已安装npm.如果不知道的同学可以百度安装。
如果已经安装好npm可以往下操作

1. cd /demo/JS 执行 npm install
2. npm run server

????执行后，我们本地已经有可以执行js的环境了.
然后我们就可以在/src文件夹内修改.js源文件，修改后本地服务会自动执行打包更新并预览.

????实际使用不要直接修改outputs目录, 因为每次build后 outputs目录会被全量替换

关于build说明

执行npm run build 将文件转成各自对应的js.

执行npm run package 将src目录下文件打包成一个文件.(demo中使用此种方式进行演示).

推荐👇：

如果你想一起进阶，不妨添加一下交流群1012951431

面试题资料或者相关学习资料都在群文件中 进群即可下载！