原文出自: 博客链接:
Android
创建原生模块包
- 通过继承 ReactPackage 为你的原生模块包创建 Java 类,可以这么写:
- 覆盖
createNativeModules
和createViewManagers
方法
public class MyNativePackage implements ReactPackage { @Override public ListcreateNativeModules(ReactApplicationContext reactContext) { } @Override public List createViewManagers(ReactApplicationContext reactContext) { }}
- 在
createNativeModules
方法中添加原生模块
public ListcreateNativeModules(ReactApplicationContext reactContext) { List modules = new ArrayList<>(); modules.add(new MyNativeModule(reactContext)); return modules;}
- 在
createViewManagers
方法中添加原生 UI 组件
public ListcreateViewManagers(ReactApplicationContext reactContext) { List components = new ArrayList<>(); components.add(new RNNativeComponent()); return components;}
创建原生模块
- 先通过继承 ReactContextBaseJavaModule 创建 MyNativeModule 类。
public class MyNativeModule extends ReactContextBaseJavaModule { public MyNativeModule(ReactApplicationContext reactContext) { super(reactContext); }}
- 为了让 React Native 在 NativeModules 中找到我们的模块,我们还需要覆盖 getName 方法。
@Overridepublic String getName() { return "MyNativeModule";}
- 现在我们已经拥有一个可以导入到 JavaScript 代码的原生模块,现在可以向其中加入功能。
- 暴露模块方法:定义一个接受设置参数、成功回调和失败回调的
Show
方法。
public class MyNativeModule extends ReactContextBaseJavaModule { @ReactMethod public void Show(ReadableMap config, Callback successCallback, Callback cancelCallback) { Activity currentActivity = getCurrentActivity(); if (currentActivity == null) { cancelCallback.invoke("Activity doesn't exist"); return; } }}
- 在 JavaScript 中调用模块方法
import { NativeModules } from 'react-native'const { MyNativeModule } = NativeModulesMyNativeModule.Show( {}, //Config Parameters () => {}, //Success Callback () => {} //Cancel Callback)
注意:
- 模块方法只提供静态引用,不包含于 react 树中。
创建原生 UI 组件
- 如果你需要在 react 树中渲染一个原声 UI 组件
- 创建一个继承 ReactNative ViewGroupManager 的 Java 类
public class RNNativeComponent extends ViewGroupManager{ public static final String REACT_CLASS = "RNNativeComponent";}
- 覆盖
getName
方法:
@Overridepublic String getName() { return REACT_CLASS;}
- 覆盖
createViewInstance
方法,返回你的自定义原生组件
@Override protected FrameLayout createViewInstance(final ThemedReactContext reactContext) { return //用 FrameLayout 包裹的自定义原生组件 }
- 创建原生 prop 方法
@ReactProp(name = "prop_name") public void setPropName(NativeComponent nativeComponent, propDataType prop) { }
- JavaScript 中使用
import { requireNativeComponent } from "react-native"const MyNativeComponent = requireNativeComponent("RNNativeComponent", RNNativeComponent, { nativeOnly: { }})
iOS
Macro
- RCTBridgeModule: RCTBridgeModule 是一个 protocol,它为注册 bridge 模块 RCTBridgeModule
@protocol RCTBridgeModule
提供了一个接口 - RCT_EXPORT_MODULE(js_name): 在 class implementation 时使用 bridge 注册你的模块。参数 js_name 是可选的,用作 JS 模块的名称,若不定义,将会默认使用 Objective-C 的 class 名
- RCT_EXPORT_METHOD(method)RCT_REMAP_METHOD(, method): bridge 模块亦可定义方法,这些方法可以作为
NativeModules.ModuleName.methodName
输出到 JavaScript。
RCT_EXPORT_METHOD(funcName:(NSString *)onlyString secondName:(NSInteger)argInteger) { ... }
上面的例子暴露到 JavaScript 是 NativeModules.ModuleName.funcName
创建原生模块包
我们需要在项目中添加两个文件:头文件和源文件。
- MyNativePackage.h#import "RCTBridgeModule.h"@interface MyNativePackage : NSObject@end- MyNativePackage.m#import "MyNativePackage.h"@implementation MyNativePackageRCT_EXPORT_MODULE();@end
创建模块方法
RCT_EXPORT_METHOD(Show:(RCTResponseSenderBlock)callback) {}
- JavaScript 中引入模块方法
import { NativeModules } from 'react-native'const MyNativeModule = NativeModules.MyNativeModuleMyNativeModule.Show(() => {})
创建原生 View 组件
- 创建 view 方法,返回你的原声组件
- (UIView *)view { //Initialize & return your native component view}
- 创建原生 prop 方法
RCT_CUSTOM_VIEW_PROPERTY(prop, DATA_TYPE_OF_PROP, YOUR_NATIVE_COMPONENT_CLASS) {}
- 在 JavaScript 中使用
import { requireNativeComponent } from "react-native"const MyNativeComponent = requireNativeComponent("RNNativeComponent", RNNativeComponent, { nativeOnly: { }})