Android
建立原生模块包
- 经由过程继续 ReactPackage 为你的原生模块包建立 Java 类,能够这么写:
- 掩盖
createNativeModules
和createViewManagers
要领
public class MyNativePackage implements ReactPackage {
@Override
public List<NativeModule> createNativeModules(ReactApplicationContext reactContext) {
}
@Override
public List<ViewManager> createViewManagers(ReactApplicationContext reactContext) {
}
}
- 在
createNativeModules
要领中增加原生模块
public List<NativeModule> createNativeModules(ReactApplicationContext reactContext) {
List<NativeModule> modules = new ArrayList<>();
modules.add(new MyNativeModule(reactContext));
return modules;
}
- 在
createViewManagers
要领中增加原生 UI 组件
public List<ViewManager> createViewManagers(ReactApplicationContext reactContext) {
List<ViewManager> 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 要领。
@Override
public 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 } = NativeModules
MyNativeModule.Show(
{}, //Config Parameters
() => {}, //Success Callback
() => {} //Cancel Callback
)
注重:
- 模块要领只供应静态援用,不包括于 react 树中。
建立原生 UI 组件
- 假如你需要在 react 树中衬着一个原声 UI 组件
- 建立一个继续 ReactNative ViewGroupManager 的 Java 类
public class RNNativeComponent extends ViewGroupManager<ViewGroup> {
public static final String REACT_CLASS = "RNNativeComponent";
}
- 掩盖
getName
要领:
@Override
public 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: { }
})
<MyNativeComponent prop={this.props.prop}>
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 <RCTBridgeModule>
@end
- MyNativePackage.m
#import "MyNativePackage.h"
@implementation MyNativePackage
RCT_EXPORT_MODULE();
@end
建立模块要领
RCT_EXPORT_METHOD(Show:(RCTResponseSenderBlock)callback) {
}
- JavaScript 中引入模块要领
import { NativeModules } from 'react-native'
const MyNativeModule = NativeModules.MyNativeModule
MyNativeModule.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: { }
})
<MyNativeComponent prop={this.props.prop}>