• UID925
  • 登录2016-01-25
  • 粉丝0
  • 关注2
  • 发帖6
  • 主页
  • 金币19枚
社区居民
chenyu123 发布于2015-11-24 14:15
0/1223

Android之React Native平台与Android本地模块之间的调用

楼层直达
Native 模块(Android)

有时候APP需要做出React Native平台没有的功能,你也许会想用一些存在的java代码去解决问题,而不是用javascript脚本去去解决问题,或许写一些高性能,多线程的代码,列如图片处理,数据库,或者任何先进的继承
        
我们设计React Native的目的是尽可能 让你可以写一些真正的原生代码并且可以完全拥有系统的权限的能力,这是一个更加先进的特点,并且我们不希望这是传统开发过程中的一部分,然而它的存在是非常重要的。如果 React Native 不支持你需要的原生特征,那么你应该可以自己构建。

Toast 模块

        首先,我们来写原生模块。一个原生模块的java类通的常继承 ReactContextBaseJavaModule 类,并且实现了 JavaScript 需要实现的方法。我们这里的目的是允许通过使用 JavaScript 调用 ToastAndroid.show('Awesome', ToastAndroid.SHORT);就可以在屏幕上面显示一个短短的 toast 消息。
package com.facebook.react.modules.toast;  
    
import android.widget.Toast;  
    
import com.facebook.react.bridge.NativeModule;  
import com.facebook.react.bridge.ReactApplicationContext;  
import com.facebook.react.bridge.ReactContext;  
import com.facebook.react.bridge.ReactContextBaseJavaModule;  
import com.facebook.react.bridge.ReactMethod;  
    
import java.util.Map;  
    
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);  
  }  
}

 ToastModult继承了ReactContextBaseJavaModule这个类需要重写getName 的方法。这个方法就是返回值就是 JavaScript 里面调用 NativeModule 的方法名。在这里我们调用 ToastAndroid 因此我们可以在 JavaScript 里面使用 React.NativeModules.ToastAndroid 来使用这个类。
@Override  
  public String getName() {  
    return "ToastAndroid";  
  }

ToastModule里面重写了这个getConstants方法,这个方法会将传递给JavaScript 的常量返回。这个方法不是必须重写,它是非常重要的对于 JavaScript 和 Java 中同步的预定义的关键字的值。
@Override  
 public Map<String, Object> getConstants() {  
   final Map<String, Object> constants = new HashMap<String,Object>();  
   constants.put(DURATION_SHORT_KEY, Toast.LENGTH_SHORT);  
   constants.put(DURATION_LONG_KEY, Toast.LENGTH_LONG);  
   return constants;  
 }


那个英文里面new HashMap<>();是这样写的,我改成了这样new HashMap<String,Object>(); JavaScript d调用的这个方法需要使用 @ReactMethod 这个注解。这个方法的返回值类型是void类型。React Native 的桥接是异步的,因此将一个结果传递给 JavaScript 的唯一方式就是使用回调函数或者调用事件(见下面)。
@ReactMethod  
 public void show(String message, int duration) {  
   Toast.makeText(getReactApplicationContext(), message, duration).show();  
 }

参数类型
下面的参数类型是使用 @ReactMethod 注解的方法支持的,并且它们直接对应 JavaScript 中对应的值。
Boolean -&gt; Bool  
Integer -&gt; Number  
Double -&gt; Number  
Float -&gt; Number  
String -&gt; String  
Callback -&gt; function  
ReadableMap -&gt; Object  
ReadableArray -&gt; Array

我们继承ReactContextBaseJavaModule的Java类最后一步就是注册这个模块,我们将在createNativeModules 这个包里面注册。如果这个继承的类没有被注册,那么javaScript 不可调用它
@Override  
public List&lt;NativeModule&gt; createNativeModules(  
                            ReactApplicationContext reactContext) {  
  List&lt;NativeModule&gt; modules = new ArrayList&lt;NativeModule&gt;();  
    
  modules.add(new ToastModule(reactContext));  
    
  return modules;  
}

那个英文里面new ArrayList<>();是这样写的,我改成了这样

new ArrayList&lt;NativeModule&gt;();


我们需要用ReactInstanceManager来创建这个包, 。可以看 UIExplorerActivity.java 这个例子。当你初始化一个新工程的时候默认的包是MainReactPackage.java。
mReactInstanceManager = ReactInstanceManager.builder()  
  .setApplication(getApplication())  
  .setBundleAssetName("AnExampleApp.android.bundle")  
  .setJSMainModuleName("Examples/AnExampleApp/AnExampleApp.android")  
  .addPackage(new AnExampleReactPackage())  
  .setUseDeveloperSupport(true)  
  .setInitialLifecycleState(LifecycleState.RESUMED)  
  .build();

