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 条评论
登录 后参与评论

相关文章

来自专栏木头编程 - moTzxx

ThinkPHP 框架下支付宝支付

版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/u011415782/article/de...

2663
来自专栏Linux驱动

arm裸板驱动总结(makefile+lds链接脚本+裸板调试)

在裸板2440中,当我们使用nand启动时,2440会自动将前4k字节复制到内部sram中,如下图所示: ? 然而此时的SDRAM、nandflash的控制时序...

2789
来自专栏阮一峰的网络日志

Systemd 入门教程:命令篇

Systemd 是 Linux 系统工具,用来启动守护进程,已成为大多数发行版的标准配置。 本文介绍它的基本用法,分为上下两篇。今天介绍它的主要命令,下一篇介绍...

3446
来自专栏码生

react native 增量升级 热更新 思路

1233
来自专栏ionic3+

【Weex一瞥笔记】

安装结束后你可以直接使用 weex 命令验证是否安装成功,它会显示 weex 命令行工具各参数:

1013
来自专栏bboysoul

在树莓派上搭建使用gitlab

gitlab是一个代码托管平台,因为我的树莓派系统是安装在128G的u盘上的,用来放电影太小,但是空着就是空着了,所以还不如再搭建一个gitlab服务来存放自己...

1282
来自专栏黑泽君的专栏

VisualSVN Server 的安装(windows版本)

  地址:https://www.visualsvn.com/downloads/

801
来自专栏C/C++基础

Linux基础知识点

文件(包括目录)权限分为三类别,从左至右依次是:文件所属主的权限、文件所属所在用户组的权限和其他用户的权限。

1432
来自专栏乐百川的学习频道

安装和使用MongoDB

MongoDB是一个著名的NoSQL数据库,顾名思义就是不使用SQL的数据库,目前在很多场景都有使用。如果你不喜欢使用笨拙的各种SQL数据库,可以尝试使用一下M...

7846
来自专栏安恒网络空间安全讲武堂

IAT Hook 技术分析

来源:https://pentest.blog/offensive-iat-hooking/

972

扫码关注云+社区