Cómo compilar desde el código fuente

Traducción Beta No Oficial

Esta página fue traducida por PageTurner AI (beta). No está respaldada oficialmente por el proyecto. ¿Encontraste un error? Reportar problema →

Necesitarás compilar React Native desde el código fuente si quieres trabajar en una nueva función/corrección de errores, probar las últimas características que aún no se han lanzado o mantener tu propio fork con parches que no se puedan fusionar al núcleo.

Android

Prerrequisitos

Para compilar desde el código fuente, necesitas tener instalado el Android SDK. Si seguiste la guía Configurar el entorno de desarrollo, ya deberías estar listo.

No es necesario instalar otras herramientas como versiones específicas de NDK o CMake, ya que el Android SDK descargará automáticamente todo lo necesario para la compilación desde el código fuente.

Apunta tu proyecto a una versión nightly

Para usar las últimas correcciones y características de React Native, puedes actualizar tu proyecto a una versión nightly con:

yarn add react-native@nightly

Esto actualizará tu proyecto para usar una versión nightly de React Native que se publica cada noche con los últimos cambios.

Actualiza tu proyecto para compilar desde el código fuente

Tanto con versiones estables como nightlies, estarás consumiendo artefactos precompilados. Si prefieres compilar desde el código fuente para probar tus cambios directamente en el framework, deberás editar el archivo android/settings.gradle de la siguiente manera:

diff

  // ...
  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"))
+     }
+ }

Notas adicionales

Compilar desde el código fuente puede llevar mucho tiempo, especialmente en la primera compilación, ya que necesita descargar ~200 MB de artefactos y compilar el código nativo.

Cada vez que actualices la versión de react-native desde tu repositorio, el directorio de compilación podría borrarse y todos los archivos se volverán a descargar. Para evitar esto, puedes cambiar la ruta de tu directorio de compilación editando el archivo ~/.gradle/init.gradle:

groovy

gradle.projectsLoaded {
    rootProject.allprojects {
        buildDir = "/path/to/build/directory/${rootProject.name}/${project.name}"
    }
}

Justificación

El enfoque recomendado para trabajar con React Native es actualizar siempre a la última versión. El soporte que ofrecemos para versiones anteriores está descrito en nuestra política de soporte.

El enfoque de compilar desde el código fuente debe usarse para probar una corrección de extremo a extremo antes de enviar un pull request a React Native, y no recomendamos su uso a largo plazo. Especialmente bifurcar React Native o configurar tu entorno para compilar siempre desde el código fuente resultará en proyectos más difíciles de actualizar y generalmente en una peor experiencia de desarrollo.