ReactNative之iOS原生和JavaScript的交互

原文博客地址: www.titanjun.top/ReactNative…html

在ReactNative开发中, 在JavaScript语法没法实现的时候会涉及到一些原生开发, 既然是混合开发就会涉及到一些iOS和ReactNative之间通信的问题, 这里就涉及到两种方式:react

RN调用原生的方法, 给原生发送数据
原生给RN回传数据, 或者给RN发送通知
下面就简单记录下这两种方式的实现

JS调用原生

这里要讲的交互场景是JS调用原生方法，最后由原生方法将结果回调到JS里面
react-native是在原生的基础上，将接口调用统一为js
也就是说，react-native调起原生的能力很是重要

js调用模块

在原生须要建立一个继承自NSObject的类(模块)ios

#import <Foundation/Foundation.h>
// 须要导入头文件
#import <React/RCTBridgeModule.h>

// 必须遵循RCTBridgeModule协议
@interface AppEventMoudle : NSObject <RCTBridgeModule>

@end
复制代码

在AppEventMoudle.m文件件中须要导出改模块, 并将建立的方法导出web

#import "AppEventMoudle.h"
#import <React/RCTBridge.h>

@implementation AppEventMoudle


// 导出桥接模块, 参数传空或者当前class的类名
// 参数若为空, 默认模块名为当前class类名即AppEventMoudle
RCT_EXPORT_MODULE(AppEventMoudle);

// 带有参数
RCT_EXPORT_METHOD(OpenView:(NSDictionary *)params){
    
    // 由于是显示页面，因此让原生接口运行在主线程
    dispatch_async(dispatch_get_main_queue(), ^{
    
        // 在这里能够写须要原生处理的UI或者逻辑
        NSLog(@"params = %@", params);
    });
}

/// 带有回调
RCT_EXPORT_METHOD(OpenView:(NSDictionary *)params, callback:(RCTResponseSenderBlock)callback){
    
    // 由于是显示页面，因此让原生接口运行在主线程
    dispatch_async(dispatch_get_main_queue(), ^{
    
        // 在这里能够写须要原生处理的UI或者逻辑
        NSLog(@"params = %@", params);
        if (callback) {
            callback(@[params]);
        }
    });
}
复制代码

上面代码须要注意的是react-native

桥接到Javascript的方法返回值类型必须是void
React Native的桥接操做是异步的，在queue里面异步执行，因此若是要返回结果给Javascript，就必须经过回调或者触发事件来进行
这里的回调对应于iOS端就是经过block来回调的

RCTBridge

RCTBridge能够说是一个封装类,封装了RCTCxxBridge
咱们先看这个文件提供的一些变量和方法
RCTModuleClasses: 主要储存的是咱们注册的module, 全部用宏RCT_EXPORT_MODULE()注册的module都会存入这个变量.
RCTGetModuleClasses: 获取RCTModuleClasses里面全部注册的module类
RCTBridgeModuleNameForClass: 从一个类获取这个类的名字
RCTVerifyAllModulesExported: 验证咱们所写的全部遵照RCTBridgeModule协议的类是否都在咱们的管理中

RCTResponseSenderBlock

typedef void (^RCTResponseSenderBlock)(NSArray *response);
复制代码

RCTResponseSenderBlock是RCTBridgeModule里面提供的block
这个block接受一个数组参数, 表明原生方法的返回结果

线程问题

js代码的执行是在js线程里面，原生模块的执行默认是在一个串行的queue里面异步执行的
对于原生模块的执行来讲，默认一个串行的queue是不够的，咱们有时候须要指定模块全部任务执行所在的queue

RCT_EXPORT_METHOD(OpenView:(NSDictionary *)params){
    
    // 由于是显示页面，因此让原生接口运行在主线程
    dispatch_async(dispatch_get_main_queue(), ^{
    
        // 在这里能够写须要原生处理的UI或者逻辑
        NSLog(@"params = %@", params);
    });
}
复制代码

原生向RN发送监听

例如: 项目中的H5页面, 经过原生的Webview实现, 而且监听url的变化, 并通知js作相关操做
这样咱们就要在url变化的时候, 给JavaScript发送监听通知
而且不能使用RCTResponseSenderBlock进行回调, block回调只能执行一次, 并不能不断的执行

第一步

咱们须要建立一个WebViewController的控制器, 在该控制器内添加UIWebView的UI和逻辑的实现
在UIWebViewDelegate的协议方法中监听webview的url的变化, 并发送通知

- (BOOL)webView:(UIWebView *)webView shouldStartLoadWithRequest:(NSURLRequest *)request navigationType:(UIWebViewNavigationType)navigationType {
  NSString *url= request.URL.absoluteString;
  if (url && ![url isEqualToString:@""]) {
    // 发送通知
    [[NSNotificationCenter defaultCenter] postNotificationName:@"urlChange" object:url];
  }
  [self clickAction:url];
  
  return YES;
}
复制代码

第二步

须要在js调用的方法中接受上述代码中发送的通知, 以下数组

RCT_EXPORT_METHOD(OpenWebView:(NSDictionary *)params){
    dispatch_async(dispatch_get_main_queue(), ^{
        // 接受通知监听
        [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(urlChange:) name:@"urlChange" object:nil];
        
        WebViewController *webView = [WebViewController new];
        webView.params = params;
        UINavigationController *navi = [[UINavigationController alloc] initWithRootViewController:webView];
        
        UIViewController *rootVC = [UIApplication sharedApplication].keyWindow.rootViewController;
        [rootVC presentViewController:navi animated:YES completion:nil];
    });
}
复制代码

