Introducción a los Módulos Nativos
Esta página fue traducida por PageTurner AI (beta). No está respaldada oficialmente por el proyecto. ¿Encontraste un error? Reportar problema →
Esta página fue traducida por PageTurner AI (beta). No está respaldada oficialmente por el proyecto. ¿Encontraste un error? Reportar problema →
Native Module y Native Components son nuestras tecnologías estables utilizadas por la arquitectura heredada. Serán desaprobadas en el futuro cuando la Nueva Arquitectura sea estable. La Nueva Arquitectura utiliza Turbo Native Module y Fabric Native Components para lograr resultados similares.
A veces, una aplicación de React Native necesita acceder a una API nativa de plataforma que no está disponible por defecto en JavaScript, como las APIs nativas para Apple Pay o Google Pay. Tal vez quieras reutilizar algunas bibliotecas existentes de Objective-C, Swift, Java o C++ sin tener que reimplementarlas en JavaScript, o escribir código de alto rendimiento y multihilo para tareas como procesamiento de imágenes.
El sistema NativeModule expone instancias de clases nativas (Java/Objective-C/C++) a JavaScript como objetos JS, permitiéndote ejecutar código nativo arbitrario desde JS. Aunque no esperamos que esta característica sea parte del flujo de desarrollo habitual, es esencial que exista. Si React Native no exporta una API nativa que tu aplicación JS necesita, ¡deberías poder exportarla tú mismo!
Configuración de Módulos Nativos
Existen diferentes formas de escribir un módulo nativo para tu aplicación React Native:
-
Creando una biblioteca local que se pueda importar en tu aplicación React Native. Lee la guía Creación de bibliotecas locales para más información.
-
Directamente dentro de los proyectos iOS/Android de tu aplicación React Native
-
Como un paquete NPM que se pueda instalar como dependencia en tus/otras aplicaciones React Native.
Esta guía primero te mostrará cómo implementar un módulo nativo directamente dentro de una aplicación React Native. Sin embargo, el módulo nativo que construyas en esta guía puede distribuirse como paquete NPM. Consulta la guía Configurar un Módulo Nativo como Paquete NPM si te interesa hacerlo.
Comenzando
En las siguientes secciones te guiaremos paso a paso para construir un módulo nativo directamente dentro de una aplicación React Native. Como requisito previo, necesitarás una aplicación React Native para trabajar. Puedes seguir los pasos aquí para configurar una aplicación React Native si aún no tienes una.
Imagina que quieres acceder a las APIs de calendario nativas de iOS/Android desde JavaScript dentro de una aplicación React Native para crear eventos de calendario. React Native no expone una API de JavaScript para comunicarse con las bibliotecas de calendario nativas. Sin embargo, mediante módulos nativos, puedes escribir código nativo que se comunique con las APIs de calendario nativas. Luego podrás invocar ese código nativo a través de JavaScript en tu aplicación React Native.
En las siguientes secciones crearás un módulo nativo de Calendario para Android e iOS.