JSPatch常见问题解答

2022-11-05 11:33:04

原文地址：https://github.com/bang590/JSPatch/wiki/JSPatch%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98%E8%A7%A3%E7%AD%94

一、block使用规则

1、在 JSPatch 若要向 Objective-C 传递 block，需要使用 block(paramTypes, function) 函数封装：Block的详细使用方法，封装后的值已经不是 JS 函数，不能直接在 JS 上调用：

var blk = block("BOOL", function(b){

})

blk(1) //crash

若想在 JS 上调用，请调用封装前的函数：

var func = function(b){

};

var blk = block("BOOL", func)

func(1) //it's OK

2、不允许在 JS 的 block 中传入含有 undefined 的数组或对象。比如传入 ["JSPatch", undefined] 的数组或 {obj: undefined} 的对象，这种语法在 JavaScript 中没有错误，但是在 Objective-C 中是不允许的。

3、如果 block 的参数里含有 block，paramTypes 需要写成 NSBlock *。

var blk = block("BOOL, NSBlock *", function(b, blk){

  if (b) {

    blk(true)

  }

})

4、在 Objective-C 中传入到 JSPatch 中的 Block 会转换为 function，如果需要再将该 Block 传回到 OC，依旧需要用 block(paramTypes, function) 封装。

//Objective-C代码

- (void)excuteBlock:(JSBlock)block {

    if (block) {

        block(@"Hello, JSPatch");

    }

}

- (JSBlock)returnBlock {

    JSBlock block = ^(NSString *str) {

        NSLog(@"%@", str);

    };

    return block;

}

//JSPatch脚本

var blk = self.returnBlock()

self.excuteBlock(block("NSString *", blk))

5、暂时不支持向OC端传递含有浮点型参数的block，比如如下的情况:

//Objective-C代码

typedef void (^JSBlock)(CGFloat fl);

- (void)doBlock:(JSBlock)blk {

    if (blk) {

        blk(123.456f);

    }

}

//JSPatch脚本

self.doBlock(block("CGFloat",function(fl){

        console.log(fl)  //得到的结果不会是你想要的结果

     }

))

6、在block中使用到self时，需要在使用block之前先将self赋值给另外一个变量，然后在block中使用这个变量。如：

//JSPatch脚本

var slf = self

self.requestWithCompletion(block("BOOL, NSError*", function(success, error){

    slf.label().setText("complete")

})

)

二、在 JSPatch 中表示 `nil` 和 `[NSNull null]` 及使用其他特殊类型

1、在 JSPatch 中使用 null 或 undefined 来表示 Objective-C 的 nil，使用 nsnull 表示[NSNull null]。

2、在 JSPatch 中判断 Objective-C对象是否为空时，使用 if(!obj){} 的形式而不能使用 if(obj == null){} 或 if(obj == undefined){}

3、在 JSPatch 中使用 struct、selector 的用法可参考这里

三、调用包含`id *`类型参数的方法

详见基础用法 - 传递 id* 参数

四、在 JSPatch 使用父类方法

使用 self.super() 调用父类方法

defineClass("JPTableViewController", {

  viewDidLoad: function() {

     self.super().viewDidLoad();

  }

})

五、调用多参数的方法

JSPatch 中使用 _ 来替代Objective-C中的 :, 多以调用多参数的 Objective-C 方法需要像下面这样。

var error = require('NSError').errorWithDomain_code_userInfo("UnKnown_Error", -1, null)

如果调用的方法含有一个下划线，就需要使用双下划线来表示。例如:

- (void)p_privateMethod;

JSPatch中可以这样调用

self.p__privateMethod()

不支持方法中含有双（或更多）下划线的方法，如 - (void)p__privateMethod;。但是如果是要获取含有双（或更多）下划线的property(这种情况比带有双下划线的方法更为常见一些)，可以使用 KVC 的 valueForKey 方法。例如:

@property (nonatomic, string) id __privateObject;

JSPatch中可以这样获取

var obj = self.valueForKey("__privateObject")

六、JSPatch 中的 NSArray，NSString，NSDictionary

在 JSPatch 中不能将 Objective-C 中的 NSArray, NSString, NSDictionary 与 JavaScript 的Array, String, Object 进行混用。

//Objective-C

- (NSArray *)returnNSArray {

    return @[@"Objective-C", @"Swift"];

}

var nsarray = self.returnNSArray()

var array = ["Objective-C", "Swift"]

//这两者不能混用，因为他们是不同的类型。

var wrongStr = nsarray[0] //得到的是一个不正确的对象，请不要使用取下标的方式获取NSArray/NSDictionar对象。

var rightStr = nsarray.toJS()[0] //先unbox返回的对象，然后取出其中的数据

或

var rightStr = nsarray.objectAtIndex(0) //使用Objective-C方法获取NSArray/NSDictionary中的对象

具体可参考基础用法文档

七、常量与宏

Objective-C 里的常量不能直接在 JS 上使用，可以直接在 JS 上用具体值代替，或者在 JS 上重新定义同名的全局变量：

//js

var UIRectEdgeNone   = 0,

    UIRectEdgeTop    = 1 << 0,

    UIRectEdgeLeft   = 1 << 1,

    UIRectEdgeBottom = 1 << 2,

    UIRectEdgeRight  = 1 << 3

Objective-C 里的宏同样不能直接在 JS 上使用，若定义的宏是一个值，可以在 JS 定义同样的全局变量代替，若定义的宏是程序，或者在底层才能获取到的值，例如 CGFLOAT_MIN，可以通过添加扩展的方式提供支持：

@implementation JPMacroSupport

+ (void)main:(JSContext *)context

{

  context[@"CGFLOAT_MIN"] = ^CGFloat() {

    return CGFLOAT_MIN;

  }

}

@end

require('JPEngine').addExtensions(['JPMacroSupport'])

var floatMin = CGFLOAT_MIN();

八、Property / 私有变量的获取和赋值

详见 defineClass使用文档

九、类全局变量

目前在类里定义的 static 全局变量无法在 JS 上获取到，若要在 JS 拿到这个变量，需要在 OC 有类方法或实例方法它返回：

static NSString *name;

@implementation JPTestObject

+ (NSString *)name {

  return name;

}

@end

var name = JPTestObject.name() //拿到全局变量值

十、Swift

使用 defineClass() 覆盖 Swift 类时，类名应为 项目名.原类名，例如项目 demo 里用 Swift 定义了 ViewController 类，在 JS 覆盖这个类方法时要这样写：

defineClass('demo.ViewController', {})

十一、可变参数

JSPatch 不支持带可变参数方法的调用，例如：

//OC: [NSString stringWithFormat:@"%d %@", i, obj];

NSString.stringWithFormat("%d %@", i, obj);  //not working

因为 JSPatch 原理是通过 NSInvocation 动态调用方法，而 NSInvocation 不支持可变参数，参见官方文档。

十二、其他问题

不可以使用 require('NSNumber').alloc()，原因见这里

码农公寓