RN 框架工程相关指南

Check out 工程

工程 svn 路径:http://tc-svn.tencent.com/ReactNative/react_native_proj/branches/rn_39_release_project

工程结构介绍

目前框架内部主要为四个部分:

  • app —- 应用主体业务部分(Module 1)
  • ReactAndroid —- RNAndroid 源码部分 (Module 2)
  • ReactCommon —- RNAndroid/RNiOS 公共源码部分
  • jsbundle —- js 代码,包含第三方控件与 API、以及业务相关代码(目前为 Demo 集合展示)

配置 NDK 路径(Not Necessary)

如果有修改 c 代码重新打包新的 so 的需要,请在工程的 config/config.gradle 中将 ndkAutoBuild 参数设置为 true

此开关决定是否开启编译时 ndk 自动构建,默认为关。当打开时,若 c 部分代码存在改动,编译运行时会自动编译生成最新的 so 打入 apk,但是需要 Facebook 规定的 r10e 版本的环境。

请参照工程中提供的 local-template.properties 文件修改指定的 NDK 路径。

各平台的 NDK 下载链接如下:

编译运行

快捷键:Control R (Mac) / Shift F10 (Win)

是不是很熟悉~ 是的,就是它的快捷键:

如果需要单独编译 so,也可以尝试在工程根目录下命令行输入:gradlew ndkBuild

打包 jsbundle

目前项目中使用的内置 jsbundle 暂命名为 index.android.bundle,对应注册名为 rn,放置在 app/src/main/assets 下。

如上文结构中提到,js 代码在 jsbundle 文件夹下,若需要编译打包新的 jsbundle,可以考虑直接在 jsbundle 目录下直接命令行运行 npm install 下载需要的依赖。下载完成后,可以尝试打包 jsbundle,打包命令为:

react-native bundle --platform android --dev true --entry-file UIExplorer/UIExplorerApp.android.js --bundle-output [YOUR BUNDLE DEST PATH]index.android.bundle

将生成的 bundle 放置在上文的路径即可。

PS:后面会支持读 SD 卡的外部 bundle。

RN 源码修改记录与同步(Important)

考虑到 FB 对 RN 的版本升级仍处于一个较为频繁的节奏,因此原则上我们需要尽量避免对 RN 源码进行修改,减少升级同步代码所带来的工作量。然而由于业务或工程需要(打入 log、修复隐藏的坑等等),不得不修改源码时,请将修改的部分在工程中的 CodeModificationAttention.md 文件中做好记录方便所有成员周知,例如:

  • ABC.java 中新增 methodA 方法、新增 paramA 成员变量… …——by 成员 A
  • DEF.javamethodB 方法修改… …——by 成员 B

具体请参照 CodeModificationAttention.md 内已修改部分即可。

RN 源码升级(Important)

PS:若需要升级 RN 源码请知会 joltwang && mangosmwang && timorzheng && xepherjin

当需要升级 RN 版本时,请确保从 github 上拉到的是已稳定 release 版本的 RN 源码!

从新的源码工程中提取出 ReactAndroid 与 ReactCommon 部分,替换至本工程对应的部分,需要注意的几点如下:

  • 打开 ndkAutoBuild 开关(参考"配置 NDK 路径")
  • 拷贝过来后按照 CodeModificationAttention.md 补齐对应的修改(Important)
  • 删减不需要的平台的 so:修改 ReactAndroid 模块下 src/main/jni/Application..mkAPP_ABI 参数,调整为 APP_ABI := armeabi-v7a
  • 移除 BUCK 相关的无用文件
  • 对比更新 ReactAndroid 模块下的 build.gradle 中的下载编译逻辑,一些包括文件名与下载地址在内的常量信息同步更新至 config/config.gradle,并将最新的需要下载的文件提前下载好更新至 preDownloads 目录下
  • 升级完成后提交修改时,不要忘记提交最新的编译好的 so

混淆代码部分

待补充

常见问题

1、Q:打开 ndk 开关后编译报错:

Android NDK: ../FastArithmetic/ReactAndroid/src/main/jni/first-party/fb/Android.mk: Cannot find module with tag 'folly' in import path

A:请修改 NDK 版本为 r10e 版本,参照上文"配置 NDK 路径"。

2、Q:(接 1)为什么我修改了还是报这个错?

A:试试先 gradle sync ,再运行工程。

3、Q:为什么打开 ndk 开关后,我的 c 代码修改没有生效打进新的 so 中?

A:请关闭 Instant Run 功能(AS Ver >= 2.0),并设置强制每次编译强制安装最新的 apk:

4、Q:为什么 npm install 很慢,一直卡在那里不动了?

A:请切换到 staff-wifi 再运行(Mac)。

5、Q:为什么最新的 RN 官方源码工程打开后一直在 gradle sync?

A:请切换到 staff-wifi 再运行(Mac)。

原创声明,本文系作者授权云+社区发表,未经许可,不得转载。

如有侵权,请联系 yunjia_community@tencent.com 删除。

编辑于

晋中望的专栏

1 篇文章1 人订阅

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏菩提树下的杨过

android 模拟器安装二三事

今天在测试一个手机版网站时,发现“微软的wp7”跟“苹果的iOS”对于<select>..</select>元素的触摸操作不太一样,wp7是全屏切换到一个上下滚...

22310
来自专栏林德熙的博客

dotnet core 通过修改文件头的方式隐藏控制台窗口

在带界面的 dotnet core 程序运行的时候就会出现一个控制台窗口,本文告诉大家使用最简单方法去隐藏控制台窗口。

651
来自专栏coding for love

浏览器加载解析渲染机制的全面解析

(注1:如果有问题欢迎留言探讨,一起学习!转载请注明出处,喜欢可以点个赞哦!) (注2:更多内容请查看我的目录。)

851
来自专栏前端小记

React + TS + Ant Design 裁包小记

前段时间做了一个项目,是使用 Create-React-App 脚手架 + TypeScript + Ant Design 组件库搭建的,在减少包体积上有一些...

40112
来自专栏Java技术分享

基于Metronic的Bootstrap开发框架经验总结(5)--Bootstrap文件上传插件File Input的使用

Bootstrap文件上传插件File Input是一个不错的文件上传控件,但是搜索使用到的案例不多,使用的时候,也是一步一个脚印一样摸着石头过河,这个控件在界...

2479
来自专栏大数据钻研

前端开发必备!Emmet使用手册

介绍 Emmet (前身为 Zen Coding) 是一个能大幅度提高前端开发效率的一个工具: 基本上,大多数的文本编辑器都会允许你存储和重用一些代码块,我们称...

3328
来自专栏java架构师

资源文件的动态加载

页面加载 首先,浏览器发起直接对目标html的请求,然后分析其中用到的资源并下载,浏览器有自己的规则来判断什么样的资源可以被并行下载,什么样的不可以,浏览器对加...

3069
来自专栏芋道源码1024

Java 工程师居家必备的 Intellij IDEA Top10 插件

支持lombok的各种注解,从此不用写getter setter这些 可以把注解还原为原本的java代码 非常方便

1175
来自专栏云飞学编程

python简单应用!用爬虫来采集天猫所有优惠券信息,写入本地文件

随便找一段文字,然后点击右键查看网页源代码,看看是否存在该文字,如果存在,那么这个网页就是静态网站了!很幸运,这个网站居然是静态的。

822
来自专栏奇梦博客

发帖UMEditor编辑器增加表情,附加表情包下载 PHP 配置 XiunoBBS

1045

扫码关注云+社区