Ir al contenido

Správa závislostí a PNPM

Nejlepší postupy při správě balíčků, instalaci nativních závislostí a proč je PNPM v React Native nekonečně lepší a bezpečnější než NPM.

0čtení

Tento průvodce komplexně popisuje správné metodologie pro instalaci, aktualizaci a integraci závislostí v projektech React Native pomocí PNPM, podrobně vysvětluje, proč je tato možnost optimální oproti tradičnímu správci balíčků NPM.


Historicky, NPM trpěl vážnými architektonickými problémy, které přímo ovlivňovaly bezpečnost, stabilitu a výkon vývojových projektů:

  1. Fantomové Závislosti (Phantom Dependencies):
    • Problém: NPM používá plochý strom závislostí (flat node_modules). Pokud nainstalujete balíček A a ten interně vyžaduje balíček B, NPM umístí B přímo do kořene node_modules.
    • Bezpečnostní Riziko: Váš kód může provádět import z B přímo bez formálního deklarování v package.json. Pokud v budoucnu aktualizujete A a přestane záviset na B, váš kód se nečekaně rozbije ve výrobním prostředí. Kromě toho to otevírá dveře k útokům na řetězce dodávek (Supply Chain Attacks), kdy škodlivý kód nečekaně získá přístup k nezadaným plochým balíčkům.
  2. Duplikace Souborů a Zámek Disku:
    • NPM stahuje redundantní fyzické kopie stejných balíčků do každého lokálního projektu na vašem počítači, čímž zaplňuje váš pevný disk gigabajty zbytečného kódu.
  3. Nadměrnou Pomalostí:
    • Proces řešení plochého stromu vyžaduje přepočítání a indexování tisíců složek při každé instalaci, což zpomaluje rychlost vašich procesů kontinuální integrace a nasazení (CI/CD).

PNPM (Performant NPM) řeší tyto problémy zcela revolučním přístupem:

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"]
  • Neplochou Strukturou node_modules:
    • PNPM vytváří symbolické odkazy (symlinks). Pouze balíčky výslovně deklarované ve vašem package.json jsou přístupné v kořenu node_modules. Je fyzicky nemožné importovat nedeklarované „phantom“ balíčky, čímž se eliminuje tento vektor útoku.
  • Adresovatelným Úložištěm Obsahu (Global Store):
    • Všechny balíčky se stahují pouze jednou do globální systémové složky. Ve vašich projektech se vytvářejí pevnopřídavné odkazy (hard links) na toto jediné úložiště. Ušetříte až 90 % diskového prostoru!
  • Vyšší Rychlostí:
    • Vzhledem k tomu, že nekopíruje fyzicky soubory a čte z globálního cache, instalace s PNPM jsou až 3krát rychlejší než s NPM.

FunkceNPMYarn (Classic)PNPM
Prevence phantomních závislostí✕ Ne✕ Ne✓ Ano (V návrhu)
Efektivní využití diskového prostoru✕ Ne (Fyzická kopie)✕ Ne (Fyzická kopie)✓ Ano (Globální tvrdé odkazy)
Rychlost instalacePomaláStředníUltra rychlá
Zabezpečení spojeníNízká (Plochý strom)Nízká (Plochý strom)Vysoká (Přísná struktura)

Vzhledem k tomu, že React Native obsahuje zkompilovaný kód pro nativní mobilní platformy, instalace modulů musí probíhat koordinovaně:

Doporučený příkaz

Pro jakýkoli balíček obsahující nativní moduly vždy používejte pnpm expo install místo surových instalačních příkazů.

Při spuštění pnpm expo install <paquete>:

  1. Expo ověří přesnou certifikovanou verzi, která je kompatibilní s aktivní verzí vašeho SDK.
  2. PNPM provádí ultrarychlou instalaci bezpečným vyřešením fyzické struktury propojení v 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

Jakmile jsou balíčky nainstalovány pomocí PNPM, integrace s nativními složkami Gradle (Android) a CocoaPods (iOS) proběhne přirozeně:

Ventana de terminal
# Compilar binarios de desarrollo nativos integrando las dependencias instaladas
pnpm expo run:android
pnpm expo run:ios
  • pnpm dlx expo-doctor: Diagnostikuje a validuje celkové zdraví SDK a nativních závislostí projektu.
  • pnpm expo install --fix: Automaticky a okamžitě řeší jakékoli nekonzistentní verze ve vašem stromu závislostí tím, že je vynutí sladit s doporučenou verzí Expo.