Saltar al contenido principal
Versión: 0.82

Configura tu entorno

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 →

En esta guía, aprenderás a configurar tu entorno para ejecutar tu proyecto con Android Studio y Xcode. Esto te permitirá desarrollar con emuladores de Android y simuladores de iOS, construir tu aplicación localmente y más.

información

Esta guía requiere Android Studio o Xcode. Si ya tienes uno de estos programas instalados, podrás ponerte en marcha en pocos minutos. Si no los tienes instalados, deberás dedicar aproximadamente una hora a instalarlos y configurarlos.

Is setting up my environment required?

Setting up your environment is not required if you're using a Framework. With a React Native Framework, you don't need to set up Android Studio or Xcode as it will take care of building the native app for you

If you have constraints that prevent you from using a Framework, or you'd like to write your own Framework, then setting up your local environment is a requirement. After your environment is set up, learn how to get started without a framework.

Sistema operativo de desarrollo​

Target OS​

Instalación de dependencias​

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 Node, la interfaz de línea de comandos de React Native, un JDK y Android Studio.

Aunque puedes usar cualquier editor de tu preferencia para desarrollar tu aplicación, necesitarás instalar Android Studio para configurar las herramientas necesarias para construir tu aplicación de React Native para Android.

Node

Sigue las instrucciones de instalación para tu distribución de Linux para instalar Node 20.19.4 o superior.

Java Development Kit

Actualmente React Native recomienda la versión 17 del Java SE Development Kit (JDK). Puedes encontrar problemas con versiones más recientes de JDK. Puedes descargar e instalar OpenJDK desde AdoptOpenJDK o mediante el gestor de paquetes de tu sistema.

Android development environment

Configurar tu entorno de desarrollo puede ser un tanto tedioso si eres nuevo en el desarrollo para Android. Si ya estás familiarizado con el desarrollo para Android, puede que haya algunas cosas que necesites configurar. En cualquier caso, por favor asegúrate de seguir cuidadosamente los próximos pasos.

1. Install Android Studio

Descarga e instala Android Studio. Durante el asistente de instalación de Android Studio, asegúrate de que las casillas junto a todos los siguientes elementos estén marcadas:

  • Android SDK

  • Android SDK Platform

  • Android Virtual Device

Luego, haz clic en "Next" para instalar todos estos componentes.

nota

Si las casillas de verificación están atenuadas, tendrás la oportunidad de instalar estos componentes más adelante.

Una vez que la configuración haya finalizado y se te presente la pantalla de bienvenida, continúa con el siguiente paso.

2. Install the Android SDK

Android Studio instala el último SDK de Android por defecto. Sin embargo, construir una aplicación de React Native con código nativo requiere específicamente el SDK Android 15 (VanillaIceCream). Puedes instalar SDKs adicionales de Android a través del SDK Manager en Android Studio.

Para ello, abre Android Studio, haz clic en el botón "Configure" y selecciona "SDK Manager".

consejo

El SDK Manager también se puede encontrar en el diálogo "Configuración" de Android Studio, en Lenguajes y frameworks → Android SDK.

Selecciona la pestaña "SDK Platforms" dentro del SDK Manager, luego marca la casilla junto a "Show Package Details" en la esquina inferior derecha. Busca y expande la entrada Android 15 (VanillaIceCream), luego asegúrate de que los siguientes elementos estén marcados:

  • Android SDK Platform 35

  • Intel x86 Atom_64 System Image o Google APIs Intel x86 Atom System Image

A continuación, selecciona la pestaña "SDK Tools" y marca la casilla junto a "Show Package Details" aquí también. Busca y expande la entrada "Android SDK Build-Tools", luego asegúrate de que estén seleccionados 36.0.0 y Android SDK Command-line Tools (latest).

Finalmente, haz clic en "Apply" para descargar e instalar el SDK de Android y las herramientas de compilación relacionadas.

3. Configure the ANDROID_HOME environment variable

Las herramientas de React Native requieren configurar algunas variables de entorno para poder construir aplicaciones con código nativo.

Agrega estas líneas a tu archivo de configuración $HOME/.bash_profile o $HOME/.bashrc (si usas zsh, entonces ~/.zprofile o ~/.zshrc):

shell
export ANDROID_HOME=$HOME/Android/Sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/platform-tools
nota

.bash_profile es específico de bash. Si usas otro shell, deberás editar el archivo de configuración específico de ese shell.

Ejecuta source $HOME/.bash_profile para bash o source $HOME/.zprofile para cargar la configuración en tu shell actual. Verifica que ANDROID_HOME esté configurado con echo $ANDROID_HOME y que las rutas correctas se hayan añadido con echo $PATH.

nota

Por favor, asegúrate de usar la ruta correcta del SDK de Android. Puedes encontrar la ubicación real del SDK en el diálogo "Settings" de Android Studio, dentro de Languages & Frameworks → Android SDK.

Watchman

Sigue la guía de instalación de Watchman para compilar e instalar Watchman desde el código fuente.

información

Watchman es una herramienta de Facebook para monitorear cambios en el sistema de archivos. Es muy recomendable instalarlo para mejor rendimiento y mayor compatibilidad en ciertos casos extremos (traducción: podrías funcionar sin instalarlo, pero los resultados pueden variar; instalarlo ahora podría evitarte problemas después).

Preparing the Android device

Necesitarás un dispositivo Android para ejecutar tu aplicación de React Native para Android. Puede ser un dispositivo físico Android o, más comúnmente, puedes usar un Android Virtual Device (Dispositivo Virtual Android) que te permite emular un dispositivo Android en tu computadora.

En cualquier caso, necesitarás preparar el dispositivo para ejecutar aplicaciones Android para desarrollo.

Using a physical device

Si tienes un dispositivo Android físico, puedes usarlo para desarrollo en lugar de un AVD conectándolo a tu computadora mediante un cable USB y siguiendo las instrucciones aquí.

Using a virtual device

Si usas Android Studio para abrir ./AwesomeProject/android, puedes ver la lista de Android Virtual Devices (AVDs) disponibles abriendo el "AVD Manager" desde Android Studio. Busca un icono que se vea así:

Android Studio AVD Manager

Si has instalado recientemente Android Studio, es probable que necesites crear un nuevo AVD. Selecciona "Crear dispositivo virtual...", luego elige cualquier teléfono de la lista y haz clic en "Siguiente", y luego selecciona la imagen VanillaIceCream API Level 35.

consejo

Recomendamos configurar aceleración por VM en tu sistema para mejorar el rendimiento. Tras seguir esas instrucciones, regresa al AVD Manager.

Haz clic en "Next" y luego en "Finish" para crear tu AVD. En este punto, deberías poder hacer clic en el botón verde con forma de triángulo que está junto a tu AVD para iniciarlo.

That's it!

Haz clic en "Next" y luego en "Finish" para crear tu AVD. En este punto, deberías poder hacer clic en el botón verde con forma de triángulo junto a tu AVD para iniciarlo.

Now what?