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 下载链接如下：

Mac OS (64-bit) - http://dl.google.com/android/repository/android-ndk-r10e-darwin-x86_64.zip
Linux (64-bit) - http://dl.google.com/android/repository/android-ndk-r10e-linux-x86_64.zip
Windows (64-bit) - http://dl.google.com/android/repository/android-ndk-r10e-windows-x86_64.zip
Windows (32-bit) - http://dl.google.com/android/repository/android-ndk-r10e-windows-x86.zip

编译运行

快捷键：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.java 中 methodB 方法修改… …——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..mk 中 APP_ABI 参数，调整为 APP_ABI := armeabi-v7a
移除 BUCK 相关的无用文件
对比更新 ReactAndroid 模块下的 build.gradle 中的下载编译逻辑，一些包括文件名与下载地址在内的常量信息同步更新至 config/config.gradle，并将最新的需要下载的文件提前下载好更新至 preDownloads 目录下
升级完成后提交修改时，不要忘记提交最新的编译好的 so