参考官方文档初始化一个react-native项目
初始化项目
react-native init androidToast
生成如下目录:
运行命令查看项目
react-native run-android
如图:
接入Android原生模块
按照官方的说法,第一步需要创建一个java类 本例中为:ToastModule ,并继承 ReactContextBaseJavaModule ,然后复写 getName() 方法,其返回值,就是在 react-native 中引用的 组件名称
复写 getConstants() 方法可以返回一些 常量 用于react-native中调用,官方文档中 return "ToastAndroid" 这个名称在原生的组件中已经存在,返回相同的名称将会冲突,so:改个名字吧!!
@ReactMethod 注解:用于java返回一个 react-native 中可调用的 方法 ,其不能有返回值所以使用 void
注册模块:创建java类 本例中为:ExampleReactPackage ,实现 ReactPackage 接口
复写createJSModules() , createViewManagers() 方法,返回 Collections.emptyList() 空集合
createNativeModules() 方法中添加我们需注册的模块对象, new ToastModule() ,并返回模块集合
添加已注册模块对象到返回集合中,向react-native抛出模块,如:第三步
在react-native中调用,如:第四步
android目录结构
注意:引入包的名称不要弄错了
Java React-native基本类型对照
Java | RN |
---|---|
Boolean | Bool |
Integer | Number |
Double | Number |
Float | Number |
String | String |
Callback | function |
ReadableMap | Object |
ReadableArray | Array |
第一步 创建模块类
在androidtoast目录下,创建一个ToastModule.java的类
package com.androidtoast; //包名 import android.widget.Toast; //引入调用的类 import com.facebook.react.bridge.ReactApplicationContext; import com.facebook.react.bridge.ReactContextBaseJavaModule; import com.facebook.react.bridge.ReactMethod; import com.facebook.react.uimanager.IllegalViewOperationException; import java.util.Map; import java.util.HashMap; public class ToastModule extends ReactContextBaseJavaModule { private static final String DURATION_SHORT_KEY = "SHORT"; private static final String DURATION_LONG_KEY = "LONG"; public ToastModule(ReactApplicationContext reactContext) { super(reactContext); } // 复写方法,返回react-native中调用的 组件名 @Override public String getName() { return "ToastNative"; } // 复写方法,返回常量 @Override public Map<String, Object> getConstants() { final Map<String, Object> constants = new HashMap<>(); constants.put(DURATION_SHORT_KEY, Toast.LENGTH_SHORT); constants.put(DURATION_LONG_KEY, Toast.LENGTH_LONG); return constants; } // 使用 @ReactMethod注解返回react-native中可调用的 方法 @ReactMethod public void show(String message, int duration) { Toast.makeText(getReactApplicationContext(), message, duration).show(); } }
第二步 注册模块
在androidtoast目录下,创建一个ExampleReactPackage.java的类
package com.androidtoast; import android.widget.Toast; import com.facebook.react.bridge.NativeModule; import com.facebook.react.bridge.ReactApplicationContext; import com.facebook.react.bridge.ReactMethod; import com.facebook.react.ReactPackage; import com.facebook.react.bridge.JavaScriptModule; import com.facebook.react.uimanager.ViewManager; import java.util.ArrayList; import java.util.Collections; import java.util.List; public class ExampleReactPackage implements ReactPackage { @Override public List<Class<? extends JavaScriptModule>> createJSModules() { return Collections.emptyList(); } @Override public List<ViewManager> createViewManagers(ReactApplicationContext reactContext) { return Collections.emptyList(); } @Override public List<NativeModule> createNativeModules( ReactApplicationContext reactContext) { List<NativeModule> modules = new ArrayList<>(); modules.add(new ToastModule(reactContext)); return modules; } }
第三步 添加注册类
添加到 MainApplication.java 中的 getPackages() 方法中
@Override protected List<ReactPackage> getPackages() { return Arrays.<ReactPackage>asList( new MainReactPackage(), // 这个是自动创建 new ExampleReactPackage() // 这个类是我们创建的 ); }
项目结构如下:
Java部分的代码就结束了,再次提醒下:包名啊!!不要弄错了!!!
第四步 修改react-native代码引入原生模块
修改index.android.js
- 引入react-native所需模块 NativeModules
- 获取导出组件 NativeModules.ToastNative
- 调用方法 show()
修改了下index.android.js文件,代码如下:
/** * Sample React Native App * https://github.com/facebook/react-native * @flow */ import React, { Component } from 'react'; import { AppRegistry, StyleSheet, Text, View, TouchableOpacity, NativeModules } from 'react-native'; let toast = NativeModules.ToastNative; export default class androidToast extends Component { render() { return ( <View style={styles.container}> <Text style={styles.title}>react-native 调用android原生模块</Text> <TouchableOpacity onPress={()=>{ toast.show('Toast message',toast.SHORT); }}> <Text style={styles.btn}>Click Me</Text> </TouchableOpacity> </View> ); } } const styles = StyleSheet.create({ container: { flex: 1, justifyContent: 'center', alignItems: 'center', backgroundColor: '#F5FCFF', }, title:{ fontSize:16, }, btn:{ fontSize:16, paddingVertical:7, paddingHorizontal:10, borderColor:'#f00', borderWidth:1, borderRadius:5, marginTop:10, color:'#f00' } }); AppRegistry.registerComponent('androidToast', () => androidToast);
运行程序
react-native run-android
效果如下:
react-native回调函数
*java中提供了一个 Callback 的数据类型对应了react-native中的 function *
具体操作就是在@ReactMethod注解的返回函数中 添加 类型 为 Callback 的参数,并通过 invoke(...params) 调用
RN中通过调用show方法时提供对应的回调函数就可以了, :smile:
- 修改 ToastModule.java 代码中 show() 方法,添加回调
注意引包!! import com.facebook.react.bridge.Callback;
// 说明下:count,flag是我自定义的变量 @ReactMethod public void show(String message, int duration ,Callback successCallback, Callback errorCallback) { Toast.makeText(getReactApplicationContext(), message, duration).show(); // 通过invoke调用,随便你传参 if(flag) successCallback.invoke("success", ++count); else errorCallback.invoke("error", ++count); flag = !flag; }
- 修改 index.android.js 中调用函数
<TouchableOpacity onPress={()=>{ toast.show('Toast message',toast.SHORT,(message,count)=>{console.log("==",message,count)},(message,count)=>{console.log("++",message,count)}); }}>
:ok_hand: ,试试看吧~~
触发事件
首先我们定义一个发送事件的方法
private void sendEvent(ReactContext reactContext, String eventName, @Nullable WritableMap params){ reactContext .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter.class) .emit(eventName, params); }
引包
import javax.annotation.Nullable; import com.facebook.react.bridge.Arguments; import com.facebook.react.bridge.WritableMap; import com.facebook.react.bridge.ReactContext; import com.facebook.react.modules.core.DeviceEventManagerModule;
继续改造 show 方法,添加参数,并调用预先定义的方法
// 静态方法 WritableMap map = Arguments.createMap(); map.putBoolean("boolean",true); map.putDouble("double",0.003); map.putString("string","string"); sendEvent(this.reactContext, "eventName",map);
改造 index.android.js 啦 ,添加事件监听,这里的 eventName 就是我们 sendEvent 中定义的事件名称
componentWillMount(){ DeviceEventEmitter.addListener('eventName',(e)=>{ console.log(e) }); }
效果如下:
接入IOS原生模块
IOS 日历模块
创建一个名为 CalendarManager.h 的OC的接口 interface 文件,以及一个 CalendarManager.m 的实现类 implementation
CalendarManager.h 需要继承 NSObject 并实现 RCTBridgeModule 接口
CalendarManager.m 需要添加 RCT_EXPORT_MODULE() 宏,导出的方法需要通过 RCT_EXPORT_METHOD() 宏来实现
react-native中通过 NativeModules.类名.方法 调用 (本例中为:NativeModules.CalendarManager 获取iOS抛出模块,并通过模块调用抛出方法)
IOS React-native 类型对照
IOS | React-native |
---|---|
NSString | string |
NSInteger, float, double, CGFloat, NSNumber | number |
BOOL, NSNumber | boolean |
NSArray | array |
NSDictionary | object |
RCTResponseSenderBlock | function |
除此以外,任何RCTConvert类支持的的类型也都可以使用(参见RCTConvert了解更多信息)。RCTConvert还提供了一系列辅助函数,用来接收一个JSON值并转换到原生Objective-C类型或类
创建IOS模块
- CalendarManager.h
// CalendarManager.h #import "RCTBridgeModule.h" @interface CalendarManager : NSObject <RCTBridgeModule> @end
- CalendarManager.m
// CalendarManager.m @implementation CalendarManager RCT_EXPORT_MODULE(); RCT_EXPORT_METHOD(addEvent:(NSString *)name location:(NSString *)location) { RCTLogInfo(@"Pretending to create an event %@ at %@", name, location); } @end
react-native 调用
import { NativeModules } from 'react-native'; let CalendarManager = NativeModules.CalendarManager; CalendarManager.addEvent('Birthday Party', '4 Privet Drive, Surrey');
调用效果
- 官方文档中还给出了一些类型转换和词典运用的例子,请自行查看!
回调函数
通过 RCTResponseSenderBlock 声明回调函数类型,但RCTResponseSenderBlock只接受一个参数——传递给JavaScript回调函数的参数数组
RCT_EXPORT_METHOD(addEvents:(RCTResponseSenderBlock)callback) { NSString *message = @"callback message!!!"; callback(@[[NSNull null], message]); }
CalendarManager.addEvents((error, message) => { if (error) { console.error(error); } else { console.log("message:",message) } })
导出常量
- (NSDictionary *)constantsToExport { return @{ @"YEAR": @"2016" }; }
CalendarManager.YEAR
发送事件
#import "RCTBridge.h" #import "RCTEventDispatcher.h" [self.bridge.eventDispatcher sendAppEventWithName:@"EventReminder" body:@{@"name": @"xing.he"}];}
import { NativeAppEventEmitter } from 'react-native'; var subscription = NativeAppEventEmitter.addListener( 'EventReminder', (reminder) => console.log(reminder.name) ); // 千万不要忘记忘记取消订阅, 通常在componentWillUnmount函数中实现。 subscription.remove();
曾走过的路
曾想在返回的方法中定义一个 Object 类型的变量,但pa! 报错了!!不支持滴,请查看类型对应表格
cloudn't find argument class : Object
参照官方文档时,各种类找不到,瞬间醉了!
# 百度吧,一般不管用 # stackoverflow,Google 有时可以搜到,尼玛!英文。。。 # github # react-native 源码 !!!这里面有个`ReactAndroid`的目录就是各种`Java`类啦 react-native/ReactAndroid/src/main/java/com/facebook/ https://github.com/facebook/react-native
RCTBridgeModule.h file not found
npm install
npm WARN jest-react-native@17.0.0 requires a peer of whatwg-fetch@^1.0.0 but none was installed
npm install whatwg-fetch@^1.0.0
implicit declaration of function'RCTLogInfo' in invalid
#import "RCTLog.h" http://bbs.reactnative.cn/topic/1429/rctloginfo-%E6%8A%A5%E9%94%99%E7%9A%84%E9%97%AE%E9%A2%98/2
参考文档
江清清 ModulesDemo
react-native Android 中文
react-native Android 官方英文
react-native IOS 中文
react-native IOS 官方英文
RN-Resource-ipk github
来自:https://github.com/Xing-He/react-native-nativeModule/blob/master/README.md
- 文章2302
- 用户1336
- 访客10975106
如果你想获得伟大,别再请求许可。
UAC的限制引起WM_DROPFILES无法响应的解决办法
MeasureSpec中三种模式:UNSPECIFIED,AT_MOST,EXACTLY
发几个实用的chrome插件
CentOS下使用 svnsync迁移SVN代码库
仙剑奇侠传3d回合-PC端辅助
【转载】C++实现EXE加载到内存执行
【收藏】OpenCV一些常用库函数
《闲来麻将》搭建教程
文本转语音系统Spark-TTS
wordpress转xiuno附件自动插入工具
Mac OS最简单及(Karabiner)快捷键设置
使用Putty上传文件?
ndk神奇问题之non-numeric second argument to `wordlist' function: '8.7z'