gradleとgradlew、gradlew.bat (Gradleラッパー) の違い、コマンドを実行できない？

プログラミング

2020.11.062020.10.24

Gradleで生成したプロジェクトに勝手に作られてしまう、gradlewとgradlew.batという2つのファイル。

これらのファイルは、Gradle Wrapper (Gradleラッパー) と呼ばれています。

gradlew は、Linux/macOS用のシェルスクリプト。

gradlew.bat は、Windows用のバッチファイル。

この2つの違いは何なんでしょうか？

Gradle Wrapper (Gradleラッパー) はGralde + インストーラー

Gradle Wrapper (Gradleラッパー) を使うと、Gradleがシステムにインストールされていなければ、自動的にインストールしてくれます。

自動ダウンロードするために、インターネットにつながっていないといけません。

Gradle Wrapper (Gradleラッパー) はプロジェクトの一部です。

gitで管理し、プロジェクトチームで共有して使います。

一方で、システムにインストールしたgradleはどのプロジェクトとも関連しない実行ファイルです。

Gradle Wrapper (Gradleラッパー) は特定のバージョンのGradleに関連付けられます。

したがって、異なるバージョンのgradleがシステムにインストールされていた場合は、関連付けらているgradleのバージョンがインストールされます。

それでは、なぜgradleのプロジェクトでは Gradle Wrapper (Gradleラッパー) が勝手に作られてしまうのでしょうか？

gradlew の最大のメリットは、gプロジェクトを配布した場合、新規参加の開発者にgradleのインストールを依頼しなくて良い点です。

Gradle Wrapper (Gradleラッパー) を使えば、自動的に最適なgradleがインストールされるからです。

antやmavenにはない、メリットです。

gradlew コマンド実行できない (command not found) って表示されますか？

gradlewをコマンドラインから実行するには、

を追加する必要があります。

Linux / MacOS

./gradlew

./gradlew

Windows PowerShell

.\gradlew

.\gradlew