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.
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:
Błąd Krytyczny NPM
Sección titulada «Los Fallos Críticos de NPM»- Zależności fantomowe (Phantom Dependencies):
- Problem: NPM używa płaskiego drzewa zależności (
flat node_modules). Jeśli zainstalujesz pakietA, a ten wymaga wewnętrznie pakietuB, NPM umieszczaBbezpośrednio w korzeniunode_modules. - Ryzyko bezpieczeństwa: Twój kod może odwoływać się do
importbezpośrednio bez formalnego deklarowania wB. Jeśli w przyszłości zaktualizujeszpackage.jsoni przestanie zależeć odA, 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.
- Problem: NPM używa płaskiego drzewa zależności (
- 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.
- 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.jsonsą dostępne w katalogu głównymnode_modules. Fizycznie nie jest możliwe importowanie niezadeklarowanych pakietów fantomowych, co uniemożliwia ten wektor ataku.
- PNPM tworzy linki symboliczne (symlinks). Tylko pakiety jawnie deklarowane w Twoim
- 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.
2. Tabela porównawcza funkcji
Sección titulada «2. Tabla Comparativa de Características»| Funkcja | NPM | Yarn (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ść instalacji | Wolna | Średnia | Ultra Szybka |
| Bezpieczeństwo łącza | Niskie (płaski drzew) | Niskie (płaski drzew) | Wysoka (Struktura ścisła) |
3. Integracja zależności z PNPM i Expo
Sección titulada «3. Integración de Dependencias con PNPM y Expo»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>:
- Expo sprawdza dokładną wersję certyfikowaną i kompatybilną z aktywną wersją twojego SDK.
- PNPM realizuje ultra szybką instalację, rozwiązując w sposób bezpieczny fizyczną strukturę połączeń w
node_modules/.pnpm/.
Praktyczny przykład instalacji
Sección titulada «Ejemplo Práctico de Instalación»# Instalar iconos vectoriales y almacenamiento asíncrono nativo de forma segurapnpm expo install lucide-react-native @react-native-async-storage/async-storage4. Kompilacja i integracja natywna
Sección titulada «4. Compilación e Integración Nativa»Po zainstalowaniu pakietów z PNPM integracja z natywnymi folderami Gradle (Android) i CocoaPods (iOS) odbywa się naturalnie:
# Compilar binarios de desarrollo nativos integrando las dependencias instaladaspnpm expo run:androidpnpm expo run:iosPrzydatne polecenia diagnostyczne
Sección titulada «Comandos de Diagnóstico Útiles»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.

