たとえば、Gruntプラグインがgrunt への依存関係を「ピア依存関係」として定義するのはなぜですか？

なぜプラグインはgrunt-plug / node_modulesの独自の依存関係としてGruntを使用できないのですか？

ピアの依存関係については、https：//nodejs.org/en/blog/npm/peer-dependencies/で説明しています。

しかし、私は本当にそれを理解していません。

例

現在、Gruntタスクを使用してソースファイルを/ dist /フォルダーにビルドし、ローカルデバイスで提供されるAppGyver Steroidsを使用しています。私はnpmとうなり声で非常に新しいので、何が起こっているのかを完全に理解したいと思います。

これまでのところ私はこれを得ます：

[rootfolder] /package.jsonはnpmにgrunt-steroids、開発がnpmパッケージに依存していることを伝えます。

  "devDependencies": {
    "grunt-steroids": "0.x"
  },

はい。[rootfolder]でnpm installを実行すると、依存関係が検出され、[rootfolder] / node_modules / grunt-steroidsに grunt-steroidsがインストールされます。

次に、Npmは[rootfolder] /node_modules/grunt-steroids/package.jsonを読み取り、grunt-steroids独自の依存関係をインストールできるようにします。

"devDependencies": {
    "grunt-contrib-nodeunit": "0.3.0",
    "grunt": "0.4.4"
  },
"dependencies": {
    "wrench": "1.5.4",
    "chalk": "0.3.0",
    "xml2js": "0.4.1",
    "lodash": "2.4.1"
  },
"peerDependencies": {
    "grunt": "0.4.4",
    "grunt-contrib-copy": "0.5.0",
    "grunt-contrib-clean": "0.5.0",
    "grunt-contrib-concat": "0.4.0",
    "grunt-contrib-coffee": "0.10.1",
    "grunt-contrib-sass": "0.7.3",
    "grunt-extend-config": "0.9.2"
  },

「依存関係」パッケージは、[rootfolder] / node_modules / grunt-steroids / node_modulesにインストールされています。

「devDependencies」がインストールされていません。これは、使用しようとしているnpm検出によって制御されてgrunt-steroidsおり、開発を行っていません。

しかし、「peerDependencies」があります。

これらは[rootfolder] / node_modulesにインストールされていますが、他のgruntプラグイン（または何でも）との競合が回避されるように、[rootfolder] / node_modules / grunt-steroids / node_modulesにないのはなぜですか？

TL; DR：^[1] peerDependenciesは、公開されていない「プライベート」依存関係とは対照的に、消費コードに公開されている（および使用されることが予想される）依存関係用であり、実装の詳細にすぎません。

ピアの依存関係が解決する問題

NPMのモジュールシステムは階層的です。より単純なシナリオの大きな利点の1つは、npmパッケージをインストールすると、そのパッケージに独自の依存関係がもたらされるため、そのまま使用できることです。

ただし、次の場合に問題が発生します。

• プロジェクトと使用中のモジュールの両方が別のモジュールに依存しています。
• 3つのモジュールは互いに通信する必要があります。

例では

ビルドYourCoolProjectしていて、JacksModule 1.0との両方を使用しているとしJillsModule 2.0ます。そして、それがにJacksModuleも依存しているとしましょう。これら2つのバージョンが一致しない限り、問題はありません。表面下を使用しているという事実は、実装の詳細にすぎません。私たちは2回バンドルしていますが、箱から出してすぐに安定したソフトウェアを入手する場合、それはわずかな代償です。JillsModule1.0JacksModuleJillsModuleJillsModule

しかし、どうすればJacksModule依存関係JillsModuleが何らかの形で公開されたとしたらどうでしょう。それは例えばのインスタンスを受け入れますJillsClass... ライブラリのnew JillsClass使用バージョンを作成して2.0それに渡すとjacksFunctionどうなりますか？すべての地獄が解けます！のような単純なものは、実際にはが別のバージョンのバージョンであるため、jillsObject instanceof JillsClass突然戻ります。falsejillsObject JillsClass2.0

ピアの依存関係がこれを解決する方法

彼らはnpmに伝えます

このパッケージが必要ですが、モジュールのプライベートバージョンではなく、プロジェクトの一部であるバージョンが必要です。

npmは、パッケージが依存関係のないプロジェクトにインストールされている、または互換性のないバージョンのプロジェクトにインストールされていることを検出すると、インストールプロセス中にユーザーに警告します。

ピアの依存関係を使用する必要があるのはいつですか？

• あなたは他のプロジェクトで使用するライブラリを構築している場合、および
• このライブラリは、いくつかの他のライブラリを使用している、と
• ユーザーが他のライブラリも操作することを期待/必要とする

一般的なシナリオは、より大きなフレームワーク用のプラグインです。Gulp、Grunt、Babel、Mochaなどのことを考えてみてください。Gulpプラグインを作成する場合、そのプラグインを、自分のプライベートバージョンのGulpではなく、ユーザーのプロジェクトが使用しているのと同じGulpで動作させる必要があります。

注釈

1. 長すぎる; 読みませんでした。長すぎると思われるテキストの短い要約を示すために使用されます。

最初にもう一度記事を読むことをお勧めします。少しわかりにくいかもしれませんが、winston-mailの例では、その理由がわかります。

たとえば、それがテストされた最新バージョンであるため、オブジェクトでwinston-mail@0.2.3指定さ"winston": "0.5.x"れた"dependencies"ものを偽装してみましょう。アプリの開発者は、最新かつ最高のものを求めているので、winstonおよびの最新バージョンを調べて、winston-mailpackage.jsonに次のように配置します。

{
  "dependencies": {  
    "winston": "0.6.2",  
    "winston-mail": "0.2.3"  
  }  
}

しかし、今、npm installを実行すると、予期しない依存関係グラフが表示されます

├── winston@0.6.2  
└─┬ winston-mail@0.2.3                
  └── winston@0.5.11

この場合、いくつかの問題を引き起こすパッケージの複数のバージョンが存在する可能性があります。ピアの依存関係により、npm開発者は、ユーザーが特定のモジュール（ルートフォルダー内）を持っていることを確認できます。ただし、パッケージの特定のバージョンを1つ記述すると、他のバージョンを使用する他のパッケージで問題が発生するという点は正しいです。この問題は、記事に記載されているように、npm開発者に関係しています。

アドバイスの1つ：ピアの依存関係の要件は、通常の依存関係の要件とは異なり、寛大でなければなりません。ピアの依存関係を特定のパッチバージョンに限定しないでください。

したがって、開発者はpeerDependenciesを定義するためにsemverに従う必要があります。GitHubでgrunt-steroidsパッケージの問題を開く必要があります...

peerDependencies 可能な最も簡単な例で説明します：

{
  "name": "myPackage",
  "dependencies": {
    "foo": "^4.0.0",
    "react": "^15.0.0"
  }
}


{
  "name": "foo"
  "peerDependencies": {
    "react": "^16.0.0"
  }
}

myPackageでnpm installを実行すると、Reactバージョン^15.0.0とfoo、Reactとのみ互換性のあるバージョンをインストールしようとするため、エラーがスローされます^16.0.0。

peerDependenciesがインストールされていません。