为了更方便的从 JavaScript 访问新功能的时,通常会将原生模块包裹在一个 JavaScript 模块里面,不一定这样,但是节省了你的类库的使用者每次都要 pull NativeModules 的不便。这个 JavaScript 文件也为你增加任何 JavaScript 端功能提供了方便。
/**  
 * @providesModule ToastAndroid  
 */  
    
'use strict';  
    
/**  
 * This exposes the native ToastAndroid module as a JS module. This has a function 'showText'  
 * which takes the following parameters:  
 *  
 * 1. String message: A string with the text to toast  
 * 2. int duration: The duration of the toast. May be ToastAndroid.SHORT or ToastAndroid.LONG  
 */  
var { NativeModules } = require('react-native');  
module.exports = NativeModules.ToastAndroid;

现在,在JavaScript文件里面你可以类似下面这样调用方法:
var ToastAndroid = require('ToastAndroid')  
ToastAndroid.show('Awesome', ToastAndroid.SHORT);  
    
// Note: We require ToastAndroid without any relative filepath because  
// of the @providesModule directive. Using @providesModule is optional.

远不止 Toasts

回调

原生模块也提供了一种特殊的参数-一个回调。在大多数情况下这是给 JavaScript 返回结果使用的。
public class UIManagerModule extends ReactContextBaseJavaModule {  
    
...  
    
  @ReactMethod  
  public void measureLayout(  
      int tag,  
      int ancestorTag,  
      Callback errorCallback,  
      Callback successCallback) {  
    try {  
      measureLayout(tag, ancestorTag, mMeasureBuffer);  
      float relativeX = PixelUtil.toDIPFromPixel(mMeasureBuffer[0]);  
      float relativeY = PixelUtil.toDIPFromPixel(mMeasureBuffer[1]);  
      float width = PixelUtil.toDIPFromPixel(mMeasureBuffer[2]);  
      float height = PixelUtil.toDIPFromPixel(mMeasureBuffer[3]);  
      successCallback.invoke(relativeX, relativeY, width, height);  
    } catch (IllegalViewOperationException e) {  
      errorCallback.invoke(e.getMessage());  
    }  
  }  
    
...

使用以下方法可以来访问在 JavaScript 里面可以使用:
UIManager.measureLayout(  
  100,  
  100,  
  (msg) =&gt; {  
    console.log(msg);  
  },  
  (x, y, width, height) =&gt; {  
    console.log(x + ':' + y + ':' + width + ':' + height);  
  }  
);

原生模块也提供了一种特殊的参数-一个回调。在大多数情况下这是给 JavaScript 返回结果使用的。

使用以下方法可以来访问在 JavaScript 。原生模块支持只调用一次它的回调。它可以保存这个回调,并且在以后调用。有一点需要强调的就是,在原生方法完成之后这个回调并不是立即被调用,请记住桥接通信是异步的,因此这个也在运行时循环里面。

线程
原生模块不应该设想有它们将在哪些线程里面被调用,因为目前的任务在以后改变是主要的。如果一个块调用是必须的,那么耗时操作将会被分配到间歇性的工作线程中,并且任何回调将会从这里开始。

给 JavaScript 传递事件
原生模块可以不需要立即被调用就可以给 JavaScript 发送事件。最简单的方式就是使用从 ReactContext 获得的 RCTDeviceEventEmitter,就像下面的代码片段:
...  
private void sendEvent(ReactContext reactContext,  
                       String eventName,  
                       @Nullable WritableMap params) {  
  reactContext  
      .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter.class)  
      .emit(eventName, params);  
}  
...  
WritableMap params = Arguments.createMap();  
...  
sendEvent(reactContext, "keyboardWillShow", params);

JavaScript 模块在那时可以通过使用 Subscribable 的 addListenerOn 来注册并且接收事件。
var RCTDeviceEventEmitter = require('RCTDeviceEventEmitter');  
...  
    