第三步

实现监听方法, 并给JavaScript发送消息通知微信

- (void)urlChange:(NSNotification *)notification{
  [self.bridge.eventDispatcher sendAppEventWithName:@"NativeWebView"
                                               body:@{@"url":(NSString *)notification.object}];
}
复制代码

要获取self.bridge属性, 须要遵循RCTBridgeModule协议, 并加上以下代码markdown

@synthesize bridge = _bridge;
复制代码

最后不要忘记移除该通知并发

- (void)dealloc {
  [[NSNotificationCenter defaultCenter] removeObserver:self name:@"urlChange" object:nil];
}
复制代码

第四步

在JavaScript中接受iOS原生发送的消息通知app

this.webViewListener = NativeAppEventEmitter.addListener('NativeWebView', message => {
	this.handleMessageFromNative(message)
})


// 并在对应的位置销毁便可
this.webViewListener && this.webViewListener.remove()
this.webViewListener = null
复制代码

原生给js发送事件

上面提到的那种方式都是js调用iOS原生代码后, 用iOS原生在给js发送事件监听
那么若是须要iOS原生主动给js发送监听事件呢, 相似场景: 好比在AppDelegate中给js发送事件通知有改如何实现
以前遇到过这样一个需求: 须要监听APP进入后台和APP从后台进入前台的事件, 并在JavaScript中作相关操做
不能像以前那种, 定义一个_bridge, 并遵循RCTBridgeModule协议, 就可使用下面代码发送监听事件了, 加断点能够发现, 下面获取的self.bridge为nil

-(void)applicationDidEnterBackground:(UIApplication *)application {
    // 这里的self.bridge为nil
  [self.bridge.eventDispatcher sendAppEventWithName:@"NativeWebView"
                                               body:@{@"url":(NSString *)notification.object}];
}
复制代码

下面先介绍一个消息监听的实例类

RCTEventEmitter

RCTEventEmitter是一个基类, 用于发出JavaScript须要监听的事件, 提供了一下属性和方法

@interface RCTEventEmitter : NSObject <RCTBridgeModule>

@property (nonatomic, weak) RCTBridge *bridge;

// 返回你将要发送的消息的name, 若是有未添加的, 运行时将会报错
- (NSArray<NSString *> *)supportedEvents;

// 用于发送消息事件
- (void)sendEventWithName:(NSString *)name body:(id)body;

// 在子类中重写此方法, 用于发送/移除消息通知
- (void)startObserving;
- (void)stopObserving;

// 添加监听和移除监听
- (void)addListener:(NSString *)eventName;
- (void)removeListeners:(double)count;

@end
复制代码

具体的使用示例, 可继续向下看

第一步

建立一个继承自RCTEventEmitter的类, 并遵循协议<RCTBridgeModule>

#import <Foundation/Foundation.h>
#import <React/RCTBridgeModule.h>

NS_ASSUME_NONNULL_BEGIN

@interface AppEventManager : RCTEventEmitter <RCTBridgeModule>

@end

NS_ASSUME_NONNULL_END
复制代码

第二步

再具体的iOS原生代码中发送消息通知

#import "AppEventManager.h"

@implementation AppEventManager

// 导出该模块
RCT_EXPORT_MODULE();

// 返回sendEventWithName中监听的name, 若是有监听, 可是为在该方法中添加的, 运行时会报错
- (NSArray<NSString *> *)supportedEvents {
    return @[@"DidEnterBackground", @"DidBecomeActive"];
}

// 添加观察者事件, 重写该方法中, 并在该方法中接受消息通知
- (void)startObserving {
    [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(applicationDidEnterBackground:) name:@"DidEnterBackground" object:nil];
    [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(applicationDidBecomeActive:) name:@"DidBecomeActive" object:nil];
}

// 移除观察者
- (void)stopObserving {
    [[NSNotificationCenter defaultCenter] removeObserver:self];
}


- (void)applicationDidEnterBackground:(NSNotification *)notification{
    // 在此处向JavaScript发送监听事件
    [self sendEventWithName:@"DidEnterBackground" body: notification.object];
}

- (void)applicationDidBecomeActive:(NSNotification *)notification{
    // 在此处向JavaScript发送监听事件
    [self sendEventWithName:@"DidBecomeActive" body: notification.object];
}
复制代码

注意

一旦RCT_EXPORT_MODULE()声明该类是EXPORT_MODULE, 那么该类的实例已经建立好了
若是你在其余地方建立这个类的实例(alloc 或 new), 会致使,ReactNative不能正确识别该类的实例

第三步

在ReactNative中引用该模块, 并添加对对应事件的监听便可

先导出iOS原生定义的模块

// AppEventManager为原生中建立的类名
const appEventMan = new NativeEventEmitter(NativeModules.AppEventManager)
复制代码

使用appEventMan在对应的地方添加监听便可

this.didEnterBackground = appEventMan.addListener('DidEnterBackground', () => {
	console.log(`APP开始进入后台---------------`)
})

this.didBecomeActive = appEventMan.addListener('DidBecomeActive', () => {
	console.log(`APP开始从后台进入前台----------`)
})
复制代码

可是也不要忘记在对应的地方移除该监听

componentWillUnmount () {
	this.didEnterBackground && this.didEnterBackground.remove()
	this.didEnterBackground = null
	
	this.didBecomeActive && this.didBecomeActive.remove()
	this.didBecomeActive = null
}
复制代码

至此, 在ReactNative中JavaScript和iOS原生的交互基本就结束了, O(∩_∩)O哈哈~

欢迎您扫一扫下面的微信公众号，订阅个人博客！