Ir al contenido

Abhängigkeitsmanagement und PNPM

Best Practices im Paketmanagement, Installation nativer Abhängigkeiten und warum PNPM in React Native unendlich überlegen und sicherer als NPM ist.

0Lesungen

Dieser Leitfaden behandelt umfassend die richtigen Methoden für die Installation, Aktualisierung und Integration von Abhängigkeiten in React Native-Projekten mit PNPM und erläutert, warum dies die optimale Wahl gegenüber dem traditionellen Paket-Manager NPM ist.


Historisch gesehen, hat NPM schwerwiegende architektonische Probleme mit sich gebracht, die sich direkt auf die Sicherheit, Stabilität und Leistung von Entwicklungsprojekten auswirken:

  1. Phantom-Abhängigkeiten:
    • Das Problem: NPM verwendet einen flachen Abhängigkeitsbaum (flat node_modules). Wenn du das Paket A installierst und dieses intern das Paket B benötigt, platziert NPM B direkt in der Root von node_modules.
    • Das Sicherheitsrisiko: Dein Code kann import von B direkt ohne formelle Deklaration in deinem package.json machen. Wenn du in Zukunft A aktualisierst und es nicht mehr von B abhängt, wird dein Code unerwartet in der Produktion kaputt gehen. Außerdem öffnet es die Tür für Angriffe auf die Lieferkette (Supply Chain Attacks), bei denen schädlicher Code unbeabsichtigt auf nicht deklarierte flache Pakete zugreift.
  2. Datei-Duplikation und Festplatten-Blockierung:
    • NPM lädt redundante physische Kopien derselben Pakete in jedes lokale Projekt auf deinem Computer herunter und füllt deine Festplatte mit Gigabytes an unnötigem Code.
  3. Exzessive Langsamkeit:
    • Der Auflösungsprozess des flachen Baums erfordert bei jeder Installation die Neuberechnung und Indizierung von Tausenden von Ordnern, was die Geschwindigkeit deiner Continuous Integration und Deployment (CI/CD) Workflows verlangsamt.

Die Lösung von PNPM: Innovation in Struktur und Sicherheit

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

PNPM (Performant NPM) löst diese Probleme durch einen völlig revolutionären Ansatz:

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"]
  • Nicht-flache Struktur von node_modules:
    • PNPM erstellt symbolische Links (symlinks). Nur die Pakete, die explizit in deiner package.json deklariert sind, sind in der Wurzel von node_modules zugänglich. Es ist physisch unmöglich, nicht deklarierte Phantom-Pakete zu importieren, wodurch dieser Angriffsvektor eliminiert wird.
  • Inhaltsadressierbarer Speicher (Global Store):
    • Alle Pakete werden nur einmal in ein globales Systemverzeichnis heruntergeladen. In deinen Projekten werden physische Links (hard links) zu diesem einzigen Speicher erstellt. Du sparst bis zu 90 % Speicherplatz!
  • Überlegene Geschwindigkeit:
    • Da Dateien nicht physisch kopiert werden und aus dem globalen Cache gelesen wird, sind Installationen mit PNPM bis zu 3-mal schneller als mit NPM.

FunktionNPMYarn (Classic)PNPM
Vermeidung von Phantom-Abhängigkeiten✕ Nein✕ Nein✓ Ja (by Design)
Effiziente Speichernutzung✕ Nein (Physische Kopie)✕ Nein (Physische Kopie)✓ Ja (Globale Hardlinks)
InstallationsgeschwindigkeitLangsamMittelUltraschnell
Link-SicherheitNiedrig (Flacher Baum)Niedrig (Flacher Baum)Hoch (Strikte Struktur)

3. Integration von Abhängigkeiten mit PNPM und Expo

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

Da React Native kompilierten Code für native mobile Plattformen enthält, muss die Installation von Modulen koordiniert erfolgen:

Empfohlener Befehl

Verwenden Sie für alle Pakete, die native Module enthalten, immer pnpm expo install anstelle von Raw-Installationsbefehlen.

Beim Ausführen von pnpm expo install <paquete>:

  1. Expo überprüft die genaue zertifizierte Version, die mit der aktiven Version deines SDKs kompatibel ist.
  2. PNPM führt eine ultraschnelle Installation durch, indem es die physische Verknüpfungsstruktur in node_modules/.pnpm/ sicher auflöst.
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

Sobald die Pakete mit PNPM installiert sind, erfolgt die Integration mit den nativen Ordnern von Gradle (Android) und CocoaPods (iOS) auf natürliche Weise:

Ventana de terminal
# Compilar binarios de desarrollo nativos integrando las dependencias instaladas
pnpm expo run:android
pnpm expo run:ios
  • pnpm dlx expo-doctor: Diagnostiziert und validiert den allgemeinen Zustand des SDKs und der nativen Abhängigkeiten des Projekts.
  • pnpm expo install --fix: Löst automatisch und sofort jede inkonsistente Version in deinem Abhängigkeitsbaum auf, indem es die Ausrichtung auf das empfohlene Expo-Release erzwingt.