React Native Android原生模块开发实战|教程|心得|怎样创建React Native Android原生模块
尊重版权,未经授权不得转载
本文出自:贾鹏辉的技术博客(http://blog.csdn.net/fengyuzhengfan/article/details/54691503)告诉大家一个好消息。为大家精心准备的React Native视频教程公布了,大家现能够看视频学React Native了。
前言
一直想写一下我在React Native原生模块封装方面的一些经验和心得。来分享给大家,但实在抽不开身。今天看了一下日历发现立即就春节了。所以就赶在春节之前将这篇博文写好并公布(事实上是两篇:要看iOS篇的点这里
《React Native iOS原生模块开发》)。
我平时在用React Native开发App时会用到一些原生模块,比方:在做社会化分享、第三方登录、扫描、通信录。日历等等。想必大家也是一样。
关于在React Native中使用原生模块。在这里引用React Native官方文档的一段话:
有时候App须要訪问平台API,但在React Native可能还没有对应的模块。或者你须要复用一些Java代码,而不想用JavaScript再又一次实现一遍;又或者你须要实现某些高性能的、多线程的代码。譬如图片处理、数据库、或者一些高级扩展等等。
我们把React Native设计为能够在其基础上编写真正的原生代码。并且能够訪问平台全部的能力。这是一个相对高级的特性,我们并不期望它应当在日常开发的过程中常常出现,但它确实不可缺少,并且是存在的。假设React Native还不支持某个你须要的原生特性,你应当能够自己实现对该特性的封装。
上面是我翻译React Native官方文档上的一段话,大家假设想看英文版能够点这里:Native Modules
在这篇文章中呢,我会带着大家来开发一个从相冊获取照片并裁切照片的项目,并结合这个项目来详细解说一下怎样一步步开发React Native Android原生模块的。
提示:告诉大家一个好消息,React Native视频教程公布了。大家现能够看视频学React Native了。
首先。让我们先看一下,开发Android原生模块的主要流程。
开发Android原生模块的主要流程
在这里我把构建React Native Android原生模块的流程概括为以下三大步:
- 编写原生模块的相关Java代码。
- 暴露接口与数据交互。
- 注冊与导出React Native原生模块。
接下来让我们一起来看一下每一步所须要做的一些事情。
原生模块开发实战
在这里我们就以开发一个从相冊获取照片并裁切照片的实战项目,来详细解说一下怎样开发React Native Android原生模块的。
编写原生模块的相关Java代码
这一步我们须要用到AndroidStudio。
首先我们用AndroidStudio打开React Native项目根文件夹下的android文件夹。如图:
用AndroidStudio第一次打开这个Android项目的时候,AndroidStudio会下载一些此项目所须要的依赖,比方项目所依赖的Gradle版本号等。这些依赖下载完毕之后呢。AndroidStudio会对项目进行初始化,初始化成功之后在AndroidStudio的工具栏中能够看到一个名为“app”的一个可执行的模块。如图:
接下来呢,我们就能够编写Java代码了。
首先呢。我们先来实现一个Crop接口:
public interface Crop {
/**
* 选择并裁切照片
* @param outputX
* @param outputY
* @param promise
*/
void selectWithCrop(int outputX,int outputY,Promise promise);
}
我们创建一个CropImpl.java。在这个类中呢。我们实现了从相冊选择照片以及裁切照片的功能:
/**
* React Native Android原生模块开发
* Author: CrazyCodeBoy
* 技术博文:http://www.devio.org
* GitHub:https://github.com/crazycodeboy
* Email:crazycodeboy@gmail.com
*/
public class CropImpl implements ActivityEventListener,Crop{
private final int RC_PICK=50081;
private final int RC_CROP=50082;
private final String CODE_ERROR_PICK="用户取消";
private final String CODE_ERROR_CROP="裁切失败";
private Promise pickPromise;
private Uri outPutUri;
private int aspectX;
private int aspectY;
private Activity activity;
public static CropImpl of(Activity activity){
return new CropImpl(activity);
}
private CropImpl(Activity activity) {
this.activity = activity;
}
public void updateActivity(Activity activity){
this.activity=activity;
}
@Override
public void onActivityResult(Activity activity, int requestCode, int resultCode, Intent data) {
if(requestCode==RC_PICK){
if (resultCode == Activity.RESULT_OK && data != null) {//从相冊选择照片并裁剪
outPutUri= Uri.fromFile(Utils.getPhotoCacheDir(System.currentTimeMillis()+".jpg"));
onCrop(data.getData(),outPutUri);
} else {
pickPromise.reject(CODE_ERROR_PICK,"没有获取到结果");
}
}else if(requestCode==RC_CROP){
if (resultCode == Activity.RESULT_OK) {
pickPromise.resolve(outPutUri.getPath());
}else {
pickPromise.reject(CODE_ERROR_CROP,"裁剪失败");
}
}
}
//...省略部分代码
private void onCrop(Uri targetUri,Uri outputUri){
this.activity.startActivityForResult(IntentUtils.getCropIntentWith(targetUri,outputUri,aspectX,aspectY),RC_CROP);
}
}
关于Android拍照、从相冊或文件里选择照片。裁剪以及压缩照片等更高级的功能实现,大家能够參考开源项目TakePhoto
实现了从相冊选择照片以及裁切照片的功能之后呢,接下来我们须要将public void selectWithCrop(int aspectX, int aspectY, Promise promise)
暴露给React Native,以供js调用。
暴露接口与数据交互
接下了我们就向React Native暴露接口以及做一些数据交互部分的操作。为了暴露接口以及进行数据交互我们须要借助React Native的ReactContextBaseJavaModule
类,在这里我们创建一个ImageCropModule.java
类让它继承自ReactContextBaseJavaModule
。
创建一个ReactContextBaseJavaModule
/**
* React Native Android原生模块开发
* Author: CrazyCodeBoy
* 技术博文:http://www.devio.org
* GitHub:https://github.com/crazycodeboy
* Email:crazycodeboy@gmail.com
*/
public class ImageCropModule extends ReactContextBaseJavaModule implements Crop{
private CropImpl cropImpl;
public ImageCropModule(ReactApplicationContext reactContext) {
super(reactContext);
}
@Override
public String getName() {
return "ImageCrop";
}
//...省略部分代码
@Override @ReactMethod
public void selectWithCrop(int aspectX, int aspectY, Promise promise) {
getCrop().selectWithCrop(aspectX,aspectY,promise);
}
private CropImpl getCrop(){
if(cropImpl==null){
cropImpl=CropImpl.of(getCurrentActivity());
getReactApplicationContext().addActivityEventListener(cropImpl);
}else {
cropImpl.updateActivity(getCurrentActivity());
}
return cropImpl;
}
}
在ImageCropModule.java
类中。我们重写了public String getName()
方法。来暴露我们原生模块的名字。
并在public void selectWithCrop(int aspectX, int aspectY, Promise promise)
上加入了@ReactMethod
注解来暴露接口。这样以来我们就能够在js文件里通过ImageCrop.selectWithCrop
来调用我们所暴露给React Native的接口了。
接下来呢,我们来看一下原生模块和js模块是怎样进行数据交互的?
原生模块和JS进行数据交互
在我们要实现的从相冊选择照片并裁切的项目中。js模块须要告诉原生模块照片裁切的比例,等照片裁切完毕后,原生模块须要对js模块进行回调来告诉js模块照片裁切的结果,在这里我们须要将照片裁切后生成的图片的路径告诉js模块。
提示:在全部的情况下js和原生模块之前进行通信都是在异步的情况下进行的。
接下来我们就来看下一JS是怎样向原生模块传递数据的?
JS向原生模块传递数据:
为了实现JS向原生模块进行传递数据。我们能够直接通过调用原生模块所暴露出来的接口。来为接口方法设置參数。
这样以来我们就能够将数据通过接口參数传递到原生模块中,如:
/**
* 选择并裁切照片
* @param outputX
* @param outputY
* @param promise
*/
void selectWithCrop(int outputX,int outputY,Promise promise);
通过上述代码我们能够看出,js模块能够通过selectWithCrop
方法来告诉原生模块要裁切照片的宽高比,最后一个參数是一个Promise
,照片裁剪完毕之后呢。原生模块能够通过Promise
来对js模块进行回调,来告诉裁切结果。
既然是js和Java进行数据传递。那么他们两者之间是怎样进行类型转换的呢:
在上述样例中我们通过@ReactMethod
注解来暴露接口,被 @ReactMethod
标注的方法支持例如以下几种数据类型。
被
@ReactMethod
标注的方法支持例如以下几种数据类型的參数:
Boolean -> Bool
Integer -> Number
Double -> Number
Float -> Number
String -> String
Callback -> function
ReadableMap -> Object
ReadableArray -> Array
原生模块向JS传递数据:
原生模块向JS传递数据我们能够借助Callbacks与Promises。接下来就讲一下怎样通过他们两个进行数据传递的。
Callbacks
原生模块支持一个特殊类型的參数-Callbacks,我们能够通过它来对js进行回调,以告诉js调用原生模块方法的结果。
将我们selectWithCrop
的參数改为Callbacks之后:
@Override
public void selectWithCrop(int aspectX, int aspectY, Callback errorCallback,Callback successCallback) {
this.errorCallback=errorCallback;
this.successCallback=successCallback;
this.aspectX=aspectX;
this.aspectY=aspectY;
this.activity.startActivityForResult(IntentUtils.getPickIntentWithGallery(),RC_PICK);
}
在回调的时候,我们就能够这样写:
if (resultCode == Activity.RESULT_OK) {
successCallback.invoke(outPutUri.getPath());
}else {
errorCallback.invoke(CODE_ERROR_CROP,"裁剪失败");
}
在上述代码中我们通过Callback
的invoke
方法来对js进行对调,以下我们来看一下Callback.java
的源代码:
public interface Callback {
/**
* Schedule javascript function execution represented by this {@link Callback} instance
*
* @param args arguments passed to javascript callback method via bridge
*/
public void invoke(Object... args);
}
从Callback.java
的源代码中我们能够看出,它是一个仅仅有一个public void invoke(Object... args)
方法的接口,invoke
方法接受一个可变參数,所以我们能够向js传递多个參数。
接下来呢,我们在js中就能够这样来调用我们所暴露的接口:
ImageCrop.selectWithCrop(parseInt(x),parseInt(y),(error)=>{
console.log(error);
},(result)=>{
console.log(result);
})
提示:另外要告诉大家的是。不管是
Callback
还是我接下来要讲的Promise
,我们仅仅能调用一次,也就是”you call me once,I can only call you once”。
Promises
除了上文所讲的Callback
之外React Native还为了我们提供了第二种回调js的方式叫-Promise。
假设我们暴露的接口方法的最后一个參数是Promise
时。如:
@Override @ReactMethod
public void selectWithCrop(int aspectX, int aspectY, Promise promise) {
getCrop().selectWithCrop(aspectX,aspectY,promise);
}
那么当js调用它的时候将会返回一个Promsie:
ImageCrop.selectWithCrop(parseInt(x),parseInt(y)).then(result=> {
this.setState({
result: result
})
}).catch(e=> {
this.setState({
result: e
})
});
另外。我们也能够使用ES2016的 async/await
语法,来简化我们的代码:
async onSelectCrop() {
var result=await ImageCrop.selectWithCrop(parseInt(x),parseInt(y));
}
这样以来代码就简化了非常多。
由于。基于回调的数据传递不管是Callback还是Promise。都仅仅能调用一次。但。在实际项目开发中我们有时会向js多次传递数据,比方二维码扫描原生模块,针对这样的多次数据传递的情况我们该怎么实现呢?
接下来我就为大家介绍一种原生模块能够向js多次传递数据的方式:
向js发送事件
在原生模块中我们能够向js发送多次事件,即使原生模块没有被直接的调用。
为了向js传递事件我们须要用到RCTDeviceEventEmitter,它是原生模块和js之间的一个事件发射器。
private void sendEvent(ReactContext reactContext,String eventName, @Nullable WritableMap params) {
reactContext.getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter.class)
.emit(eventName, params);
}
在上述方法中我们能够向js模块发送随意次数的事件,当中eventName
是我们要发送事件的事件名,params
是此次事件所携带的数据。接下来呢我们就能够在js模块中监听这个事件了:
componentDidMount() {
//注冊扫描监听
DeviceEventEmitter.addListener('onScanningResult',this.onScanningResult);
}
onScanningResult = (e)=> {
this.setState({
scanningResult: e.result,
});
}
另外。不要忘记在组件被卸载的时候移除监听:
componentWillUnmount(){
DeviceEventEmitter.removeListener('onScanningResult',this.onScanningResult);//移除扫描监听
}
到如今呢,暴露接口以及数据传递已经进行完了,接下来呢,我们就须要注冊与导出React Native原生模块了。
注冊与导出React Native原生模块
为了向React Native注冊我们刚才创建的原生模块,我们须要实现ReactPackage
,ReactPackage
主要为注冊原生模块所存在,仅仅有已经向React Native注冊的模块才干在js模块使用。
/**
* React Native Android原生模块开发
* Author: CrazyCodeBoy
* 技术博文:http://www.devio.org
* GitHub:https://github.com/crazycodeboy
* Email:crazycodeboy@gmail.com
*/
public class ImageCropReactPackage 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 ImageCropModule(reactContext));
return modules;
}
}
在上述代码中,我们实现一个ReactPackage
,接下来呢,我们还须要在android/app/src/main/java/com/your-app-name/MainApplication.java
中注冊我们的ImageCropReactPackage
:
@Override
protected List<ReactPackage> getPackages() {
return Arrays.<ReactPackage>asList(
new MainReactPackage(),
new ImageCropReactPackage()//在这里将我们刚才创建的ImageCropReactPackage加入进来
);
}
原生模块注冊完毕之后呢。我们接下来就须要为我们的原生模块导出一个js模块,以方便我们使用它。
我们创建一个ImageCrop.js文件。然后加入例如以下代码:
import { NativeModules } from 'react-native';
export default NativeModules.ImageCrop;
这样以来呢,我们就能够在其它地方通过以下方式来使用我们所导出的这个模块了:
import ImageCrop from './ImageCrop' //导入ImageCrop.js
//...省略部分代码
onSelectCrop() {
let x=this.aspectX?this.aspectX:ASPECT_X;
let y=this.aspectY?
this.aspectY:ASPECT_Y;
ImageCrop.selectWithCrop(parseInt(x),parseInt(y)).then(result=> {
this.setState({
result: result
})
}).catch(e=> {
this.setState({
result: e
})
});
}
//...省略部分代码
}
如今呢,我们这个原生模块就开发好了,并且我们也使用了我们的这个原生模块。
关于Android拍照、从相冊或文件里选择照片,裁剪以及压缩照片等更高级的功能实现,大家也能够參考开源项目TakePhoto
关于线程
在React Native中,JS模块执行在一个独立的线程中。在我们为React Native开发原生模块的时候,假设有耗时的操作比方:文件读写、网络操作等,我们须要新开辟一个线程。不然的话,这些耗时的操作会堵塞JS线程。
在Android中我们能够借助AsyncTask来实现多线程。另外。假设原生模块中须要更新UI,我们须要获取主线程,然后在主线程中更新UI,如:
activity.runOnUiThread(new Runnable() {
@Override
public void run() {
if (!activity.isFinishing()) {
mSplashDialog = new Dialog(activity,fullScreen?
R.style.SplashScreen_Fullscreen:R.style.SplashScreen_SplashTheme);
mSplashDialog.setContentView(R.layout.launch_screen);
mSplashDialog.setCancelable(false);
if (!mSplashDialog.isShowing()) {
mSplashDialog.show();
}
}
}
});
告诉大家一个好消息,为大家精心准备的React Native视频教程公布了,大家现能够看视频学React Native了。
假设,大家在开发原生模块中遇到问题能够在本文的下方进行留言,我看到了后会及时回复的哦。
另外也能够关注我的新浪微博
,或者关注我的Github
来获取很多其它有关React Native开发的技术干货
。
推荐学习:视频教程《React Native开发跨平台GitHub App》
React Native Android原生模块开发实战|教程|心得|怎样创建React Native Android原生模块的更多相关文章
- Android Studio JNI开发入门教程
Android Studio JNI开发入门教程 2016-08-29 14:38 3269人阅读 评论(0) 收藏 举报 分类: JNI(3) 目录(?)[+] 概述 在Andorid ...
- Swift游戏开发实战教程(霸内部信息大学)
Swift游戏开发实战教程(大学霸内部资料) 试读下载地址:http://pan.baidu.com/s/1sj7DvQH 介绍:本教程是国内第一本Swift游戏开发专向资料. 本教程具体解说记忆配对 ...
- asp.net mvc+jquery easyui开发实战教程之网站后台管理系统开发4- 后台模板html页面创建
上一篇教程<asp.net mvc+jquery easyui开发实战教程之网站后台管理系统开发3-登录模块开发>完成了本项目的登录模块,登录后就需要进入后台管理首页了,需要准备一个后台模 ...
- asp.net mvc+jquery easyui开发实战教程之网站后台管理系统开发2-Model层建立
上篇(asp.net mvc+jquery easyui开发实战教程之网站后台管理系统开发1-准备工作)文章讲解了开发过程中的准备工作,主要创建了项目数据库及项目,本文主要讲解项目M层的实现,M层这里 ...
- 微信小程序-云开发实战教程
微信小程序-云开发实战教程 云函数,云存储,云数据库,云调用 https://developers.weixin.qq.com/miniprogram/dev/wxcloud/basis/gettin ...
- WCF开发实战系列一:创建第一个WCF服务
WCF开发实战系列一:创建第一个WCF服务 (原创:灰灰虫的家http://hi.baidu.com/grayworm) 在这个实战中我们将使用DataContract,ServiceContract ...
- Ionic2开发环境搭建、项目创建调试与Android应用的打包、优化
Ionic2开发环境搭建.项目创建调试与Android应用的打包.优化. windows下ionic2开发环境配置步骤如下: 下载node.js环境,稳定版本:v6.9.5 下载android stu ...
- Android官方教程翻译(1)——创建第一个Android应用
转载请注明出处:http://blog.csdn.net/dawanganban/article/details/9822431 Building Your First App GETSTARTED ...
- WCF开发实战系列五:创建WCF客户端程序
WCF开发实战系列五:创建WCF客户端程序 (原创:灰灰虫的家http://hi.baidu.com/grayworm) 在前面的三篇文章中我们分别介绍了WCF服务的三种载体:IIS.Self-Hos ...
随机推荐
- Java基础知识总结--String、StringBuffer、StringBuilder
1.Java String 类 String类是final类,也即意味着String类不能被继承,并且它的成员方法都默认为final方法.在Java中,被final修饰的类是不允许被继承的,并且该类中 ...
- 小甲鱼Python第六讲课后习题
python中被看作假:FALSE none 0 ‘ ’ " " ( ) [ ] { },其他一切都被解释为真 0.Python 的 floor 除法现在使用“//”实现, ...
- IO流(5)—缓冲流
1.IO体系: 抽象基类--节点流(文件流)--缓冲流(处理流的一种) InputStream --FileInputStream--BufferedInputStream OutputStream- ...
- CentOS使用Ubuntu的start-stop-daemon来启动守护进程
在CentOS下使用守护进程启动有/etc/init.d/functions文件下的daemon方法,但如果要使用Ubuntu下的start-stop-daemon方法也可以实现. 安装如下: # 下 ...
- Android 模拟器启动不了-问题解决方案
一.Android 模拟器启动不了问题解决方案 在安装Android开发环境时,首先安装java虚拟机,然后下载android adk 管理android虚拟机. 在完成工作后,添加android的虚 ...
- too much recursion(太多递归)Uncaught RangeError: Maximum call stack size exceeded BootstrapValidator报错
在BootstrapValidator中已默认遵守Bootstrap规则,form里的每个输入项目必需包含在类为form-group的标签里,否则BootstrapValidator中定义的field ...
- Android Studio3.1.2升级问题:Configuration 'compile' is obsolete and has been replaced with 'implementation'.
每次升级Android Studio时,一般情况下Gradle版本的也会相应的升级,我之前Android Studio 3.0.1.Gradle 是4.1升级后为:Android Studio 3.1 ...
- Oracle 学习笔记 10 -- 约束
本次笔记来学习约束,约束在表中无处不在. 比如,表中的数据不同意为空或者是表中id为设为主键,都是约束. 约束分类: 主键约束(PRIMARY KEY):主键表示表中一个唯一的标识,本 ...
- Lombok 使用攻略
1. Lombok 简介 Lombok 可以通过简单的注解来帮助我们简化消除一些必须有但显得很臃肿的Java代码,通过使用对应的注解,可以在编译源码的时候生成对应的方法. Lombok 既是一个 ID ...
- Transport scheme NOT recognized: [stomp]
今天在ubuntu上装个activemq,本来以为就是apt-get install activemq就行了的. 结果配置上stomp协议,activemq居然起不来.起不来就起不来吧,也没个提示. ...