Vinculación 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 →

No todas las aplicaciones usan todas las capacidades nativas, e incluir el código para soportar todas esas funciones afectaría el tamaño binario... Pero aún queremos permitir añadir estas funciones cuando las necesites.

Con esto en mente, hemos expuesto muchas de estas funciones como bibliotecas estáticas independientes.

Para la mayoría de las bibliotecas será tan simple como arrastrar dos archivos; a veces será necesario un tercer paso, pero no más que eso.

nota

Todas las bibliotecas que incluimos con React Native están en la carpeta Libraries en la raíz del repositorio. Algunas son JavaScript puro y solo necesitas hacer require de ellas. Otras bibliotecas también dependen de código nativo; en ese caso, tendrás que añadir estos archivos a tu aplicación, de lo contrario la aplicación lanzará un error al intentar usar la biblioteca.

Estos son los pasos para vincular tus bibliotecas con código nativo

Vinculación automática

Instala una biblioteca con dependencias nativas:

shell

npm install <library-with-native-dependencies> --save

información

La bandera --save o --save-dev es crucial en este paso. React Native vinculará tus bibliotecas basándose en las dependencies y devDependencies de tu archivo package.json.

¡Eso es todo! La próxima vez que construyas tu aplicación, el código nativo se vinculará gracias al mecanismo de autolinking.

Vinculación manual

Paso 1

Si la biblioteca tiene código nativo, debe haber un archivo .xcodeproj dentro de su carpeta. Arrastra este archivo a tu proyecto en Xcode (generalmente bajo el grupo Libraries);

Paso 2

Haz clic en tu archivo de proyecto principal (el que representa el .xcodeproj), selecciona Build Phases y arrastra la biblioteca estática desde la carpeta Products dentro de la biblioteca que estás importando a Link Binary With Libraries.

Paso 3

No todas las bibliotecas requerirán este paso; lo que debes considerar es:

¿Necesito conocer el contenido de la biblioteca en tiempo de compilación?

Esto significa: ¿estás usando esta biblioteca en el lado nativo o solo en JavaScript? Si solo la usas en JavaScript, ¡estás listo!

Si necesitas llamarla desde código nativo, entonces necesitamos conocer los encabezados de la biblioteca. Para lograrlo, ve al archivo de tu proyecto, selecciona Build Settings y busca Header Search Paths. Allí debes incluir la ruta a tu biblioteca. (Esta documentación solía recomendar usar recursive, pero ya no se recomienda, ya que puede causar fallos de compilación sutiles, especialmente con CocoaPods.)