Ir al contenido

Gestion des dépendances et PNPM

Bonnes pratiques en matière de gestion de paquets, installation de dépendances natives et pourquoi PNPM est infiniment supérieur et plus sûr que NPM dans React Native.

0vues

Ce guide aborde de manière exhaustive les méthodologies correctes pour l'installation, la mise à jour et l'intégration de dépendances dans des projets de React Native en utilisant PNPM, détaillant également pourquoi c'est l'option optimale face au gestionnaire de paquets traditionnel NPM.


1. Pourquoi PNPM est-il bien supérieur à NPM ?

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

Historiquement, NPM a entraîné de graves problèmes d'architecture qui affectent directement la sécurité, la stabilité et les performances des projets de développement :

  1. Dépendances fantômes (Phantom Dependencies) :
    • Le Problème : NPM utilise un arbre de dépendances plat (flat node_modules). Si vous installez le paquet A, et que celui-ci nécessite en interne le paquet B, NPM place B directement à la racine de node_modules.
    • Le risque de sécurité : Votre code peut effectuer import de B directement sans le déclarer formellement dans votre package.json. Si, à l'avenir, vous mettez à jour A et qu'il ne dépend plus de B, votre code se cassera de manière inattendue en production. De plus, cela ouvre la porte à des attaques de la chaîne d'approvisionnement (Supply Chain Attacks) où un code malveillant accède par inadvertance à des paquets plats non déclarés.
  2. Duplication de fichiers et blocage du disque :
    • NPM télécharge des copies physiques redondantes des mêmes paquets dans chaque projet local de votre machine, remplissant votre disque dur de gigaoctets de code inutile.
  3. Lenteur excessive :
    • Le processus de résolution de l'arbre plat nécessite de recalculer et d'indexer des milliers de dossiers à chaque installation, ralentissant la vitesse de vos flux d'intégration et de déploiement continus (CI/CD).

La Solution de PNPM : Innovation en Structure et Sécurité

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

PNPM (Performant NPM) résout ces problèmes grâce à une approche complètement révolutionnaire :

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"]
  • Structure non plate de node_modules :
    • PNPM crée des liens symboliques (symlinks). Seuls les paquets explicitement déclarés dans votre package.json sont accessibles à la racine de node_modules. Il est physiquement impossible d'importer des paquets fantômes non déclarés, annulant ainsi ce vecteur d'attaque.
  • Stockage adressable par contenu (Global Store) :
    • Tous les paquets sont téléchargés une seule fois dans un répertoire global du système. Dans vos projets, des liens physiques (hard links) sont créés vers ce magasin unique. Vous économisez jusqu'à 90 % d'espace disque !
  • Vitesse supérieure :
    • Étant donné qu'il ne copie pas de fichiers physiquement et lit du cache global, les installations avec PNPM sont jusqu'à 3 fois plus rapides qu'avec NPM.

2. Tableau Comparatif des Fonctionnalités

Sección titulada «2. Tabla Comparativa de Características»
FonctionnalitéNPMYarn (Classic)PNPM
Prévention des dépendances fantômes✕ Non✕ Non✓ Oui (Par conception)
Espace disque efficace✕ Non (Copie physique)✕ Non (Copie physique)✓ Oui (Liens physiques globaux)
Vitesse d'installationLenteMoyenneUltra rapide
Sécurité de liaisonFaible (Arbre plat)Faible (Arbre plat)Haute (Structure stricte)

3. Intégration des Dépendances avec PNPM et Expo

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

Étant donné que React Native contient du code compilé pour les plateformes mobiles natives, l'installation des modules doit se faire de manière coordonnée :

Commande Recommandée

Pour tout paquet contenant des modules natifs, utilisez toujours pnpm expo install au lieu de commandes d'installation brutes.

Lors de l'exécution de pnpm expo install <paquete> :

  1. Expo vérifie la version exacte certifiée et compatible avec la version active de votre SDK.
  2. PNPM effectue une installation ultra-rapide en résolvant de manière sécurisée la structure de liaison physique dans 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

Une fois les paquets installés avec PNPM, l'intégration avec les dossiers natifs de Gradle (Android) et CocoaPods (iOS) s'exécute naturellement :

Ventana de terminal
# Compilar binarios de desarrollo nativos integrando las dependencias instaladas
pnpm expo run:android
pnpm expo run:ios
  • pnpm dlx expo-doctor: Diagnostique et valide la santé globale du SDK et des dépendances natives du projet.
  • pnpm expo install --fix: Résout automatiquement et immédiatement toute version désalignée dans votre arbre de dépendances, en forçant l'alignement sur la version recommandée d'Expo.