React Native与IOS端之间的交互 详解React Native与IOS端之间的交互
Grewer 人气:0前置准备
首先最好了解一点关于 oc 的语法知识
1.创建声明文件nativeModule.h
#import <Foundation/Foundation.h> #import <React/RCTBridgeModule.h> @interface nativeModule : NSObject <RCTBridgeModule> @end
2.创建文件nativeModule.m
#import <Foundation/Foundation.h> #import "nativeModule.h" @interface nativeModule () @end @implementation nativeModule @end
这是添加完文件后的结构目录
关于 interface 的区别:
.h里面的@interface,它是供其它Class调用的。它的@property和functions,都能够被其它Class“看到”(public)
而.m里面的@interface,在OC里叫作Class Extension,是.h文件中@interface的补充。但是.m文件里的@interface,对外是不开放的,只在.m文件里可见(private)
因此,我们将对外开放的方法、变量放到.h文件中,而将不想要对外开放的变量放到.m文件中(.m文件的方法可以不声明,直接用)。
RN 传值给 iOS
方法 1 正常传值给原生
在 .m 文件中添加方法:
// 省略上面的代码 @implementation nativeModule // 这句代码是必须的 用来导出 module, 这样才能在 RN 中访问 nativeModule这个 module RCT_EXPORT_MODULE(); // 接收字符串 RCT_EXPORT_METHOD(addHelloWord:(NSString *)name location:(NSString *)location) { NSLog(@"%@,%@", name, location); } @end
RN 代码:
import { Button, NativeModules } from 'react-native' const { nativeModule } = NativeModules <Button title={'传 2 个参数给 native'} onPress={() => { nativeModule.addHelloWord('你的名字', '位置:浙江') }}/>
点击此按钮的作用,就是将 '你的名字', '位置:浙江' 这 2 个字符串传递到了原生端
方法 2 传递回调函数
在 .m 文件中添加:
// 只接受一个参数——传递给 JavaScript 回调函数的参数数组。 RCT_EXPORT_METHOD(checkIsRoot:(RCTResponseSenderBlock)callback) { NSArray *array = @[@"string", @"number"]; callback(array); }
在 RN 中添加代码:
<Button title={'js 传一个回调给 native,回调中收到一个数组'} onPress={() => { nativeModule.checkIsRoot((str: string, num: string) => { console.log(str, num) }) }}/>
这是在 RN 中 给原生端传递了一个回调函数,用来解决,部分操作完成后的回调, ** 如果 callback 多次调用 RN 会报错 **
方法 3 获取 promise 回调
在 .m 文件中添加代码:
@interface nativeModule () @property (nonatomic) RCTPromiseResolveBlock normalResolve; @property (nonatomic) RCTPromiseRejectBlock normalReject; @property (nonatomic) NSInteger num; @end // 这是一个计时器 -(void)startTime: (NSArray*) data{ NSTimer *timer = [NSTimer scheduledTimerWithTimeInterval:2 repeats:YES block:^(NSTimer * _Nonnull timer) { NSArray *events =@[@"Promise ",@"test ",@" array"]; if (events) { self.normalResolve(events); [timer invalidate]; } else { [timer invalidate]; NSError *error=[NSError errorWithDomain:@"我是回调错误信息..." code:101 userInfo:nil]; self.normalReject(@"no_events", @"There were no events", error); } }]; [[NSRunLoop mainRunLoop] addTimer:timer forMode:NSDefaultRunLoopMode]; } // 回调给RN的参数,回调的错误信息 RCT_EXPORT_METHOD(getHBDeviceUniqueID: (RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject) { // 要执行的任务 self.normalResolve = resolve; self.normalReject = reject; [self performSelectorOnMainThread:@selector(startTime:) withObject: [NSArray arrayWithObjects: @"1", @"2", nil] waitUntilDone:YES]; }
在 RN 中添加代码:
<Button title={'native传一个 promise 给 JS'} onPress={() => { nativeModule.getHBDeviceUniqueID().then((arr: string[]) => { console.log('resolve', arr) }).catch((err: string) => { console.error(err) }) }}/>
nativeModule.getHBDeviceUniqueID 的执行他是一个 promise,可以获取原生端的回调, 其实和方法 2 差不多
方法 4 获取 promise 的同步方式
在 .m 文件中添加:
// 这是一个计时器2 -(void)startTime2: (NSArray*) data{ NSLog(@"data%@",data); NSTimer *timer = [NSTimer scheduledTimerWithTimeInterval:1 repeats:YES block:^(NSTimer * _Nonnull timer) { NSLog(@"%d", (int)self.num); self.num = self.num + 1; NSLog(@"%d", (int)self.num); if (self.num > 4) { [timer invalidate]; NSLog(@"end"); self.normalResolve(data); } }]; [[NSRunLoop mainRunLoop] addTimer:timer forMode:NSDefaultRunLoopMode]; } // RCT_REMAP_METHOD 与RCT_EXPORT_METHOD相同,但是该方法是在JS线程上从JS同步调用的,可能会返回结果。 // 同步可能会有性能问题 建议除了 promise 以外都别使用 RCT_REMAP_METHOD(findEvents, findEventsWithResolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject) { self.normalResolve = resolve; self.normalReject = reject; self.num = 0; [self performSelectorOnMainThread:@selector(startTime2:) withObject: [NSArray arrayWithObjects: @"1", @"2", nil] waitUntilDone:YES]; }
在 RN 端添加代码:
<Button title={'native传一个 promise 给 JS2'} onPress={() => { nativeModule.findEvents().then((arr: string[]) => { console.log('resolve', arr) }).catch((err: string) => { console.error(err) }) }}/>
方法 4 和方法 3 大体一致,但是有一点不同,就是 RCT_REMAP_METHOD 使用此方法会将代码变成同步状态
iOS 传值给 RN 端
初始的数据提供
在 appDelegate.m 文件中添加代码:
NSArray *imageList = @[@"http://foo.com/bar1.png", @"http://foo.com/bar2.png"]; NSDictionary *props = @{@"images" : imageList}; RCTRootView *rootView = [[RCTRootView alloc] initWithBridge:bridge moduleName:@"learn" initialProperties:props]; // 这一行代码原本就有,不同点在于 initialProperties:props
在 RN 端写入:
// 重写 APP , images就是 iOS 提供的数据,这里我们通过 context 来传递数据 export default class App extends React.Component<{ images: string[] }> { render() { return <NativeProps.Provider value={this.props.images}> <AppContainer/> </NativeProps.Provider> } } // 在 hooks 里简单的使用 const images = useContext(NativeProps); <Text>这是从 native 端传来的初始数据{JSON.stringify(images)}</Text>
添加监听事件
在 .m 文件中添加代码:
// 可供监听的事件名称 - (NSArray<NSString *> *)supportedEvents { return @[@"EventReminder"]; } RCT_EXPORT_METHOD(postNotificationEvent:(NSString *)name) { NSLog(@"calendarEventReminderReceived"); [self sendEventWithName:@"EventReminder" body:@{@"name": name}];; } - (void)calendarEventReminderReceived:(NSNotification *)notification { // 这是官网的例子 NSLog(@"calendarEventReminderReceived"); NSString *eventName = notification.userInfo[@"name"]; [self sendEventWithName:@"EventReminder" body:@{@"name": eventName}]; } RCT_EXPORT_METHOD(Send){ NSDictionary *dict = @{@"name" : @"veuimyzi"}; NSNotification *notification = [[NSNotification alloc] initWithName:@"EventReminder" object:nil userInfo:dict] ; [self calendarEventReminderReceived:notification]; }
在 RN 中添加代码:
const ManagerEmitter = new NativeEventEmitter(nativeModule) const [msg, setMsg] = useState([]) // hooks 中的使用,类似于 componentDidMount 生命周期 useEffect(() => { const subscription = ManagerEmitter.addListener( 'EventReminder', (reminder) => { setMsg(prevState => { return prevState.concat(reminder.name) }) console.log('这是监听的EventReminder事件回复', reminder.name) } ) return () => { subscription.remove() } }, []) <Button title={'js 监听事件,让 native 给 js 发通知'} onPress={() => { nativeModule.postNotificationEvent('test') }}/> <Button title={'js 监听事件,让 native 给 js 发通知 send'} onPress={() => { nativeModule.Send() }}/> { msg.map((item, index) => { return <Text key={item + index}>item:{item}</Text> }) }
关于 postNotificationEvent 方法是属于最简单的使用, 在原生端调用 sendEventWithName 就可以传递数据给 RN 的监听
而另一个方法 Send 和 calendarEventReminderReceived ,一个是来自于官网的实例 讲的是从 NSNotification获取数据, Send 是传递数据给 calendarEventReminderReceived
关于监听的优化, 这个官网上也有,有空可以看下,就是在 .m 文件中添加下列代码:
@implementation nativeModule { bool hasListeners; // 一个局部变量 } -(void)startObserving { hasListeners = YES; } -(void)stopObserving { hasListeners = NO; } // 在发送监听的添加判断,如果有监听才发送,有效减少桥接代码的调用 if (hasListeners) { [self sendEventWithName:@"EventReminder" body:@{@"name": name}];; }
总结
上述代码的库: https://github.com/Grewer/learn-rn
关于原生端和 RN 端的交互基本就是这些了,当然原生端还有更多,更复杂的操作,比如进程什么的,如果想写桥接方法,这个也会碰到很多,不过掌握了上面这些,对于一些三方 SDK 的调用是够用了
加载全部内容