轉自: https://github.com/bang590/JSPatch/wiki/JSPatch-%E5%9F%BA%E7%A1%80%E7%94%A8%E6%B3%95
1. require
在使用Objective-C類之前需要調用
require('className’)
:
require('UIView')
var view = UIView.alloc().init()
可以用逗号
,
分隔,一次性導入多個類:
require('UIView, UIColor')
var view = UIView.alloc().init()
var red = UIColor.redColor()
或者直接在使用時才調用
require()
:
require('UIView').alloc().init()
2. 調用OC方法
調用類方法
var redColor = UIColor.redColor();
調用執行個體方法
var view = UIView.alloc().init();
view.setNeedsLayout();
參數傳遞
跟在OC一樣傳遞參數:
var view = UIView.alloc().init();
var superView = UIView.alloc().init()
superView.addSubview(view)
Property
擷取/修改 Property 等于調用這個 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
API
qqqq
defineClass(classDeclaration, instanceMethods, classMethods)
@param
classDeclaration
: 字元串,類名/父類名和Protocol
@param
instanceMethods
: 要添加或覆寫的執行個體方法
@param
classMethods
: 要添加或覆寫的類方法
覆寫方法
1.在 defineClass 裡定義 OC 已存在的方法即可覆寫,方法名規則與調用規則一樣,使用
_
分隔:
// OC
@implementation JPTestObject
- (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.在方法名前加
ORIG
即可調用未覆寫前的 OC 原方法:
// OC
@implementation JPTableViewController
- (void) viewDidLoad {
}
@end
// JS
defineClass("JPTableViewController", {
viewDidLoad: function() {
self.ORIGviewDidLoad();
},
})
覆寫類方法
defineClass()
第三個參數就是要添加或覆寫的類方法,規則與上述覆寫執行個體方法一緻:
// OC
@implementation JPTestObject
+ (void)shareInstance
{
}
@end
// JS
defineClass("JPTableViewController", {
//執行個體方法
}, {
//類方法
shareInstance: function() {
...
},
})
Super
使用
self.super()
接口代表 super 關鍵字,調用 super 方法:
// JS
defineClass("JPTableViewController", {
viewDidLoad: function() {
self.super().viewDidLoad();
}
})
Property
擷取/修改 OC 定義的 Property
用調用 getter / setter 的方式擷取/修改已在 OC 定義的 Property:
// OC
@interface JPTableViewController
@property (nonatomic) NSArray *data;
@end
@implementation JPTableViewController
@end
// JS
defineClass("JPTableViewController", {
viewDidLoad: function() {
var data = self.data() //get property value
self.setData(data.toJS().push("JSPatch") //set property value
},
})
動态新增 Property
若要在 JS 為類新增 Property,可以使用
getProp()
和
setProp_forKey()
這兩個接口。
注意
getProp()
無法擷取在 OC 定義的 Property,隻能擷取在 JS 通過
setProp_forKey()
接口設定的 Property。
// OC
@interface JPTableViewController
@end
@implementation JPTableViewController
@end
// JS
defineClass("JPTableViewController", {
init: function() {
self = self.super().init()
self.setProp_forKey("JSPatch", "data") //添加新的 Property (id data)
return self;
},
viewDidLoad: function() {
var data = self.getProp("data") //擷取新的 Property 值
},
})
私有成員變量
使用
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(["JSPatch"], "_data") //set member variables
},
})
添加新方法
可以給一個類随意添加 OC 未定義的方法,但所有的參數類型都是
id
:
// OC
@implementation JPTableViewController
- (void)viewDidLoad
{
NSString* data = [self dataAtIndex:@(1)];
NSLog(@"%@", data); //output: Patch
}
@end
// JS
var data = ["JS", "Patch"]
defineClass("JPTableViewController", {
dataAtIndex: function(idx) {
return idx < data.length ? data[idx]: ""
}
})
若新增的方法屬于 Protocol 裡的接口,需要在 defineClass 的類聲明參數裡指明實作的 Protocol,詳見下文。
Protocol
可以在定義時讓一個類實作某些 Protocol 接口,寫法跟 OC 一樣:
defineClass("JPViewController: UIViewController<UIScrollViewDelegate, UITextViewDelegate>", {
})
這樣做的作用是,當添加 Protocol 裡定義的方法,而類裡沒有實作的方法時,參數類型不再全是
id
,而是自動轉為 Protocol 裡定義的類型:
@protocol UIAlertViewDelegate <NSObject>
...
- (void)alertView:(UIAlertView *)alertView clickedButtonAtIndex:(NSInteger)buttonIndex;
...
@end
defineClass("JPViewController: UIViewController <UIAlertViewDelegate>", {
viewDidAppear: function(animated) {
var alertView = require('UIAlertView')
.alloc()
.initWithTitle_message_delegate_cancelButtonTitle_otherButtonTitles(
"Alert",
self.dataSource().objectAtIndex(indexPath.row()),
self,
"OK",
null
)
alertView.show()
}
alertView_clickedButtonAtIndex: function(alertView, buttonIndex) {
console.log('clicked index ' + buttonIndex)
}
})
4. 特殊類型
Struct
JSPatch原生支援 CGRect / CGPoint / CGSize / NSRange 這四個 struct 類型,用 JS 對象表示:
// Obj-C
UIView *view = [[UIView alloc] initWithFrame:CGRectMake(20, 20, 100, 100)];
[view setCenter:CGPointMake(10,10)];
[view sizeThatFits:CGSizeMake(100, 100)];
CGFloat x = view.frame.origin.x;
NSRange range = NSMakeRange(0, 1);
// JS
var view = UIView.alloc().initWithFrame({x:20, y:20, width:100, height:100})
view.setCenter({x: 10, y: 10})
view.sizeThatFits({width: 100, height:100})
var x = view.frame().x
var range = {location: 0, length: 1}
其他 Struct 類型的支援請參照 添加 struct 類型支援
Selector
在JS使用字元串代表 Selector:
//Obj-C
[self performSelector:@selector(viewWillAppear:) withObject:@(YES)];
//JS
self.performSelector_withObject("viewWillAppear:", 1)
nil
JS 上的
null
和
undefined
都代表 OC 的
nil
,如果要表示
NSNull
, 用
nsnull
代替:
//Obj-C
@implemention JPTestObject
+ (BOOL)testNull(NSNull *null) {
return [null isKindOfClass:[NSNull class]]
}
@end
//JS
require('JPTestObject').testNull(nsnull) //return 1
require('JPTestObject').testNull(null) //return 0
在JS裡面判斷是否為空要判斷false:
var url = "";
var rawData = NSData.dataWithContentsOfURL(NSURL.URLWithString(url));
if (rawData == null) {} //這樣判斷是錯誤的
應該如下判斷:
if (!rawData){}
在JSPatch.js源碼裡_formatOCToJS方法對undefined,null,isNil轉換成了false。
5. NSArray / NSString / NSDictionary
NSArray / NSString / NSDictionary 不會自動轉成對應的JS類型,像普通 NSObject 一樣使用它們:
//Obj-C
@implementation JPObject
+ (NSArray *)data
{
return @[[NSMutableString stringWithString:@"JS"]]
}
+ (NSMutableDictionary *)dict
{
return [[NSMutableDictionary alloc] init];
}
@end
// JS
require('JPObject')
var ocStr = JPObject.data().objectAtIndex(0)
ocStr.appendString("Patch")
var dict = JPObject.dict()
dict.setObject_forKey(ocStr, 'name')
console.log(dict.objectForKey('name')) //output: JSPatch
如果要把 NSArray / NSString / NSDictionary 轉為對應的 JS 類型,使用
.toJS()
接口:
// JS
var data = require('JPObject').data().toJS()
//data instanceof Array === true
data.push("Patch")
var dict = JPObject.dict()
dict.setObject_forKey(data.join(''), 'name')
dict = dict.toJS()
console.log(dict['name']) //output: JSPatch
6. Block
block 傳遞
當要把 JS 函數作為 block 參數給 OC時,需要先使用
block(paramTypes, function)
接口包裝:
// Obj-C
@implementation JPObject
+ (void)request:(void(^)(NSString *content, BOOL success))callback
{
callback(@"I'm content", YES);
}
@end
// JS
require('JPObject').request(block("NSString *, BOOL", function(ctn, succ) {
if (succ) log(ctn) //output: I'm content
}))
這裡 block 裡的參數類型用字元串表示,寫上這個 block 各個參數的類型,用逗号分隔。NSObject 對象如
NSString *
,
NSArray *
等可以用
id
表示,但 block 對象要用
NSBlock*
表示。
從 OC 傳回給 JS 的 block 會自動轉為 JS function,直接調用即可:
// Obj-C
@implementation JPObject
typedef void (^JSBlock)(NSDictionary *dict);
+ (JSBlock)genBlock
{
NSString *ctn = @"JSPatch";
JSBlock block = ^(NSDictionary *dict) {
NSLog(@"I'm %@, version: %@", ctn, dict[@"v"])
};
return block;
}
+ (void)execBlock:(JSBlock)blk
{
}
@end
// JS
var blk = require('JPObject').genBlock();
blk({v: "0.0.1"}); //output: I'm JSPatch, version: 0.0.1
若要把這個從 OC 傳過來的 block 再傳回給 OC,同樣需要再用
block()
包裝,因為這裡
blk
已經是一個普通的 JS function,跟我們上面定義的 JS function 沒有差別:
// JS
var blk = require('JPObject').genBlock();
blk({v: "0.0.1"}); //output: I'm JSPatch, version: 0.0.1
require('JPObject').execBlock(block("id", blk));
總結:JS 沒有 block 類型的變量,OC 的 block 對象傳到 JS 會變成 JS function,所有要從 JS 傳 block 給 OC 都需要用
block()
接口包裝。
block 裡使用 self 變量
在 block 裡無法使用
self
變量,需要在進入 block 之前使用臨時變量儲存它:
defineClass("JPViewController", {
viewDidLoad: function() {
var slf = self;
require("JPTestObject").callBlock(block(function(){
//`self` is not available here, use `slf` instead.
slf.doSomething();
});
}
}
限制
從 JS 傳 block 到 OC,有兩個限制:
A. block 參數個數最多支援6個。(若需要支援更多,可以修改源碼)
B. block 參數類型不能是
double
。
另外不支援 JS 封裝的 block 傳到 OC 再傳回 JS 去調用(原因見 issue #155):
- (void)callBlock:(void(^)(NSString *str))block {
}
defineClass('JPTestObject', {
run: function() {
self.callBlock(block('NSString*', function(str) {
console.log(str);
}));
},
callBlock: function(blk) {
//blk 這個 block 是上面的 run 函數裡 JS 傳到 OC 再傳過來的,無法調用。
blk("test block");
}
});
7. __weak / __strong
可以在 JS 通過
__weak()
聲明一個 weak 變量,主要用于避免循環引用。
例如我們在 OC 裡為了避免 block 導緻的循環引用,經常這樣寫:
- (void)test {
__weak id weakSelf = self;
[self setCompleteBlock:^(){
[weakSelf blabla];
}]
}
在 JS 對應的可以這樣寫:
var weakSelf = __weak(self)
self.setCompleteBlock(block(function(){
weakSelf.blabla();
}))
若要在使用 weakSelf 時把它變成 strong 變量,可以用
__strong()
接口:
var weakSelf = __weak(self)
self.setCompleteBlock(block(function(){
var storngSelf = __strong(weakSelf)
strongSelf.blabla();
}))
8. GCD
使用
dispatch_after()
dispatch_async_main()
dispatch_sync_main()
dispatch_async_global_queue()
接口調用GCD方法:
// Obj-C
dispatch_after(dispatch_time(DISPATCH_TIME_NOW, (int64_t)(1.0 * NSEC_PER_SEC)), dispatch_get_main_queue(), ^{
// do something
});
dispatch_async(dispatch_get_main_queue(), ^{
// do something
});
// JS
dispatch_after(1.0, function(){
// do something
})
dispatch_async_main(function(){
// do something
})
dispatch_sync_main(function(){
// do something
})
dispatch_async_global_queue(function(){
// do something
})
9. 傳遞 id*
參數
id*
如果你需要傳遞
id*
參數,像
NSURLConnection
裡的這個接口裡的
NSError **
:
+ (NSData *)sendSynchronousRequest:(NSURLRequest *)request returningResponse:(NSURLResponse **)response error:(NSError **)error;
這裡傳入的是一個指向 NSObject 對象的指針,在方法裡可以修改這個指針指向的對象,調用後外部可以拿到新指向的對象,對于這樣的參數,需要按以下步驟進行傳遞和擷取:
- 使用
建立一個指針malloc(sizeof(id))
- 把指針作為參數傳給方法
- 方法調用完,使用
拿到指針新指向的對象pval()
- 使用完後調用
釋放這個對象releaseTmpObj()
- 使用
釋放指針free()
舉個例子:
//OC
- (void)testPointer:(NSError **)error {
NSError *err = [[NSError alloc]initWithDomain:@"com.jspatch" code:42 userInfo:nil];
*error = err;
}
//JS
//malloc() pval() free() is provided by JPMemory extension
require('JPEngine').addExtensions(['JPMemory'])
var pError = malloc(sizeof("id"))
self.testPointer(pError)
var error = pval(pError)
if (!error) {
console.log("success")
} else {
console.log(error)
}
releaseTmpObj(pError)
free(pError)
10. 常量、枚舉、宏、全局變量
常量/枚舉
Objective-C 裡的常量/枚舉不能直接在 JS 上使用,可以直接在 JS 上用具體值代替:
//OC
[btn addTarget:self action:@selector(handleBtn) forControlEvents:UIControlEventTouchUpInside];
//UIControlEventTouchUpInside的值是1<<6
btn.addTarget_action_forControlEvents(self, "handleBtn", 1<<6);
或者在 JS 上重新定義同名的全局變量:
//js
var UIControlEventTouchUpInside = 1 << 6;
btn.addTarget_action_forControlEvents(self, "handleBtn", UIControlEventTouchUpInside);
宏
Objective-C 裡的宏同樣不能直接在 JS 上使用。若定義的宏是一個值,可以在 JS 定義同樣的全局變量代替,若定義的宏是程式,可以在JS展開宏:
#define TABBAR_HEIGHT 40
define SCREEN_WIDTH [[UIScreen mainScreen]bounds].size.height
[view setWidth:SCREEN_WIDTH height:TABBAR_HEIGHT];
//JS
view.setWidth_height(40, UIScreen.mainScreen().bounds().height);
若宏的值是某些在底層才能擷取到的值,例如
CGFLOAT_MIN
,可以通過在某個類或執行個體方法裡将它傳回,或者用添加擴充的方式提供支援:
@implementation JPMacroSupport
+ (void)main:(JSContext *)context
{
context[@"CGFLOAT_MIN"] = ^CGFloat() {
return CGFLOAT_MIN;
}
}
@end
require('JPEngine').addExtensions(['JPMacroSupport'])
var floatMin = CGFLOAT_MIN();
全局變量
在類裡定義的
static
全局變量無法在 JS 上擷取到,若要在 JS 拿到這個變量,需要在 OC 有類方法或執行個體方法把它傳回:
static NSString *name;
@implementation JPTestObject
+ (NSString *)name {
return name;
}
@end
var name = JPTestObject.name() //拿到全局變量值
11. Swift
使用
defineClass()
覆寫 Swift 類時,類名應為
項目名.原類名
,例如項目 demo 裡用 Swift 定義了 ViewController 類,在 JS 覆寫這個類方法時要這樣寫:
defineClass('demo.ViewController', {})
對于調用已在 swift 定義好的類,也是一樣:
require('demo.ViewController')
需要注意幾點:
- 若要調用和替換原生 Swift 類的方法和屬性,需要在 Swift 每一個方法和屬性前加
關鍵字。dynamic
- 繼承自
的 Swift 類,其繼承自父類的方法和屬性可以在 JS 調用,其他自定義方法和屬性同樣需要加NSObject
關鍵字才行。dynamic
- 若方法的參數/屬性類型為 Swift 特有(如 Character / Tuple),則此方法和屬性無法通過 JS 調用。
- Swift 項目在 JSPatch 新增類與 OC 無異,可以正常使用。
詳見這篇文章
12. 加載動态庫
對于 iOS 内置的動态庫,若原 APP 裡沒有加載,可以通過以下方式動态加載,以加載
SafariServices.framework
為例:
var bundle = NSBundle.bundleWithPath("/System/Library/Frameworks/SafariServices.framework");
bundle.load();
加載後就可以使用
SafariServices.framework
了。