Ir al contenido

Zarządzanie Zależnościami i PNPM

Dobrze praktyki w zarządzaniu pakietami, instalacja zależności natywnych i dlaczego PNPM jest nieskończenie lepszy i bezpieczniejszy niż NPM w React Native.

0odwiedzin

Ten przewodnik wyczerpująco omawia poprawne metody instalacji, aktualizacji i integracji zależności w projektach React Native przy użyciu PNPM, szczegółowo wyjaśniając, dlaczego jest to optymalny wybór w porównaniu z tradycyjnym menedżerem pakietów NPM.


1. Dlaczego PNPM jest znacznie lepszy niż NPM?

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

Historycznie NPM miał poważne problemy architektoniczne, które wpływały bezpośrednio na bezpieczeństwo, stabilność i wydajność projektów developerskich:

  1. Zależności fantomowe (Phantom Dependencies):
    • Problem: NPM używa płaskiego drzewa zależności (flat node_modules). Jeśli zainstalujesz pakiet A, a ten wymaga wewnętrznie pakietu B, NPM umieszcza B bezpośrednio w korzeniu node_modules.
    • Ryzyko bezpieczeństwa: Twój kod może odwoływać się do import bezpośrednio bez formalnego deklarowania w B. Jeśli w przyszłości zaktualizujesz package.json i przestanie zależeć od A, twój kod ulegnie awarii w produkcji w nieoczekiwany sposób. Ponadto otwiera drzwi do ataków łańcucha dostaw (Supply Chain Attacks), gdzie złośliwy kod dostaje się niezamierzenie do niezadeklarowanych płaskich pakietów.
  2. Dublowanie plików i blokowanie dysku:
    • NPM pobiera zbędne fizyczne kopie tych samych pakietów w każdym projekcie lokalnym na Twojej maszynie, wypełniając dysk twardy gigabajtami zbędnego kodu.
  3. Nadmierna powolność:
    • Proces rozwiązywania płaskiego drzewa wymaga ponownego obliczania i indeksowania tysięcy folderów w każdej instalacji, spowalniając prędkość Twoich przepływów integracji i wdrożenia ciągłego (CI/CD).

Rozwiązanie PNPM: Innowacja w Strukturze i Bezpieczeństwie

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

PNPM (Performant NPM) rozwiązuje te problemy za pomocą całkowicie rewolucyjnego podejścia:

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"]
  • Niepłaska struktura node_modules:
    • PNPM tworzy linki symboliczne (symlinks). Tylko pakiety jawnie deklarowane w Twoim package.json są dostępne w katalogu głównym node_modules. Fizycznie nie jest możliwe importowanie niezadeklarowanych pakietów fantomowych, co uniemożliwia ten wektor ataku.
  • Przechowywanie adresowalne według zawartości (Global Store):
    • Wszystkie pakiety są pobierane tylko raz do globalnego katalogu systemu. W Twoich projektach tworzone są linki fizyczne (hard links) do tego jednego magazynu. Oszczędzasz do 90% miejsca na dysku!
  • Większa prędkość:
    • Ponieważ nie kopiują plików fizycznie i czytają z globalnego pamięci podręcznej, instalacje z PNPM są nawet 3 razy szybsze niż z NPM.

FunkcjaNPMYarn (klasyczny)PNPM
Przeciwdziałanie Zależnościom Fantomowym✕ Nie✕ Nie✓ Tak (Zgodnie z projektem)
Wydajne Użycie Dysku✕ Nie (Kopia fizyczna)✕ Nie (Kopia fizyczna)✓ Tak (Hard Links globalne)
Prędkość instalacjiWolnaŚredniaUltra Szybka
Bezpieczeństwo łączaNiskie (płaski drzew)Niskie (płaski drzew)Wysoka (Struktura ścisła)

Ponieważ React Native zawiera kod skompilowany dla natywnych platform mobilnych, instalacja modułów musi być wykonana wspólnie:

Polecenie zalecane

Dla każdego pakietu zawierającego moduły natywne, zawsze używaj pnpm expo install zamiast surowych poleceń instalacji.

Podczas wykonywania pnpm expo install <paquete>:

  1. Expo sprawdza dokładną wersję certyfikowaną i kompatybilną z aktywną wersją twojego SDK.
  2. PNPM realizuje ultra szybką instalację, rozwiązując w sposób bezpieczny fizyczną strukturę połączeń w 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 zainstalowaniu pakietów z PNPM integracja z natywnymi folderami Gradle (Android) i CocoaPods (iOS) odbywa się naturalnie:

Ventana de terminal
# Compilar binarios de desarrollo nativos integrando las dependencias instaladas
pnpm expo run:android
pnpm expo run:ios
  • pnpm dlx expo-doctor: Diagnozuje i sprawdza ogólny stan SDK oraz zależności natywnych projektu.
  • pnpm expo install --fix: Rozwiązuje automatycznie i natychmiast każdą wersję, która nie jest zgodna w Twoim drzewie zależności, wymuszając zgodność z zalecaną wersją Expo.