Ir al contenido

Gestione delle dipendenze e PNPM

Best practice nella gestione dei pacchetti, installazione delle dipendenze native e perché PNPM è infinitamente superiore e più sicuro di NPM in React Native.

0letture

Questa guida affronta in modo esaustivo le metodologie corrette per l'installazione, l'aggiornamento e l'integrazione delle dipendenze nei progetti di React Native utilizzando PNPM, dettagliando inoltre perché è l'opzione ottimale rispetto al gestore di pacchetti tradizionale NPM.


1. Perché PNPM è di gran lunga superiore a NPM?

Sección titulada «1. ¿Por qué PNPM es muy superior a NPM?»

Storicamente, NPM ha comportato gravi problemi architettonici che influenzano direttamente la sicurezza, la stabilità e le prestazioni dei progetti di sviluppo:

  1. Dipendenze Fantasma (Phantom Dependencies):
    • Il Problema: NPM utilizza un albero di dipendenze piatto (flat node_modules). Se installi il pacchetto A, e questo richiede internamente il pacchetto B, NPM posiziona B direttamente nella radice di node_modules.
    • Il Rischio di Sicurezza: Il tuo codice può eseguire import di B direttamente senza dichiararlo formalmente nel tuo package.json. Se in futuro aggiorni A e questo smette di dipendere da B, il tuo codice si romperà in produzione in modo imprevisto. Inoltre, apre la porta ad attacchi della supply chain (Supply Chain Attacks) in cui codice malevolo accede inavvertitamente a pacchetti piatti non dichiarati.
  2. Duplicazione di File e Blocco del Disco:
    • NPM scarica copie fisiche ridondanti degli stessi pacchetti in ogni progetto locale della tua macchina, riempiendo il tuo disco rigido con gigabyte di codice non necessario.
  3. Lentitudine Eccessiva:
    • Il processo di risoluzione dell'albero piatto richiede il ricalcolo e l'indicizzazione di migliaia di cartelle a ogni installazione, rallentando la velocità dei tuoi flussi di integrazione e distribuzione continua (CI/CD).

La soluzione di PNPM: Innovazione in struttura e sicurezza

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

PNPM (Performant NPM) risolve questi problemi attraverso un approccio completamente rivoluzionario:

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"]
  • Struttura Non Piana di node_modules:
    • PNPM crea collegamenti simbolici (symlinks). Solo i pacchetti dichiarati esplicitamente nel tuo package.json sono accessibili nella radice di node_modules. È fisicamente impossibile importare pacchetti fantasma non dichiarati, annullando questo vettore di attacco.
  • Archiviazione Direzionabile per Contenuto (Global Store):
    • Tutti i pacchetti vengono scaricati una sola volta in una directory globale del sistema. Nei tuoi progetti vengono creati collegamenti fisici (hard links) verso quell'unico store. Risparmi fino al 90% di spazio su disco!
  • Velocità Superiore:
    • Poiché non copia fisicamente i file e legge dalla cache globale, le installazioni con PNPM sono fino a 3 volte più veloci rispetto a NPM.

2. Tabella comparativa delle caratteristiche

Sección titulada «2. Tabla Comparativa de Características»
CaratteristicaNPMYarn (Classic)PNPM
Prevenzione delle Dipendenze Fantasma✕ No✕ No✓ Sì (Per design)
Spazio disco efficiente✕ No (Copia fisica)✕ No (Copia fisica)✓ Sì (Hard Link globali)
LentaMediaUltra Rapida
Sicurezza del collegamentoBassa (Albero piatto)Bassa (Albero piatto)

3. Integrazione delle Dipendenze con PNPM ed Expo

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

Poiché React Native contiene codice compilato per piattaforme mobili native, l'installazione dei moduli deve essere eseguita in modo coordinato:

Comando Consigliato

Per ogni pacchetto che contenga moduli nativi, utilizza sempre pnpm expo install invece di comandi di installazione raw.

Eseguendo pnpm expo install <paquete>:

  1. Expo verifica la versione esatta certificata e compatibile con la versione attiva del tuo SDK.
  2. PNPM esegue un'installazione ultra-rapida risolvendo in modo sicuro la struttura fisica di collegamento in 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 volta installati i pacchetti con PNPM, l'integrazione con le cartelle native di Gradle (Android) e CocoaPods (iOS) viene eseguita in modo naturale:

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 e valida lo stato di salute generale dell'SDK e delle dipendenze native del progetto.
  • pnpm expo install --fix: Risolve in modo automatico e immediato qualsiasi versione disallineata nell'albero delle dipendenze, forzando l'allineamento alla release raccomandata di Expo.