Cómo informar de un error
Esta página fue traducida por PageTurner AI (beta). No está respaldada oficialmente por el proyecto. ¿Encontraste un error? Reportar problema →
Reportar un error en React Native es una de las mejores formas de comenzar a contribuir al proyecto. Utilizamos los issues de GitHub como canal principal para gestionar nuevos informes de errores.
Antes de abrir un nuevo reporte, por favor busca si el error ya existe en nuestro rastreador de incidencias. En la mayoría de los casos, esta es la forma más rápida de encontrar una solución ya que alguien más ya experimentó el mismo problema.
Si no encuentras tu error en el rastreador, puedes abrir uno nuevo. Una vez creada la incidencia, asegúrate de:
-
Añadir una descripción del problema.
-
Seguir las instrucciones de la plantilla para issues.
-
Indicar la versión de React Native que estás utilizando.
-
Incluir la salida del comando
npx @react-native-community/cli info. -
Añadir capturas de pantalla y videos del problema si son aplicables.
Todos los informes de errores deben incluir también un ejemplo reproducible: el código necesario para que entendamos qué está ocurriendo y nos ayude con la depuración.
Debido al alto volumen de incidencias que recibimos, los ejemplos reproducibles son obligatorios. Las incidencias sin ejemplo reproducible no pueden ser investigadas y probablemente serán cerradas.
Proporcionar un ejemplo reproducible
El objetivo de un ejemplo reproducible es proporcionar una forma de reproducir tu error. Sin él, no podremos entender el problema ni solucionarlo.
El ejemplo reproducible debe ser mínimo: tener la menor cantidad de dependencias posible (idealmente ninguna además de react-native) ya que esto nos ayuda a aislar mejor el error.
Cuando alguien en GitHub solicita un ejemplo reproducible, no está pidiendo todo tu código fuente.
En su lugar, debes crear un proyecto mínimo que reproduzca el mismo fallo/error/incidencia que estás reportando.
Este proceso es crucial, ya que a menudo los problemas se resuelven simplemente al crear un ejemplo reproducible. Al hacerlo, será más fácil determinar si el problema está relacionado con tu configuración específica o si realmente es un error interno de React Native.
Debido al volumen de actividad en React Native, solo aceptamos uno de estos formatos como ejemplo reproducible válido:
-
Para la mayoría de errores: envíanos un Pull Request con el archivo RNTesterPlayground.js modificado para reproducir tu error.
-
Si tu error está relacionado con la interfaz: un Snack.
-
Si tu error está relacionado con compilación/actualización: un proyecto usando nuestra Plantilla para ejemplos reproducibles.
RNTesterPlayground.js
La mejor forma de proporcionar un ejemplo reproducible es abrir un Pull Request contra React Native que edite el archivo RNTesterPlayground.js.
Este ejemplo ejecutará tu código contra la rama main de react-native y es la forma más rápida que tenemos para investigar y solucionar tus errores.
El archivo RNTesterPlayground.js se encuentra dentro de la aplicación RN-Tester, nuestra App de referencia. Puedes obtener más información sobre cómo funciona y cómo compilarla en su archivo README dedicado.
Aquí tienes un ejemplo de este tipo de reproductor: Reproduce modal layout issues #50704.
Una vez que edites el archivo RNTesterPlayground.js, podrás ver tu código ejecutándose dentro de la pestaña Playground de RNTester:
Expo Snack
Para la mayoría de errores relacionados con la interfaz de usuario, puedes reproducirlos usando un Expo Snack.
Con Expo Snack, puedes ejecutar código de React Native en tu navegador y verlo renderizarse al instante.
Una vez que puedas reproducir tu problema en un Expo Snack, haz clic en el botón Save para obtener un enlace compartible que adjuntarás a tu informe de error.
Reproducer Template
Para la mayoría de errores relacionados con la compilación, deberías reproducirlos usando la plantilla de reproductor de la comunidad.
Esta plantilla crea un pequeño proyecto que se ejecuta con la CLI de React Native Community y que puede usarse para mostrar problemas de compilación.
La plantilla también incluye su propia CI preconfigurada con GitHub Actions, lo que ayudará a detectar cualquier problema de compilación que puedas tener.
Para usar esta plantilla:
-
Haz clic en el botón Use this template en GitHub para crear un nuevo proyecto a partir de la plantilla.
-
Clona tu repositorio recién creado localmente.
-
Aplica las modificaciones necesarias para reproducir tu problema.
-
Adjunta el enlace de tu repositorio al nuevo informe de error que estás creando.