Saltar al contenido principal

Cómo abrir una solicitud de extracción

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 →

Estas instrucciones detallan el proceso paso a paso para configurar tu máquina y contribuir al repositorio principal de React Native, además de crear tu primera solicitud de extracción.

Prólogo: Preparativos​

Necesitarás algunas herramientas y dependencias para compilar y desarrollar en React Native. Estos requisitos se cubren en la guía de Configuración del entorno dentro de la sección "Construir proyectos con código nativo".

Para aceptar tu solicitud, necesitamos que envíes un Acuerdo de Licencia del Contribuyente (CLA). Solo necesitas hacerlo una vez para trabajar en cualquier proyecto open source de Meta. Solo toma un minuto, así que puedes hacerlo mientras esperas que se instalen las dependencias.

Capítulo I: Bienvenido al código abierto​

1. Instalar git​

El código fuente de React Native está alojado en GitHub. Puedes interactuar con el control de versiones de git mediante el programa de línea de comandos git. Te recomendamos seguir las instrucciones de GitHub para configurar git en tu máquina.

2. Obtener el código fuente​

Aunque puedes explorar el código fuente de React Native en GitHub, te sugerimos configurar una bifurcación en tu máquina local.

  1. Ve a https://github.com/facebook/react-native.

  2. Haz clic en el botón "Fork" en la esquina superior derecha.

  3. Cuando te lo solicite, selecciona tu nombre de usuario como alojamiento para esta bifurcación.

Ahora tendrás una bifurcación de React Native en GitHub en https://github.com/your_username/react-native. Luego, obtendrás una copia del código fuente para tu máquina local. Abre una terminal y escribe los siguientes comandos:

bash
git clone https://github.com/facebook/react-native.git
cd react-native
git remote add fork https://github.com/your_username/react-native.git
nota

Si esto te parece nuevo, no te preocupes. Puedes acceder a una terminal mediante la aplicación Terminal en macOS y Linux, o PowerShell en Windows.

Se creará un nuevo directorio react-native con el contenido del repositorio principal de React Native. Este directorio es en realidad un clon del repositorio git de React Native. Está configurado con dos remotos:

3. Crear una rama​

Recomendamos crear una nueva rama en tu bifurcación para mantener un seguimiento de tus cambios:

bash
git checkout -b my_feature_branch --track origin/main

Capítulo II: Implementar tus cambios​

1. Instalar dependencias​

React Native es un monorepositorio de JavaScript gestionado por Yarn Workspaces (Yarn Classic).

Ejecuta una instalación a nivel de proyecto:

sh
yarn

También necesitarás compilar el paquete react-native-codegen una vez:

sh
yarn --cwd packages/react-native-codegen build

2. Realizar cambios en el código​

Ahora puedes abrir el proyecto con tu editor de código preferido. Visual Studio Code es popular entre desarrolladores JavaScript y se recomienda si estás realizando cambios generales en React Native.

Configuraciones de proyecto para IDEs:

  • VS Code: Abre el archivo react-native.code-workspace. Esto debería abrirse con recomendaciones de extensiones y configurar correctamente el servicio de lenguaje Flow y otros ajustes del editor.

  • Android Studio: Abre la carpeta raíz del repositorio (que contiene el directorio de configuración .idea).

  • Xcode: Abre packages/rn-tester/RNTesterPods.xcworkspace.

3. Ejecutar tus cambios​

El paquete rn-tester puede usarse para ejecutar y validar tus cambios. Puedes obtener más información en el README de RNTester.

4. Prueba tus cambios​

Asegúrate de que tus cambios sean correctos y no introduzcan fallos en las pruebas. Puedes aprender más en Ejecutar y escribir pruebas.

5. Verifica el estilo de tu código​

Entendemos que puede llevar tiempo familiarizarse con los estilos seguidos en cada lenguaje del repositorio principal de React Native. Los desarrolladores no deberían preocuparse por detalles menores, por lo que siempre que es posible utilizamos herramientas que automatizan el proceso de ajustar tu código a las convenciones.

Por ejemplo, usamos Prettier para formatear nuestro código JavaScript. Esto te ahorra tiempo y energía, ya que puedes dejar que Prettier corrija automáticamente los problemas de formato mediante integraciones en tu editor o ejecutando manualmente yarn run prettier.

También usamos un linter para detectar problemas de estilo en tu código. Puedes verificar el estado del estilo de tu código ejecutando yarn run lint.

Para conocer más sobre convenciones de codificación, consulta la guía de estilo de código.

6. Visualiza tus cambios​

Muchos editores populares se integran con el control de versiones. También puedes usar git status y git diff en la línea de comandos para seguir los cambios realizados.

Capítulo III: Propón tus cambios​

1. Guarda tus cambios en un commit​

Asegúrate de agregar tus cambios al control de versiones usando git:

bash
git add <filename>
git commit -m <message>

Puedes usar una oración descriptiva breve como mensaje de commit.

nota

¿Preocupado por escribir buenos mensajes de commit? No te preocupes. Más tarde, cuando se fusione tu pull request, todos tus commits se comprimirán en uno solo. La descripción de tu pull request se usará para redactar el mensaje de este commit comprimido.

Esta guía cubre suficiente información para ayudarte con tu primera contribución. GitHub tiene varios recursos para comenzar con git:

2. Sube tus cambios a GitHub​

Una vez que tus cambios estén guardados en el control de versiones, puedes subirlos a GitHub.

bash
git push fork <my_feature_branch>

Si todo va bien, verás un mensaje que te anima a abrir un pull request:

remote:
remote: Create a pull request for 'your_feature_branch' on GitHub by visiting:
remote:      https://github.com/your_username/react-native/pull/new/your_feature_branch
remote:

Visita la URL proporcionada para continuar con el siguiente paso.

3. Crea tu pull request​

¡Ya casi estás! El siguiente paso es completar el pull request. Usa un título descriptivo y no demasiado largo. Luego, asegúrate de completar todos los campos del template predeterminado:

  • Resumen: Usa este campo para explicar tu motivación al enviar este pull request. ¿Qué estás corrigiendo?

  • Registro de cambios: Ayuda a los mantenedores de lanzamientos a escribir las notas de versión proporcionando una breve descripción de lo que cambiará si se fusiona el pull request.

  • Plan de pruebas: Informa a los revisores cómo probaste tus cambios. ¿Consideraste casos límite? ¿Qué pasos seguiste para asegurarte de que tus cambios tengan el efecto deseado? Consulta ¿Qué es un plan de pruebas? para saber más.

4. Revisa y aborda los comentarios​

Presta atención a los comentarios y retroalimentación de revisión que aparezcan en tu pull request en GitHub. Los mantenedores harán todo lo posible para proporcionar comentarios constructivos y prácticos que ayuden a preparar tus cambios para ser fusionados en el repositorio principal de React Native.