Saltar al contenido principal
Versión: 0.79

Uso de bibliotecas

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 →

React Native proporciona un conjunto de Componentes y APIs principales listos para usar en tu aplicación. No estás limitado a los componentes y APIs incluidos con React Native. React Native cuenta con una comunidad de miles de desarrolladores. Si los Componentes y APIs principales no ofrecen lo que necesitas, puedes buscar e instalar una biblioteca de la comunidad para agregar esa funcionalidad a tu aplicación.

Selección de un gestor de paquetes​

Las bibliotecas de React Native normalmente se instalan desde el registro npm usando un gestor de paquetes de Node.js como npm CLI o Yarn Classic.

Si tienes Node.js instalado en tu computadora, ya tienes npm CLI instalado. Algunos desarrolladores prefieren usar Yarn Classic por sus tiempos de instalación ligeramente más rápidos y funciones avanzadas adicionales como Workspaces. Ambas herramientas funcionan excelente con React Native. Para simplificar la explicación, asumiremos que usas npm en el resto de esta guía.

💡 Los términos "biblioteca" y "paquete" se usan indistintamente en la comunidad JavaScript.

Instalación de una biblioteca​

Para instalar una biblioteca en tu proyecto, navega al directorio de tu proyecto en la terminal y ejecuta el comando de instalación. Probemos con react-native-webview:

shell
npm install react-native-webview

La biblioteca que instalamos incluye código nativo, y necesitamos vincularlo a nuestra aplicación antes de usarlo.

Vinculación de código nativo en iOS​

React Native utiliza CocoaPods para gestionar las dependencias del proyecto iOS, y la mayoría de las bibliotecas de React Native siguen esta misma convención. Si una biblioteca que estás usando no lo hace, consulta su README para obtener instrucciones adicionales. En la mayoría de los casos, aplicarán las siguientes instrucciones.

Ejecuta pod install en nuestro directorio ios para vincularlo a nuestro proyecto nativo de iOS. Un atajo para hacer esto sin cambiar al directorio ios es ejecutar npx pod-install.

bash
npx pod-install

Una vez completado esto, vuelve a compilar el binario de la aplicación para comenzar a usar tu nueva biblioteca:

shell
npm run ios

Vinculación de código nativo en Android​

React Native utiliza Gradle para gestionar las dependencias del proyecto Android. Después de instalar una biblioteca con dependencias nativas, deberás volver a compilar el binario de la aplicación para usar tu nueva biblioteca:

shell
npm run android

Búsqueda de bibliotecas​

React Native Directory es una base de datos buscable de bibliotecas creadas específicamente para React Native. Este es el primer lugar donde buscar una biblioteca para tu aplicación de React Native.

Muchas de las bibliotecas que encontrarás en el directorio provienen de React Native Community o Expo.

Las bibliotecas creadas por React Native Community son impulsadas por voluntarios e individuos de empresas que dependen de React Native. Suelen admitir iOS, tvOS, Android y Windows, pero esto varía entre proyectos. Muchas bibliotecas en esta organización fueron alguna vez Componentes y APIs principales de React Native.

Las bibliotecas creadas por Expo están escritas en TypeScript y admiten iOS, Android y react-native-web siempre que sea posible.

Después de React Native Directory, el registro npm es el siguiente mejor lugar si no encuentras una biblioteca específica para React Native en el directorio. El registro npm es la fuente definitiva de bibliotecas JavaScript, pero las bibliotecas que enumera pueden no ser todas compatibles con React Native. React Native es uno de los muchos entornos de programación JavaScript, que incluyen Node.js, navegadores web, Electron y más, y npm incluye bibliotecas que funcionan para todos estos entornos.

Determinación de la compatibilidad de bibliotecas​

¿Funciona con React Native?​

Por lo general, las bibliotecas creadas específicamente para otras plataformas no funcionarán con React Native. Ejemplos incluyen react-select (diseñada para web y específicamente para react-dom) y rimraf (creada para Node.js que interactúa con tu sistema de archivos). Otras bibliotecas como lodash usan únicamente funciones de JavaScript y funcionan en cualquier entorno. Con el tiempo desarrollarás intuición para esto, pero mientras tanto la forma más sencilla de comprobarlo es probarlo tú mismo. Puedes eliminar paquetes usando npm uninstall si resulta incompatible con React Native.

¿Funciona con las plataformas que soporta mi aplicación?​

React Native Directory te permite filtrar por compatibilidad de plataformas como iOS, Android, Web y Windows. Si la biblioteca que deseas usar no aparece allí, consulta su archivo README para obtener más información.

¿Funciona con la versión de React Native de mi aplicación?​

La versión más reciente de una biblioteca suele ser compatible con la última versión de React Native. Si usas una versión anterior, consulta el README para saber qué versión de la biblioteca instalar. Puedes instalar una versión específica ejecutando npm install <library-name>@<version-number>, por ejemplo: npm install @react-native-community/netinfo@^2.0.0.