Gruntのインストール

このドキュメントでは、GruntとGruntプラグインの特定のバージョンをインストールする方法を説明します。まだ入門ガイドをお読みでない場合は、まずそちらをご確認ください。

概要

GruntとGruntプラグインは、プロジェクトのdevDependenciesとしてpackage.jsonで定義する必要があります。これにより、npm installという単一のコマンドですべてのプロジェクトの依存関係をインストールできます。Gruntの現在の安定版と開発版は、常にwikiのホームぺージにリストされています。

特定のバージョンをインストール

GruntまたはGruntプラグインの特定のバージョンが必要な場合は、npm install grunt@VERSION --save-devを実行します。ここで、VERSIONは必要なバージョンです。これにより、指定されたバージョンがインストールされ、package.jsonのdevDependenciesに追加されます。

チルダバージョンの範囲は、--save-devフラグをnpm installに追加するとpackage.jsonで使用されます。これは通常、semverに従い、指定されたバージョンの新しいパッチリリースが開発の継続に合わせて自動的にアップグレードされるため、適しています。

公開された開発バージョンをインストール

新しい機能が開発されると、Gruntのビルドがnpmに公開される場合があります。これらのビルドは決してバージョン番号を明確に指定せずにインストールすることはできず、通常はビルド番号またはアルファ/ベータ/リリース候補の指定があります。

gruntの特定のバージョンをインストールする場合と同様に、npm install grunt@VERSION --save-devを実行します。ここで、VERSIONは必要なバージョンです。npmはそのバージョンのGruntをプロジェクトフォルダーにインストールし、package.jsonのdevDependenciesに追加します。

指定するバージョンに関係なく、チルダバージョンの範囲がpackage.jsonで指定されます。指定した開発バージョンの新しい、おそらく互換性のないパッチリリースがnpmによってインストールされてビルドが壊れる可能性があるため、これは非常に問題です。

このような場合は、package.jsonを手動で編集してバージョン番号からチルダ(~)を削除することが非常に重要です。これにより、指定した正確な開発バージョンがロックされます。

同じプロセスを使用して、Gruntプラグインの公開された開発バージョンをインストールすることもできます。

GitHubから直接インストール

公開されていないGruntまたはGruntプラグインの最先端のバージョンをインストールしたい場合は、依存関係としてgit URLを指定するための指示に従い、必ず実際のコミットSHA(ブランチ名ではない)をcommit-ishとして指定してください。これにより、プロジェクトが常に正確なバージョンのgruntを使用することが保証されます。

指定されたgit URLは、公式Gruntリポジトリまたはフォークにすることができます。