var ScrollResponderMixin = {  
  mixins: [Subscribable.Mixin],  
    
  componentWillMount: function() {  
    ...  
    this.addListenerOn(RCTDeviceEventEmitter,  
                       'keyboardWillShow',  
                       this.scrollResponderKeyboardWillShow);  
    ...  
  },  
  scrollResponderKeyboardWillShow:function(e: Event) {  
    this.keyboardWillOpenTo = e;  
    this.props.onKeyboardWillShow && this.props.onKeyboardWillShow(e);  
  },

原文来自:https://facebook.github.io/react-native/docs/native-modules-android.html#content
译文来自:http://blog.csdn.net/u011068702/article/details/49475167

0人打赏
您需要登录后才可以回帖
发表回复
极贡献
技术问答
专题荟萃
程序人生
视觉设计
Android开发
iOS开发
编程语言
前端开发
后端开发
服务器架构
软件测试
运维方案
创业路上



最热文章墙

  • 57676/339   【精品推荐】200多种Android动画效果的强悍框架,太全了,不看这个,再有动画的问题,不理你了^@^

  • 30959/139   省时省力的Android组件群来了,非常棒的原型参考

  • 30637/187   情人节福利,程序员表白的正确姿势:改几行代码就变成自己的表白了

  • 27335/216   【精品推荐】Android版产品级的音乐播放器源码,功能太强大了,最好的产品原型有木有?

  • 25732/2   超全!整理常用的iOS第三方资源

  • 23951/70   原创表白APP,以程序员的姿势备战新年后的7夕,持续完善中!

  • 22264/0   Python爬虫:常用浏览器的useragent

  • 21675/137   2016抢红包软件及源码

  • 19600/29   麻省理工的一帮疯子,真的实现了随意操控万物!(绝对黑科技)

  • 19441/25   Android工程师面试题大全

  • 18725/27   2016程序员跳槽全攻略

  • 18653/9   GitHub上排名前50的iOS项目:总有一款你用得着

  • 18182/20   码魂:程序员的牛B漫画

  • 16646/3   吐槽那些程序员的搞笑牛逼注释

  • 15732/146   Android版类似UC浏览器:非常赞,产品级的源码

  • 15463/1   iOS 动画总结

  • 14823/41   一个绚丽的loading动效分析与实现!

  • 14404/10   女程序员的梦,众网友的神回复

  • 14237/11   年会上现场review代码是怎么样的体验!

  • 14207/73   【持续更新中】Android福利贴(二):资料源码大放送

  • 14203/83   Android小而全的博客源码:非常适合全面掌握开发技巧

  • 14131/44   惊艳的App引导页:背景图片切换加各个页面动画效果

  • 13816/5   新一代Android渠道打包工具:1000个渠道包只需要5秒

  • 13639/23   个人收集的Android 各类功能源代码

  • 13616/10   2016年最全的Android面试考题+答案 精编版

  • 12925/19   珍藏多年的素材,灵感搜寻网站

  • 12802/53   基于瀑布流的美女图片浏览App,有注释的源代码

  • 12453/15   基于Android支付宝支付设计和开发方案

  • 12421/17   用JavaScript 来开发iOS和Android 原生应用:React Native开源框架中文版来啦

  • 12142/74   仿京东商城客户端Android最新版,不错的原型和学习资料

  • 12128/20   Android福利第三波【Android电子书】

  • 12067/17   什么是真正的黑客:收获12200+Stars,人气远超微软开源VS

  • 11600/18   65条最常用正则表达式,你要的都在这里了

  • 11522/94   Android带弹幕的视频播放器源码,来自大名鼎鼎的Bilibili弹幕网站

  • 11514/7   用程序员的姿势抢过年的火车票

  • 11486/70   【精品推荐】类似360安全卫士安Android源码:非常赞的产品原型

  • 11419/7   一张图搞定iOS学习路线,非常全面

  • 11302/11   有木有这样一张酷图帮你集齐所有git命令超实用

  • 11050/0   iOS中文版资源库,非常全

  • 10939/10   成为Java顶尖程序员 ,看这11本书就够了

  • 10530/18   一张图搞定Android学习路线,非常全面

  • 10498/10   微信支付终于成功了(安卓,iOS),在此分享

  • 10104/3   基于Node.js的强大爬虫,能直接发布抓取的文章哦

  • 10045/29   【持续更新中】Android福利贴(一):资料源码

  • 10035/44   在线音乐播放器完整版(商用级的源码):非常赞,可听免费高品质专辑

  • 10028/0   GitHub iOS 库和框架Top100 

  • 9688/4   46 个非常有用的 PHP 代码片段

  • 9326/3   即时通信第三方库

  • 9323/9   烧了5亿美金,这家神秘的公司即将颠覆人类未来!

  • 9173/8   流媒体视频直播方案

  • 9123/61   【技巧一】搭配Android Studio,如何实现App远程真机debug?

  • 9042/9   B站建开源工作组:APP想支持炫酷弹幕的看过来

  • 8995/2   【精品推荐】高质量PHP代码的50个实用技巧:非常值得收藏

  • 8903/9   中国黑客的隐秘江湖:攻守对立,顶尖高手月入千万美元

  • 8868/18   八个最优秀的Android Studio插件

  • 8439/6   开箱即用!Android四款系统架构工具

  • 8346/3   一张图看清Linux 内核运行原理

  • 8233/3   10款GitHub上最火爆的国产开源项目——可以媲美西半球

  • 8223/10   十大技巧快速提升Android应用开发性能

  • 7883/1   Android性能优化视频,文档以及工具

  • 返回顶部