写点什么

React Native 原生混合路由解决方案

  • 2021-05-31
  • 本文字数:3103 字

    阅读完需:约 10 分钟

React Native 原生混合路由解决方案

在 RN 出来前许多公司都已经有一套完整的 App,可能业务复杂、依赖繁多,在这种情况下,将原有的 App 推翻重写明显是不切实际的,成本和风险都较高。所以如何进行混合性开发则至关重要。


目前 RN 官方建议的路由框架为 react-navigation,这个框架大部分逻辑是 javascript 编写的,RN 页面的栈管理由 JS 端控制,所以当原生和 RN 页面混合开发时,由于原生栈和 RN 栈不一致,导致栈管理较混乱。出现 RN - 原生 - 原生 - RN 跳转场景时,若为单一的 RN 容器管理,则需要在返回时判断上一个页面为 RN 还是原生,嵌入基类修改;若为多 RN 容器管理,则也需要在跳转时区分是跳转原生还是 RN。


另外网上还比较广泛使用是 react-native-navigation 框架,它使用 iOS 和 Android 原生的基础 Api。但是混合开发的问题还是和 react-navigation 一致,JS 自己管理栈和原生栈不统一,导致栈管理复杂,跳转需要做额外的处理。所以通过对市面上的一些路由分析,我们通过对 react-native-navigation 框架的改造,抛弃了 JS 端的栈管理,将一个 RN 页面对应一个容器,使得 RN 的栈管理融入原生的栈管理中。


WYNavigation

主要概念


我们采用单引擎多容器的模式。前期我们已经对现有的 RN 代码进行了拆包,分为一个 common 包和 n 个 business 包。并且原生工程中每个页面都是以 RouteUrl(类似浏览器地址)的方式进行跳转的。这两点为我们的方案提供了技术支持。共用一个 common 包使得我们的代码共享一个 RN 引擎,RouteUrl 的模式也使得我们在跳转页面时不需要去关心是跳转原生还是 RN 页面。下面是打开一个 RN 页面的流程:和 react-native-navigation 一样,我们会将所有的 RN 页面在 Navigation 进行注册,Test 为这个 RN 页面的对外名称。


Navigation.registerComponent("Test", () => TestScreen)
复制代码


在原生主工程启动时会先预加载 common 包,当需要打开一个 RN 页面时,原生会先打开一个 RN 容器,根据传递过来的 PageName 找到对应的 business 包加载,再将 PageName 传到 RN 端,RN 端根据 PageName 找到对应的 RN 页面显示,容器根据找到的 RN 页面中的静态变量初始化原生导航栏,这样因为该 RN 容器等于一个原生页面,这个容器中只有一个 RN 页面,所以一个 RN 页面等于一个原生容器,从而将该 RN 页面嵌入到了原生导航栈中。这样就实现了 RN 和原生导航栈的统一。



组件、页面、容器的理解


这里我们要说 3 个概念:组件 (Component):RN 上具有独立功能的单位,一个页面由多个组件组成。页面 (Screen):UI 意义上的页面,包括导航栏及内容显示。容器 (RNContainer):原生用来容纳 RN 的容器,用于显示 RN 页面。我们的方案是多个组件 = 一个页面 = 一个容器 = 一个原生页面,所有 RN 页面上的 push 和 pop 实际上最后都会经过容器的原生跳转,这样处理就相当于 RN 页面进行跳转和返回时和原生并没有什么区别。



路由的跳转


结合我们现有的 App 路由模式,我们统一 iOS 和 Android 两端容器的协议,将 RN 页面名称通过参数的形式进行传递。


原生跳转到 RN


从原生页面跳转到 RN 页面时,需要指定一个入参 pageName,即要跳转的 RN 页面的名称。如果需要传参,定义一个字典,键为 param,值是传递的参数。如下,MyPost 是一个 RN 页面的名字。


// 原生跳转 RNNSDictionary *params = @{@"pageName": @"MyPost", @"param": param};[WYMediator routeURL:WYURL(@"xxx/rncontainer") withParams:par];
复制代码


// 原生跳转ExtParams param = new ExtParams();param.putStringExtra("PageName", "MyPost");param.putStringExtra("PageParam", pageParams);Router.startRoute(activity, "xxx/rncontainer", param);
复制代码


RN 跳转到原生


从 RN 页面跳转到原生页面,也遵循我们的路由协议。这个过程是原生实现的,它会调用原生的路由组件,从 RN 容器跳转到指定的原生页面。如下,name 指的是原生页面对应的协议,passProps 则是需要跳转到的原生页面需要的参数,没有则可不写。最后一个参数是回调函数,当执行 push 方法时,路由会根据传入的 componentId 将回调函数保存在 JS 端,原生页面关闭后回到当前 RN 页面时,路由会根据当前页面的 component 取出回调函数并执行。


