Ir al contenido

Správa závislostí a PNPM

Dobré postupy v správe balíkov, inštalácia natívnych závislostí a prečo je PNPM nekonečne lepšie a bezpečnejšie ako NPM v React Native.

0lecturas

Táto príručka komplexne pokrýva správne metodológie pre inštaláciu, aktualizáciu a integráciu závislostí v projektoch React Native pomocou PNPM, podrobne vysvetľuje prečo je to optimálna voľba oproti tradičnému balíčkovému manažérovi NPM.


Historicky NPM trpel vážnymi architektonickými problémami, ktoré priamo ovplyvňovali bezpečnosť, stabilitu a výkon vývojových projektov:

  1. Dependencias Fantasma (Phantom Dependencies):
    • Problém: NPM používa plochý strom závislostí. Ak nainštalujete balíček, a tento vyžaduje interný balíček, NPM umiestni tento balíček priamo do koreňa projektu.
    • Riziko bezpečnosti: Váš kód môže využívať tento balíček priamo bez jeho formálneho deklarovania vo vašom projekte. Ak v budúcnosti aktualizujete balíček a prestane závisieť od tohto balíčka, váš kód sa neočakávane zlomí vo výrobe. Okrem toho to otvára dvere pre útoky na dodávateľský reťazec, kde škodlivý kód získava prístup k neohláseným plochým balíčkom.
  2. Duplicación de Archivos y Bloqueo de Disco:
    • NPM sťahuje fyzické redundantné kópie rovnakých balíkov do každého lokálneho projektu vo vašom počítači, čím zapĺňa váš pevný disk gigabajtmi nepotrebného kódu.
  3. Lentitud Excesiva:
    • Proces rozlíšenia plochého stromu vyžaduje prepočet a indexovanie tisícov priečinkov pri každej inštalácii, čo spomaľuje rýchlosť vašich kontinuálnych integračných a nasadených pracovných postupov (CI/CD).

Riešenie PNPM: Inovácia v štruktúre a bezpečnosti

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

PNPM (Performant NPM) rieši tieto problémy pomocou úplne nového prístupu:

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 vytvára symbolické odkazy. Iba explicitne deklarované balíčky vo vašom súbore sú dostupné v koreňovom adresári. Fyzicky nie je možné importovať neohlásené fantómové balíčky, čím sa eliminuje tento vektor útoku.
  • Almacenamiento Direccionable por Contenido (Global Store):
    • Všetky balíčky sa sťahujú jediný raz do globálneho adresára systému. Vo vašich projektoch sa vytvárajú fyzické odkazy na toto jediné úložisko. Šetríte až 90% miesta na disku!
  • Velocidad Superior:
    • Pretože nekopíruje fyzické súbory a číta z globálnej cache, inštalácie s PNPM sú až 3 krát rýchlejšie ako s NPM.

CharakteristikaNPMYarn (Classic)PNPM
Prevencia fantómových závislostí✕ Nie✕ Nie✓ Áno (Podľa návrhu)
Efektívne využitie miesta na disku✕ Nie (Fyzická kópia)✕ Nie (Fyzická kópia)✓ Áno (Globálne fyzické odkazy)
Rýchlosť inštaláciePomaláMediálnaUltra rýchla
Bezpečnosť odkazovNízka (Plochý strom)Nízka (Plochý strom)Vysoká (Prísna štruktúra)

Pretože React Native obsahuje kompilovaný kód pre natívne mobilné platformy, inštalácia modulov musí byť koordinovaná:

Odporúčaný príkaz

Pre akýkoľvek balík obsahujúci natívne moduly vždy používajte pnpm expo install namiesto surových inštalačných príkazov.

Al ejecutar pnpm expo install <paquete>:

  1. Expo overuje presnú verziu, ktorá je certifikovaná a kompatibilná s aktívnou verziou vášho SDK.
  2. PNPM vykonáva ultra rýchlu inštaláciu bezpečne rieši fyzickú štruktúru prepojenia 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

Po nainštalovaní balíkov s PNPM sa integrácia s natívnymi priečinkami Gradle (Android) a CocoaPods (iOS) vykonáva prirodzene:

Ventana de terminal
# Compilar binarios de desarrollo nativos integrando las dependencias instaladas
pnpm expo run:android
pnpm expo run:ios

Ú полезные diagnostické príkazy

Sección titulada «Comandos de Diagnóstico Útiles»
  • pnpm dlx expo-doctor: Diagnostikuje a overuje všeobecný stav SDK a natívnych závislostí projektu.
  • pnpm expo install --fix: Automaticky a okamžite rieši akúkoľvek nesprávnu verziu vo vašom strome závislostí, čím je vynútená odporúčaná verzia Expo.