如何从源代码构建
如果您想开发新功能/修复错误、尝试尚未发布的新功能,或维护自己的带补丁的 Fork(这些补丁无法合并到核心),则需要从源代码构建 React Native。
Android
先决条件
要从源代码构建,您需要安装 Android SDK。如果您按照设置开发环境指南操作,应该已经设置好了。
无需安装其他工具,例如特定版本的 NDK 或 CMake,因为 Android SDK 将自动下载从源代码构建所需的一切。
将您的项目指向夜间版本
要使用 React Native 的最新修复和功能,您可以通过以下方式将项目更新为使用 React Native 的夜间版本:
yarn add react-native@nightly
这将更新您的项目以使用每天发布的包含最新更改的 React Native 夜间版本。
更新您的项目以从源代码构建
无论是稳定版还是夜间版,您都将使用预编译的工件。如果您想切换到从源代码构建,以便直接测试您对框架的更改,则需要编辑 android/settings.gradle
文件,如下所示:
差异
// ...
include ':app'
includeBuild('../node_modules/@react-native/gradle-plugin')
+ includeBuild('../node_modules/react-native') {
+ dependencySubstitution {
+ substitute(module("com.facebook.react:react-android")).using(project(":packages:react-native:ReactAndroid"))
+ substitute(module("com.facebook.react:react-native")).using(project(":packages:react-native:ReactAndroid"))
+ substitute(module("com.facebook.react:hermes-android")).using(project(":packages:react-native:ReactAndroid:hermes-engine"))
+ substitute(module("com.facebook.react:hermes-engine")).using(project(":packages:react-native:ReactAndroid:hermes-engine"))
+ }
+ }
附加说明
从源代码构建可能需要很长时间,尤其是首次构建时,因为它需要下载约 200 MB 的工件并编译原生代码。
每次您从仓库更新 react-native
版本时,构建目录可能会被删除,并且所有文件都会重新下载。为避免这种情况,您可能需要通过编辑 ~/.gradle/init.gradle
文件来更改您的构建目录路径
groovy
gradle.projectsLoaded {
rootProject.allprojects {
buildDir = "/path/to/build/directory/${rootProject.name}/${project.name}"
}
}
基本原理
使用 React Native 的推荐方法是始终更新到最新版本。我们对旧版本提供的支持在我们的支持政策中有所描述。
从源代码构建的方法应用于在向 React Native 提交拉取请求之前进行端到端测试修复,我们不鼓励长期使用它。特别是 Fork React Native 或将您的设置切换为始终使用从源代码构建的版本,将导致项目更难更新,并且通常会带来更差的开发体验。