Navigation.push(this.props.componentId, {    name:"xxxx",    passProps:{patientId:'11111', patientName:'张三'}}, (componentId, params) => {    // 返回当前页面的回调函数});
复制代码


RN 跳转到 RN


RN 之间的跳转和 RN 跳转到原生相同,通过 push 的方法传递 name、passProps 和 callback 回调,只不过这里的 name 不再是原生的协议,而是以下注册的名称。


Navigation.registerComponent("Test", () => TestScreen);
复制代码


RN 页面返回


需要关闭当前 RN 页很简单,只要调用 pop 方法就行。


Navigation.pop(this.props.componentId, passProps:{})
复制代码


passProps 指的是需要传递回上一个页面的参数,用于之前 push 中的 callback 方法的回调,没有则可不写。


容器生命周期


RN 的组件 Component 有自己的生命周期:


  • constructor() // 构造方法

  • componentWillMount() // 即将加载

  • componentDidMount() // 加载完成

  • componentWillUnmount() // 组件已被卸载


但是有时候我们光这些并不能满足我们的业务需求,对于一个 RN 页面对用一个容器来说,容器的生命周期也至关重要,我们需要在容器的隐藏显示过程中做点其他事,所以我们在新的路由框架中加入了容器的生命周期:


  • containerWillAppear() // 容器即将显示

  • containerDidAppear() // 容器正在显示

  • containerWillDisappear() // 容器即将消失

  • containerDidDisappear() // 容器正在隐藏


容器的生命周期和组件的生命周期没有必要先后顺序,大多数情况下是在当容器再次显示时需要做一些数据更新时使用,所以可能会调用多次。


导航栏配置


目前导航栏的配置是同 react-native-navigation 框架一样,采用 Tree 的样式将导航参数传入,原生对其进行设置。基本的使用方式如下:


class MyScreen extends Component {  static options(passProps) {    return {      topBar: {        title: {       text: '我的页面'      },        leftButtons: [          {            id: 'buttonOne',            icon: require('icon.png')          }        ],        rightButtons: [],      }    };  }}
复制代码


RN 页面加载的时候,会根据注册的 PageName 获取到当前页面的 Component,上面的例子就是指 MyScreen,从而获取到对应的静态变量 options,再将它传递到当前的 RN 容器中,RN 容器会根据里面的配置生成导航栏进行显示,这样使用原生的导航栏可以保证页面和原生高度重合,而且也不用为了修改原生导航栏而新增桥接类,方便高效。


总结及问题


目前 WYNavigation 已经在微医生项目中投入使用,使用过程中未发现明显 bug,这一方案以一个简单的方式很好的解决了复杂混合场景中导航栈混乱的问题。但是由于目前相关业务涉及到的页面形式单一,所以对于其他 tab、modal 等涉及到多个 RN 页面平级的情况未做过多的深入,但是在未来我们希望能尽快的补充这方面的缺失,把它作为一个通用的解决方案,用于更多的 RN 和原生混合开发的项目中,希望感兴趣的小伙伴和我们一起交流分享。



头图:Unsplash

作者:黄丽丽

原文:https://mp.weixin.qq.com/s/W75sT2px7P9rHJUrmTwY4g

原文:React Native 原生混合路由解决方案

来源:微医大前端技术 - 微信公众号 [ID:wed_fed]

转载:著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。

2021-05-31 14:003340

评论

发布
暂无评论
发现更多内容

Java核心知识体系-线程管理

不在线第一只蜗牛

Java 线程

大模型的效率腾飞,彩云科技做对了什么?

脑极体

AI

电子文档管理软件选购指南:9款产品深度对比

易成研发中心

2024-11-16:哈沙德数。用go语言,如果一个整数能够被它的各个数位上数字的和整除, 我们称这个整数为哈沙德数(Harshad number)。 给定一个整数 x, 如果 x 是哈沙德数,则返回

福大大架构师每日一题

福大大架构师每日一题

矩阵起源入选IDC《RAG与向量数据库市场前景预测》报告

MatrixOrigin

IDC 向量数据库

直播回顾 | MatrixOne 2.0 AI 向量数据库与GenAI能力深度解析

MatrixOrigin

数据库 云原生 AI搜索

怎样提高redis的命中率

百度搜索:蓝易云

【进阶篇】一文搞清楚网页发起 HTTP 请求调用的完整过程

EquatorCoco

网络协议 HTTP

蜗牛游戏宣布2024年第三季度财报业绩

财见

【摘录】《学会提问》

充实的orzi

阅读

Red Hat Enterprise Linux 10 下载 - 红帽企业 Linux

sysin

redhat RHEL

轻松在 Neolink.AI 上搭建你的个性化 ChatGPT 服务

MatrixOrigin

ChatGPT 定制

volatile关键字最全原理剖析

快乐非自愿限量之名

字段 volatitle

ESG,全才产品经理培训新特色

科技热闻

Viper,一个Go语言配置管理神器!

左诗右码

什么是低代码平台,低代码平台有哪些优势

JeeLowCode低代码平台

Redis的主从复制,哨兵和Cluster集群

百度搜索:蓝易云

Rust字符串类型全解析

EquatorCoco

算法 rust 网络

10月份主要经济体工厂需求减弱:GEP全球供应链波动指数

财见

8款有效提升企业文档管理的工具推荐

易成研发中心

为什么说MEMS-OXC在智算场景没有未来?

脑极体

ESG,产品经理认证新热点

科技热闻

Ubuntu系统下配置用户ssh只能访问git仓库

百度搜索:蓝易云

录屏神器Camtasia2024中文永久免费版安装教程,camtasia喀秋莎汉化补丁破解版激活码

阿拉灯神丁

录屏软件 激活码生成器 后期制作 Camtasia Studio2024 视频剪辑软件下载

洗鞋小程序(源码+文档+部署+讲解)

深圳亥时科技

BSI主办IEC第88届大会,聚焦全电力社会转型中的风险和机遇

财见

《Django 5 By Example》阅读笔记:p165-p210

codists

Python django

30+程序员降薪跳槽到银行,技术优势在晋升体系下成了空谈

码哥字节

银行 互联网人 职场晋升

高并发编程/消息传递机制避免锁提高并发效率,不懂的赶紧进来(设计篇)

肖哥弹架构

Java 并发编程 高并发

智慧联防系统(源码+文档+部署+讲解)

深圳亥时科技

电子合同风险管理:签约前的注意事项

易成研发中心

电子合同 电子合同软件

React Native 原生混合路由解决方案_语言 & 开发_微医大前端技术_InfoQ精选文章