Ir al contenido

依存関係の管理とPNPM

パッケージの管理におけるベストプラクティス、ネイティブ依存関係のインストール、およびなぜPNPMがReact NativeにおいてNPMよりもはるかに優れているか、より安全であるかについて

0閲覧数

このガイドは、React Nativeプロジェクトにおける依存関係のインストール、更新、統合の正しい方法論を包括的に扱い、PNPMが伝統的なパッケージマネージャーNPMに比べて最適な選択肢である理由を詳しく説明します。


1. なぜPNPMはNPMよりもはるかに優れているのか?

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

歴史的に、NPMは開発プロジェクトのセキュリティ、安定性、パフォーマンスに直接影響を与える重大なアーキテクチャ上の問題を抱えていました:

  1. ファントム依存関係(Phantom Dependencies):
    • 問題: NPMはフラットな依存関係ツリー(flat node_modules)を使用します。もしAパッケージをインストールすると、その内部でBパッケージを必要とする場合、NPMはBをnode_modulesのルートに直接配置します。
    • セキュリティリスク: コードは、Bに対してimportを直接実行でき、package.jsonに正式に宣言する必要がありません。将来Aを更新し、Bへの依存を解除した場合、コードは予期せず本番環境で破損します。さらに、悪意のあるコードが宣言されていないフラットパッケージに不注意にアクセスするサプライチェーン攻撃(Supply Chain Attacks)の扉を開きます。
  2. ファイルの重複とディスクの占有:
    • NPMは、マシン上の各ローカルプロジェクトに同じパッケージの物理的な重複コピーをダウンロードし、ハードディスクに不要なギガバイトのコードで満たします。
  3. 過度の低速化:
    • 平坦なツリーの解決プロセスは、各インストールで数千のフォルダを再計算およびインデックス付けする必要があり、統合およびデプロイの継続的フロー(CI/CD)の速度を遅くします。

PNPMの解決策: 構造とセキュリティの革新

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

PNPM(Performant NPM)は、完全に革新的なアプローチでこれらの問題を解決します:

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"]
  • node_modulesの非フラット構造:
    • PNPMはシンボリックリンク(symlinks)を作成します。package.jsonに明示的に宣言されたパッケージのみがnode_modulesのルートからアクセス可能です。宣言されていないファントムパッケージをインポートすることは物理的に不可能であり、この攻撃ベクトルを無効化します。
  • コンテンツアドレス可能ストレージ(グローバルストア):
    • すべてのパッケージはシステムのグローバルディレクトリに< strong>1回だけダウンロードされます。プロジェクトでそのユニークなストアへの物理的リンク(hard links)が作成されます。ディスク容量の約90%を節約できます!
  • 高速化:
    • 物理的なファイルのコピーを行わず、グローバルキャッシュから読み取るため、PNPMでのインストールはNPMに比べて最大< strong>3倍速いです。

特徴NPMYarn(クラシック)PNPM
ファンタム依存関係の防止✕ いいえ✕ いいえ✓ はい(設計上)
効率的なディスク容量✕ いいえ(物理的コピー)✕ いいえ(物理的コピー)✓ はい(グローバルハードリンク)
インストール速度遅い平均超高速
リンクセキュリティ低(平坦なツリー)低(平坦なツリー)高(厳密な構造)

React Nativeにはネイティブプラットフォーム用のコンパイル済みコードが含まれているため、モジュールのインストールは調整して行う必要があります:

推奨コマンド

ネイティブモジュールを含むパッケージには、常に生のインストールコマンドの代わりにpnpm expo installを使用してください。

pnpm expo install <paquete>を実行すると:

  1. Expoは、アクティブなSDKバージョンと互換性のある正確なバージョンを検証します。
  2. PNPMは、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

4. ナイティブコンパイルと統合

Sección titulada «4. Compilación e Integración Nativa»

PNPMでパッケージをインストールした後、Gradle(Android)およびCocoaPods(iOS)のネイティブフォルダとの統合は自然に行われます:

Ventana de terminal
# Compilar binarios de desarrollo nativos integrando las dependencias instaladas
pnpm expo run:android
pnpm expo run:ios
  • pnpm dlx expo-doctor: SDKとプロジェクトのネイティブ依存関係の全体的な健全性を診断・検証します。
  • pnpm expo install --fix: 依存関係ツリー内のずれたバージョンを自動かつ即座に解決し、推奨されるExpoのリリースに強制的に揃えます。