Ir al contenido

Gestión de Dependencias y PNPM

Buenas prácticas en la gestión de paquetes, instalación de dependencias nativas y por qué PNPM es infinitamente superior y más seguro que NPM en React Native.

0lecturas

Esta guía aborda de forma exhaustiva las metodologías correctas para la instalación, actualización e integración de dependencias en proyectos de React Native utilizando PNPM, detallando además por qué es la opción óptima frente al gestor de paquetes tradicional NPM.


Históricamente, NPM ha arrastrado graves problemas arquitectónicos que afectan directamente a la seguridad, estabilidad y rendimiento de los proyectos de desarrollo:

  1. Dependencias Fantasma (Phantom Dependencies):
    • El Problema: NPM utiliza un árbol de dependencias plano (flat node_modules). Si instalas el paquete A, y este requiere internamente el paquete B, NPM coloca a B directamente en la raíz de node_modules.
    • El Riesgo de Seguridad: Tu código puede hacer import de B directamente sin declararlo formalmente en tu package.json. Si en el futuro actualizas A y deja de depender de B, tu código se romperá en producción de forma inesperada. Además, abre la puerta a ataques de cadena de suministro (Supply Chain Attacks) donde código malicioso accede de forma inadvertida a paquetes planos no declarados.
  2. Duplicación de Archivos y Bloqueo de Disco:
    • NPM descarga copias físicas redundantes de los mismos paquetes en cada proyecto local de tu máquina, llenando tu disco duro con gigabytes de código innecesario.
  3. Lentitud Excesiva:
    • El proceso de resolución del árbol plano requiere re-calcular e indexar miles de carpetas en cada instalación, ralentizando la velocidad de tus flujos de integración y despliegue continuo (CI/CD).

La Solución de PNPM: Innovación en Estructura y Seguridad

Sección titulada «La Solución de PNPM: Innovación en Estructura y Seguridad»

PNPM (Performant NPM) resuelve estos problemas mediante un enfoque completamente revolucionario:

graph TD
A[Almacén Central de PNPM en Disco] -->|Enlace Físico / Hard Link| B["mi-proyecto/node_modules/.pnpm"]
B -->|Enlaces Simbólicos / Symlinks| C["Dependencias Declaradas strictly en package.json"]
  • Estructura No Plana de node_modules:
    • PNPM crea enlaces simbólicos (symlinks). Solo los paquetes declarados explícitamente en tu package.json son accesibles en la raíz de node_modules. Es físicamente imposible importar paquetes fantasma no declarados, anulando este vector de ataque.
  • Almacenamiento Direccionable por Contenido (Global Store):
    • Todos los paquetes se descargan una sola vez en un directorio global del sistema. En tus proyectos se crean enlaces físicos (hard links) hacia ese único almacén. ¡Ahorras hasta un 90% de espacio de disco!
  • Velocidad Superior:
    • Dado que no copia archivos físicamente y lee del caché global, las instalaciones con PNPM son hasta 3 veces más rápidas que con NPM.

CaracterísticaNPMYarn (Classic)PNPM
Prevención de Dependencias Fantasma✕ No✕ No✓ Sí (Por diseño)
Espacio de Disco Eficiente✕ No (Copia física)✕ No (Copia física)✓ Sí (Hard Links globales)
Velocidad de InstalaciónLentaMediaUltra Rápida
Seguridad de EnlaceBaja (Árbol plano)Baja (Árbol plano)Alta (Estructura estricta)

3. Integración de Dependencias con PNPM y Expo

Sección titulada «3. Integración de Dependencias con PNPM y Expo»

Debido a que React Native contiene código compilado para plataformas móviles nativas, la instalación de módulos debe hacerse coordinadamente:

Comando Recomendado

Para cualquier paquete que contenga módulos nativos, utiliza siempre pnpm expo install en lugar de comandos de instalación raw.

Al ejecutar pnpm expo install <paquete>:

  1. Expo verifica la versión exacta certificada y compatible con la versión activa de tu SDK.
  2. PNPM realiza la instalación ultra rápida resolviendo de forma segura la estructura física de enlazado en node_modules/.pnpm/.
Ventana de terminal
# Instalar iconos vectoriales y almacenamiento asíncrono nativo de forma segura
pnpm expo install lucide-react-native @react-native-async-storage/async-storage

Una vez instalados los paquetes con PNPM, la integración con las carpetas nativas de Gradle (Android) y CocoaPods (iOS) se ejecuta de forma natural:

Ventana de terminal
# Compilar binarios de desarrollo nativos integrando las dependencias instaladas
pnpm expo run:android
pnpm expo run:ios
  • pnpm dlx expo-doctor: Diagnostica y valida la salud general del SDK y de las dependencias nativas del proyecto.
  • pnpm expo install --fix: Resuelve de forma automática e inmediata cualquier versión desalineada en tu árbol de dependencias, forzando a alinearse a la release recomendada de Expo.