从Android到React Native开发(二、通信与模块实现)

简介:

大家吼,(◐‿◑)作为失踪人口回归,这次第二期,就让我们来怼React Native的通信,快速实现单独的React Native模块到APP里,愉悦吧骚年。至于为什么要有这期?当然是为了愉悦的飙车啦ε-(´∀`; )。

下方包含源码剧透,剧情略长,请紧张耐心的往下看。( ̄^ ̄)ゞ
文中标注有“【数字】”的是干货哟。

准备好接受新姿势了么

开始之前

 本文前上部分主要拆解一些基础的原理,由浅到深;后半部分讲解集成模块实现,你也可以直接阅读后半部分,快速实现模块集成。文中着重在Android端帮助大家理解React Native。

下方先提前介绍一些关键类。

  • ReactActivity:默认所有的Activity都继承它。
  • ReactNativeHost :帮你"hold"住ReactInstanceManager。
  • ReactActivityDelegate:ReactActivity的逻辑代理实现。
  • ReactRootView :React NativeUI的所在。
  • ReactInstanceManager:React Native的扛把子,抽象类。
  • XReactInstanceManagerImpl :ReactInstanceManager的实现类。
  • ReactContext: 管理React Native的状态等。
  • NativeModule:继承它的module可以在js端使用,其中就包括有DeviceEventManagerModule,与JS实现事件模式交互的module。
  • Callback/Promise: 回调接口,与js端交互。

开始目瞪口呆

一、上半部分

1、MainApplication

 默认react-native init创建的项目里,会有一个MainActivity 和一个MainApplication MainApplication继承了ReactApplication接口,接口只有一个方法:getReactNativeHost

1.1、ReactNativeHost

 这个接口实现在Application,通过getApplication,你可以随时拿到ReactNativeHost,它会帮你创建一个单例:ReactInstanceManager 作为管理器。ReactNativeHost还可以配置一系列的行为,其中最关键的,便是getPackages接口。

默认在Application实现了ReactNativeHost

getPackages 接口返回了一系列的ReactPackage类,ReactPackage可以看作是,向ReactNative注册了原生模块,这样在JS中你也可以使用原生模块的功能,按键第三方库时,react-native link命令,其中一个行为,就是在getPackages中帮你插入,库需要引用到的模块。

 如上图,是MainReactPackage 内部实现,MainReactPackage是官方的类,其中关联了很多NativeModule,Module中你可以通过@ReactMethod注解,指定一个方法为JS可以调用的方法,如下图的DetailModule,便是继承了NativeModule的JAVA端实现类,在js中引入。

总结一下,划重点Σ( ̄。 ̄ノ)ノ:
  • MainApplication继承了ReactApplication,返回了ReactNativeHost
  • ReactNativeHost里创建了ReactInstanceManager,并且实现了getPackages,返回了ReactPackage列表。
  • ReactInstanceManager在创建Builder时,把ReactPackage列表加入到管理器。
  • ReactPackage列表里面都关联了NativeModule的实现类。
  • NativeModule的实现类可以通过注解,类似@ReactMethod让原生方法可以被React调用。

粗略流程:
 MainApplication -> ReactApplication -> ReactNativeHost -> ReactInstanceManager -> ReactPackage -> NativeModule -> CatalystInstance(这位就是负责发送的同志)

【1】所以只要实现了ReactPackage和NativeModule,将它注册到ReactNativeHost 或者ReactInstanceManager ,就可以在React Native中继承你原生的模块了

2、ReactActivity

 MainActivity大家肯定不陌生,默认react-native init创建的项目里,MainActivity十分简单,只有一个getMainComponentName,它就是告诉Avtivity,默认需要加载的js组件名(Component)是什么,而其余的事情,都是继承的ReactActivity帮你实现。

首先我们直接来分析下顺序:

  • ReactActivity默认创建了一个ReactActivityDelegate
  • ReactActivityDelegate 创建了一个单例的ReactInstanceManager(通过上面的ReactNativeHost)。
  • ReactInstanceManager (抽象类)内部创建了ReactRootView
  • ReactInstanceManager 的实现类为XReactInstanceManagerImpl
  • XReactInstanceManagerImpl在createReactContext 创建了ReactApplicationContext
  • ReactApplicationContext 实现了生命状态事件的分发,通知js端Activity的状态。

结合上面 MainApplication部分:

  • ReactInstanceManager 里面注册了ReactPackage
  • ReactPackage 关联了NativeModule 的实现类。
  • NativeModule 可以通过增加注解的方法被JS端调用。

所以流程可以粗略认为是
1、MainApplication -> ReactApplication -> ReactNativeHost。
2、ReactActivity -> ReactActivityDelegate -> ReactNativeHost ->
ReactInstanceManager -> ReactContex -> ReactPackage -> NativeModule

例如,ReactActivity的OnResume事件流程:
1、ReactActivityDelegate.onResume();。
2、getReactNativeHost().getReactInstanceManager().onHostResume();。
3、ReactContext.onHostResume();。
4、AppStateModule.onHostResume();。
5、RCTDeviceEventEmitter 通过 emit("appStateDidChange", createAppStateEventMap());通知js。

【2】这里我们需要注意,只要继承了ReactActivity,无论你实现了多少个Activity,它们的内部ReactInstanceManager都只有一个,消息会出现共享的情况。比如A页面onResume是,B页面就会onPause,如果你在JS端监听页面的状态,会同时收到两个消息通知。

 再深入的我们就先不追究,后面有深入通信相关的文章推荐,其中涉及到CatalystInstance ReactBridgeBridgeCallback等等,通过jni转为字符串,再拼接为命令和代码执行等原理,有兴趣的可以移步吸几口。

 可以看出,ReactInstanceManager是其中的关键,无论哪里都有它的身影,ReactNativeHost的Package列表是给它,创建ReactContex也是它,其实加载JS的也是它,所以后半部分实现模块,其中很关键的就是它了。

二、下半部分

实现一个React Native应用,有两种方法:
1、一种直接继承ReactActivity,指定js中需要加载的组件名字。
2、在布局中加入ReactRootView,通过ReactInstanceManager 加载管理js。

 关于第一种,我们不深入展开,因为它的实现通过上面已经大致讲完,参考init下来的react工程,可以很简单的实现,他们共享Applicaton中的ReactNativeHost,和Host创建的ReactInstanceManager。

 那么我们为什么要讲第二种呢?这里首先讲解一个知识点:

【3】React Native在打包的时候,是把js代码打包成js bundle,js bundle就是压缩后的js代码,它放在android的assert文件下,启动React Native应用时默认加载它。

 既然如何,那么我们是否可以修改js bundle的加载路径?当然可以啊,不然说个卵(╯‵□′)╯︵┻━┻。通过网络下载不同的js bundle,加载实现不同的React Native App,哇塞,这不就是简单的微信小程序么。

 ReactNativeHost也可以配置js bundle的文件路径,那么继承ReactActivity不是可以更简单的实现吗?不,因为继承ReactActivity,他们内部共享了一个ReactInstanceManager,作为单独的React Native程序模块,想想消息、路由、store等等会互相干扰污染·····

1、创建一个React Native 应用。

1.1、如下图,首先你需要在布局中创建一个ReactRootView。

1.2、创建一个ReactInstanceManager,配置你需要支持的自定义选项,最后通过build(),实现一个XReactInstanceManagerImpl,将它这是给ReactRootView。

如上图,可以看到:

  • setJSBundleFile,你可以指定加载bundle文件的路径
  • addPackge,增加你的React Native小程序支持的原生模块,其中MainReactPackage是必须的。
  • setJSMainModuleName指定了主js模块的名字。

 是不是很简单,这样你就可以通过原生的http,去下载和更新js bundle,然后加载显示,从而实现类似微信小程序的需求。

 当然,如上图,不要忘记给你的Activity继承DefaultHardwareBackBtnHandler接口,还有将activity的生命状态通知到js端。

1.3 DefaultHardwareBackBtnHandler

 这里要大篇幅讲解下,DefaultHardwareBackBtnHandler接口,通过它我们可以整体了解,React Native从android端,到JS端对back按键事件的处理。

  • 首先Activity需要继承DefaultHardwareBackBtnHandler接口。DefaultHardwareBackBtnHandler只有一个invokeDefaultOnBackPressed方法。
  • ReactInstanceManager在onHostResume(Activity activity, DefaultHardwareBackBtnHandler defaultBackButtonImpl);中需要传入activity和handler接口。
  • ReactInstanceManager.onBackPressed()会通过DeviceEventManagerModule,向js端发送了"hardwareBackPress"消息。
  • JS中,在BackAndrod类中,默认通过全局静态方法,注册了"hardwareBackPress"的监听。如下图所示,监听中判断全局Set表中的callBack,倒序循环判断,是否有callback,callback是否返回true,如果都没有,就调用exitApp。

  • BackAndroid.App()通过下图中的原生module,最终经过几次变换,会调用到上面Activity的DefaultHardwareBackBtnHandler接口,通过invokeDefaultOnBackPressed()响应。

  • 最后在invokeDefaultOnBackPressed中通过 super.onBackPressed();结束Activity的一生。

【4】综合理解,React Native对于android back按键,是在onBackPressed中,把所有的back事件都发到js端,如果js端没监听,或者监听都返回了false,那么就会回到继承了DefaultHardwareBackBtnHandler接口,实现了invokeDefaultOnBackPressed的Activity处理。

2、创建你的Moudle实现自定义交互

(˶‾᷄ ⁻̫ ‾᷅˵)下方干货满满,请耐心吸食

 首先我们创建一个DetailMoudle继承ReactContextBaseJavaModule,如下图。

  • 通过getName指定了js端使用的名字。
  • 通过@ReactMethod注解指定了哪些方法可以被js端调用,js端可以传递指定类型的参数,这里注意【5】@ReactMethod的返回类型一定是void
  • 参数传递js端与android端对应如下图。
  • Callback/Promise 都是回调接口,promise有更多元化的回调选择。但是注意:【6】无论是Callback 还是 Promise ,在执行invoke/(reject、resolve)之后,都会在js的消息队列中被销毁,不能再调用一次,也就是说所有的callback只能执行一次。
  • 你还可以通过消息机制实现android和js端的交互,如下图。

  • 如下图,通过继承ActivityEventListener,用ReactApplicationContext添加监听,可以方便的在module中监听activity返回。网上说的用消息阻塞队列的做法就算了吧。

  • 通过如下方法,可以在android的其他位置拿到module对象。

  • 创建一个DetailPackage 继承 ReactPackage,将创建好的DetailModule添加到createNativeModules方法中,如下图。

  • 最后将你的ReactPackage添加到你的ReactNativeHost或者ReactInstanceManager中。在js端通过下图方式调用。

 欧耶,终于码完了,你是不是对于React Native 相关的通信机制,还有交互实现有了新的了解呢?如果你觉得还不满足,这里推荐一个深度了解React Native通信的系列。文中从android到js端,还有jni层面都做了详细的跟踪,有兴趣的可跳转观摩,下方链接。

React-Native系列Android——Native与Javascript通信原理

项目相关的源码:https://github.com/CarGuo/LearnProject

RN完整学习项目:https://github.com/CarGuo/GSYGithubAPP

个人github:https://github.com/CarGuo

还记得我么

目录
相关文章
|
1月前
|
搜索推荐 前端开发 API
探索安卓开发中的自定义视图:打造个性化用户界面
在安卓应用开发的广阔天地中,自定义视图是一块神奇的画布,让开发者能够突破标准控件的限制,绘制出独一无二的用户界面。本文将带你走进自定义视图的世界,从基础概念到实战技巧,逐步揭示如何在安卓平台上创建和运用自定义视图来提升用户体验。无论你是初学者还是有一定经验的开发者,这篇文章都将为你打开新的视野,让你的应用在众多同质化产品中脱颖而出。
55 19
|
1月前
|
JSON Java API
探索安卓开发:打造你的首个天气应用
在这篇技术指南中,我们将一起潜入安卓开发的海洋,学习如何从零开始构建一个简单的天气应用。通过这个实践项目,你将掌握安卓开发的核心概念、界面设计、网络编程以及数据解析等技能。无论你是初学者还是有一定基础的开发者,这篇文章都将为你提供一个清晰的路线图和实用的代码示例,帮助你在安卓开发的道路上迈出坚实的一步。让我们一起开始这段旅程,打造属于你自己的第一个安卓应用吧!
61 14
|
1月前
|
XML 存储 Java
探索安卓开发之旅:从新手到专家
在数字时代,掌握安卓应用开发技能是进入IT行业的关键。本文将引导读者从零基础开始,逐步深入安卓开发的世界,通过实际案例和代码示例,展示如何构建自己的第一个安卓应用。我们将探讨基本概念、开发工具设置、用户界面设计、数据处理以及发布应用的全过程。无论你是编程新手还是有一定基础的开发者,这篇文章都将为你提供宝贵的知识和技能,帮助你在安卓开发的道路上迈出坚实的步伐。
35 5
|
1月前
|
开发框架 Android开发 iOS开发
安卓与iOS开发中的跨平台策略:一次编码,多平台部署
在移动应用开发的广阔天地中,安卓和iOS两大阵营各占一方。随着技术的发展,跨平台开发框架应运而生,它们承诺着“一次编码,到处运行”的便捷。本文将深入探讨跨平台开发的现状、挑战以及未来趋势,同时通过代码示例揭示跨平台工具的实际运用。
|
1月前
|
XML 搜索推荐 前端开发
安卓开发中的自定义视图:打造个性化UI组件
在安卓应用开发中,自定义视图是一种强大的工具,它允许开发者创造独一无二的用户界面元素,从而提升应用的外观和用户体验。本文将通过一个简单的自定义视图示例,引导你了解如何在安卓项目中实现自定义组件,并探讨其背后的技术原理。我们将从基础的View类讲起,逐步深入到绘图、事件处理以及性能优化等方面。无论你是初学者还是有经验的开发者,这篇文章都将为你提供有价值的见解和技巧。
|
1月前
|
搜索推荐 前端开发 测试技术
打造个性化安卓应用:从设计到开发的全面指南
在这个数字时代,拥有一个定制的移动应用不仅是一种趋势,更是个人或企业品牌的重要延伸。本文将引导你通过一系列简单易懂的步骤,从构思你的应用理念开始,直至实现一个功能齐全的安卓应用。无论你是编程新手还是希望拓展技能的开发者,这篇文章都将为你提供必要的工具和知识,帮助你将创意转化为现实。
|
1月前
|
Java Android开发 开发者
探索安卓开发:构建你的第一个“Hello World”应用
在安卓开发的浩瀚海洋中,每个新手都渴望扬帆起航。本文将作为你的指南针,引领你通过创建一个简单的“Hello World”应用,迈出安卓开发的第一步。我们将一起搭建开发环境、了解基本概念,并编写第一行代码。就像印度圣雄甘地所说:“你必须成为你希望在世界上看到的改变。”让我们一起开始这段旅程,成为我们想要见到的开发者吧!
38 0
|
2月前
|
前端开发 JavaScript 开发者
颠覆传统:React框架如何引领前端开发的革命性变革
【10月更文挑战第32天】本文以问答形式探讨了React框架的特性和应用。React是一款由Facebook推出的JavaScript库,以其虚拟DOM机制和组件化设计,成为构建高性能单页面应用的理想选择。文章介绍了如何开始一个React项目、组件化思想的体现、性能优化方法、表单处理及路由实现等内容,帮助开发者更好地理解和使用React。
91 9
|
3月前
|
前端开发
深入解析React Hooks:构建高效且可维护的前端应用
本文将带你走进React Hooks的世界,探索这一革新特性如何改变我们构建React组件的方式。通过分析Hooks的核心概念、使用方法和最佳实践,文章旨在帮助你充分利用Hooks来提高开发效率,编写更简洁、更可维护的前端代码。我们将通过实际代码示例,深入了解useState、useEffect等常用Hooks的内部工作原理,并探讨如何自定义Hooks以复用逻辑。
|
2月前
|
监控 前端开发 数据可视化
3D架构图软件 iCraft Editor 正式发布 @icraft/player-react 前端组件, 轻松嵌入3D架构图到您的项目,实现数字孪生
@icraft/player-react 是 iCraft Editor 推出的 React 组件库,旨在简化3D数字孪生场景的前端集成。它支持零配置快速接入、自定义插件、丰富的事件和方法、动画控制及实时数据接入,帮助开发者轻松实现3D场景与React项目的无缝融合。
197 8
3D架构图软件 iCraft Editor 正式发布 @icraft/player-react 前端组件, 轻松嵌入3D架构图到您的项目,实现数字孪生