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.
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.
1. Per què PNPM és molt superior a NPM?
Sección titulada «1. ¿Por qué PNPM es muy superior a NPM?»Històricament, NPM ha arrossegat greus problemes arquitectònics que afecten directament la seguretat, l'estabilitat i el rendiment dels projectes de desenvolupament:
Els errors crítics de NPM
Sección titulada «Los Fallos Críticos de NPM»- Dependències Fantasma (Phantom Dependencies):
- El Problema: NPM utilitza un arbre de dependències pla (
flat node_modules). Si instal·les el paquetA, i aquest requereix internament el paquetB, NPM col·locaBdirectament a la rac denode_modules. - El Risc de Seguretat: El teu codi pot fer
importdeBdirectament sense declarar-ho formalment en el teupackage.json. Si en el futur actualitzesAi deixa de dependre deB, 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.
- El Problema: NPM utilitza un arbre de dependències pla (
- 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.
- 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.jsonsón accessibles a la rac denode_modules. És físicament impossible importar paquets fantasma no declarats, anul·lant aquest vector d'atac.
- PNPM crea enllaços simbòlics (symlinks). Només els paquets declarats explícitament en el teu
- 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.
2. Taula Comparativa de Característiques
Sección titulada «2. Tabla Comparativa de Características»| Característica | NPM | Yarn (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ó | Lenta | Mitjana | Ultra 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>:
- Expo verifica la versió exacta certificada i compatible amb la versió activa del teu SDK.
- PNPM realitza la instal·lació ultra ràpida resolent de manera segura l'estructura física d'enllaç en
node_modules/.pnpm/.
Exemple pràctic d'instal·lació
Sección titulada «Ejemplo Práctico de Instalación»# Instalar iconos vectoriales y almacenamiento asíncrono nativo de forma segurapnpm expo install lucide-react-native @react-native-async-storage/async-storage4. Compilació i integració nativa
Sección titulada «4. Compilación e Integración Nativa»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:
# Compilar binarios de desarrollo nativos integrando las dependencias instaladaspnpm expo run:androidpnpm expo run:iosComandes de diagnòstic útils
Sección titulada «Comandos de Diagnóstico Útiles»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.

