Ir al contenido

Gestió de dependències i PNPM

Bones pràctiques en la gestió de paquets, instal·lació de dependències natives i per què PNPM és infinitament superior i més segur que NPM en React Native.

0lectures

Aquesta guia aborda de manera exhaustiva les metodologies correctes per a la instal·lació, actualització i integració de dependències en projectes de React Native utilitzant PNPM, detallant a més per què és l'opció òptima davant el gestor de paquets tradicional NPM.


Històricament, NPM ha arrossegat greus problemes arquitectònics que afecten directament la seguretat, l'estabilitat i el rendiment dels projectes de desenvolupament:

  1. Dependències Fantasma (Phantom Dependencies):
    • El Problema: NPM utilitza un arbre de dependències pla (flat node_modules). Si instal·les el paquet A, i aquest requereix internament el paquet B, NPM col·loca B directament a la rac de node_modules.
    • El Risc de Seguretat: El teu codi pot fer import de B directament sense declarar-ho formalment en el teu package.json. Si en el futur actualitzes A i deixa de dependre de B, el teu codi es trencarà en producció de manera inesperada. A més, obre la porta a atacs de cadena de subministrament (Supply Chain Attacks) on codi maliciós accedeix de manera inadvertida a paquets plans no declarats.
  2. Duplicació d'Arxius i Bloqueig de Disc:
    • NPM descarrega còpies físiques redundants dels mateixos paquets en cada projecte local de la teva màquina, omplint el teu disc dur amb gigabytes de codi innecesari.
  3. Lentitud Excessiva:
    • El procés de resolució de l'arbre pla requereix recalculcar i indexar milers de carpetes en cada instal·lació, ralentitzant la velocitat dels teus fluxos d'integració i desplegament continu (CI/CD).

La Solució de PNPM: Innovació en Estructura i Seguretat

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

PNPM (Performant NPM) resol aquests problemes mitjançant un enfocament completament revolucionari:

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 enllaços simbòlics (symlinks). Només els paquets declarats explícitament en el teu package.json són accessibles a la rac de node_modules. És físicament impossible importar paquets fantasma no declarats, anul·lant aquest vector d'atac.
  • Emmagatzematge Direccionable per Contingut (Global Store):
    • Tots els paquets es descarreguen una sola vegada en un directori global del sistema. Els teus projectes creen enllaços físics (hard links) cap a aquest únic magatzem. Estalvies fins a un 90% d'espai de disc!
  • Velocitat Superior:
    • Com que no copia fitxers físicament i llegeix del caché global, les instal·lacions amb PNPM són fins a 3 vegades més ràpides que amb NPM.

CaracterísticaNPMYarn (Classic)PNPM
Prevenció de dependències fantasma✕ No✕ No✓ Sí (Per disseny)
Espai de disc eficient✕ No (Còpia física)✕ No (Còpia física)✓ Sí (Hard links globals)
Velocitat d'instal·lacióLentaMitjanaUltra ràpida
Seguretat de l'enllaçBaixa (Àrbre pla)Baixa (Àrbre pla)Alta (Estructura estricta)

3. Integració de dependències amb PNPM i Expo

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

Com React Native conté codi compilat per a plataformes mòbils natives, la instal·lació de mòduls s'ha de fer de manera coordinada:

Comanda recomanada

Per a qualsevol paquet que contenga mòduls natives, utilitza sempre pnpm expo install en lloc de comandes d'instal·lació raw.

Al ejecutar pnpm expo install <paquete>:

  1. Expo verifica la versió exacta certificada i compatible amb la versió activa del teu SDK.
  2. PNPM realitza la instal·lació ultra ràpida resolent de manera segura l'estructura física d'enllaç 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

Un cop instal·lats els paquets amb PNPM, la integració amb les carpetes natives de Gradle (Android) i CocoaPods (iOS) s'executa de manera 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 i valida la salut general de l'SDK i de les dependències natives del projecte.
  • pnpm expo install --fix: Resold de manera automàtica i immediata qualsevol versió desalineada en l'arbre de dependències, forçant l'alineació amb la release recomanada d'Expo.