-
Notifications
You must be signed in to change notification settings - Fork 110
基础用法
TTPatch的使用流程
- 源文件编写(伪
js代码,不可直接执行). - 执行
build.js脚本 - 通过
build.js语法转义,变成js可执行代码.输出路径./outputs(具体要下发到app的js文件)
./outputs目录不要修改,每次执行过build.js后会替换./outputs目录
在使用Objective-C类之前需要调用 _import('className’) :
_import('UIView')
var view = UIView.alloc().init()可以用逗号 , 分隔，一次性导入多个类:
_import('UIView, UIColor')
var view = UIView.alloc().init()
var red = UIColor.redColor()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)
声明和实例方法平级
data:property(),获取/修改 要通过 getter / setter 方法，获取时记得加 ():
view.setBackgroundColor_(redColor);
var bgColor = view.backgroundColor();多参数方法名使用 _ 分隔：
var indexPath = NSIndexPath.indexPathForRow_inSection_(0, 1);若原 OC 方法名里包含下划线 _，在 JS 使用双下划线 __ 代替：
// Obj-C: [JPObject _privateMethod];
JPObject.__privateMethod()声明Class,实现协议Protocol
// 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 方法与覆盖普通方法一样：
@implementation UIView (custom)
- (void)methodA {
}
+ (void)clsMethodB {
}
@enddefineClass('UIView', {
methodA: function() {
}
}, {
clsMethodB: function() {
}
});TTPatch动态添加的方法分两类
-
仅供JS端调用,此种方法因供JS端调用,所以采用普通方式声明即可.
-
供JS&Oc调用,此种访问因
Native调用所以需要提供动态方法签名,写法如下方法名 关键字 返回值,参数 方法实现
funcName:
dynamic("void, int", function(){})如方法只有一个参数/返回值(id类型)可简化:dynamic(function(){}),也可以不写
dynamic.Native动态方法签名默认: `v@:v'
// OC
@implementation JPTableViewController
- (void)viewDidLoad
{
[self funcWithParams:@"悟空"];
[self funcWithParams:@"熊大" param2:@"熊二"];
[self funcWithParams:@"百度" param2:@"腾讯" param3:@"阿里"];
}
@end// JS
defineClass("JPTableViewController", {
funcWithParams_:dynamic('void,id',function(param1){
Utils.log_info('[1]动态方法入参:'+param1);
}),
funcWithParams_param2_:dynamic('void,id,id',function(param1,param2){
Utils.log_info('[2]动态方法入参:'+param1+','+param2);
}),
funcWithParams_param2_param3_:dynamic('void,id,id,id',function(param1,param2,param3){
Utils.log_info('[3]动态方法入参:'+param1+','+param2+','+param3);
}),
})使用 Super() 接口代表 super 关键字，调用 super 方法:
// JS
defineClass("JPTableViewController", {
viewDidLoad: function() {
Super().viewDidLoad();
}
})用调用 getter / setter 的方式获取/修改已在 OC 定义的 Property:
可以在 name:property() 为属性
defineClass("JPTableViewController", {
//添加属性
name:property(),
totalCount:property(),
viewDidLoad: function() {
Super().viewDidLoad();
self.setName_("TTPatch"); //设置 Property 值
var name = self.name(); //获取 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
},
})支持 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))
在JS使用字符串代表 Selector:
//Obj-C
[self performSelector:@selector(viewWillAppear:) withObject:@(YES)];//JS
self.performSelector_withObject_("viewWillAppear:", 1)调用Obj-C传入的block,需传入方法签名?代表block
动态生成的方法参数中包含block,要注意block是否包含signature信息,如确实则不可动态调用
iOS 13下 WKWebView delegate 方法中
block缺少signature.
上述情况需要在调用时手动设置签名:
decisionHandler(block('void,int'),1);
block('void,int')为签名,规则如下
- 第0位: 返回值类型
- 第1位: arg0
- 第2位: arg1
callBlock_:dynamic(',?',function(callback){
if(callback){
//自动获取签名
callback(10);
})
},
webView_decidePolicyForNavigationAction_decisionHandler_:dynamic(',id,id,?',function(webView, navigationAction,
decisionHandler) {
//手动设置签名
decisionHandler(block("void,int"), 1);
}),
callBlock_:function(callback){
if(callback){
callback(10);
}
},
JavaScript的block传入Obj-c时要注意, block应声明方法参数及返回值类型 , 分割.
返回值在第一位
runBlock:function(){
self.testCall2_(block("id,id",function(arg){
Utils.log_info('--------JS传入OC方法,接受到回调--------- 有参数,有返回值:string '+arg);
return '这是有返回值的哦';
}));
}
目前支持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 断点调试