Gradle旧バージョン一覧とZIPダウンロード方法、Javaバージョン互換性まとめ

Gradle 3.x系・4.x系の旧バージョンを確認する前に知っておきたい基本知識

Gradleの旧バージョンが必要になる主なケース

Gradleの旧バージョンは、主にレガシープロジェクトのビルド環境を復元する場合や、オフライン環境で特定バージョンを手動配置する場合に必要になります。Gradle 3.x系は2016年から2017年にかけてリリースされたバージョンで、現在のGradle 9.x系とはビルド設定の記述方法やプラグインの互換性が大きく異なります。

通常の新規プロジェクトではGradle Wrapperが自動的に必要なバージョンをダウンロードするため、手動での取得は不要です。ただし、Wrapperの自動ダウンロードが使えない環境や、当時のビルド環境を忠実に再現したい場合には、公式サイトからZIPファイルを直接取得する必要があります。

旧バージョンの利用はあくまでも環境復元や学習目的に限り、新規開発には現行の安定版を使うことが推奨されます。（出典：Gradle公式サイト「Gradle Releases」）

Gradle Wrapperと旧バージョンの関係

Gradle Wrapperは、プロジェクトが使用するGradleバージョンをgradle-wrapper.propertiesファイルに記録し、必要なZIPを自動取得する仕組みです。旧バージョンで作成されたプロジェクトの場合、distributionUrlにhttps://services.gradle.org/distributions/gradle-3.3-bin.zipのようなURLが指定されています。

Wrapperが存在するプロジェクトでは、開発者が手動でGradleをインストールする必要はなく、gradlewコマンドを実行するだけで指定バージョンが使われます。この仕組みにより、チーム全体やCI環境で同じGradleバージョンを使用できます。

手動ダウンロードが必要になるのは、オフライン環境や特定バージョンを固定して配布する場合などに限られます。（出典：Gradle公式ドキュメント「Gradle Wrapper Basics」）

旧バージョンを扱う際の注意点

Gradle 3.x系は2017年にサポートが終了しており、現在のJDK 17以上では動作しません。Gradle 3.xを実行するにはJava 7以上が必要で、当時はJDK 8での実行が標準的でした。現在の環境で旧バージョンを動かすには、対応するJDKを別途用意する必要があります。

また、Gradle 3.xのビルドスクリプトは現在のGradle 9.xと完全な互換性があるわけではありません。特に依存関係の設定方法やプラグインの指定方法が異なるため、そのまま最新版で動かそうとするとエラーが発生することがあります。

旧バージョンのZIPは無料でダウンロードできますが、新規プロジェクトに使用することは避けるべきです。

要点：旧バージョンはレガシープロジェクトの復元やオフライン環境での利用が主目的。Gradle 3.xはJava 7以上で動作し、現在のJDK 17以上では動かない。

Gradle 3.0から3.5.1までの全バージョン一覧とリリース時期

Gradle 3.x系の全リリース一覧

Gradle 3.x系は2016年8月から2017年6月にかけてリリースされたバージョン群です。以下が公式に確認できる全リリースの一覧です。

3.5.1が3.x系の最終リリースであり、以後は4.x系に移行しています。（出典：Gradle公式サイト「Gradle Releases」）

パッチリリースの役割と選び方

3.x系にはパッチリリースが2つ存在します。3.2に対する3.2.1、3.4に対する3.4.1です。パッチリリースは、メジャーバージョン内で発見されたバグ修正や安定性向上を目的として公開されます。

特定の3.x系バージョンを使う必要がある場合、可能であれば同じ系統の最終パッチリリースを選ぶのが安全です。ただし、3.5系の最終版である3.5.1は3.x系全体の最終リリースでもあり、当時の最新のバグ修正が含まれています。

レガシープロジェクトの復元では、元のプロジェクトが使用していた正確なバージョンを使うことが最も確実です。

3.x系のリリース時期と歴史的背景

Gradle 3.x系がリリースされた2016年から2017年は、Java 8が広く普及し、Java 9の登場が目前に迫っていた時期です。Gradle 3.0ではJava 6でのGradle実行サポートが打ち切られ、Java 7以上が必須となりました。

一方で、コンパイル対象としてのJava 6サポートは引き続き提供されており、古いJavaアプリケーションのビルドにも対応していました。Gradle 3.0では新たにjava-libraryプラグインが導入され、apiとimplementationの依存関係区分が使えるようになりました。

この時期の変更点は、現在のGradleの依存関係管理の基礎となっています。（出典：Gradle公式ドキュメント「Gradle 3.0 Release Notes」）

要点：Gradle 3.x系は全9リリースあり、最終版は3.5.1（2017年6月16日）。パッチリリースを含め、公式サイトで全バージョンのZIPが入手可能。

Gradle 4.0.2、4.5、4.7、4.9など4.x系の主なバージョンと特徴

Gradle 4.x系の位置づけと主なリリース

Gradle 4.x系は、3.x系の後継として2017年からリリースされたバージョン群です。公式のGradle Releasesページには4.0.2、4.5、4.7、4.9を含む多数の4.x系バージョンが掲載されており、すべてのZIPファイルがダウンロード可能です。

4.x系は、Java 9の正式リリースに対応するための改良や、ビルドパフォーマンスの向上が進められた世代です。3.x系と比較して、より新しいJDKでの実行や、Kotlin DSLの導入が進んだ点が特徴です。

4.x系の各バージョンも現在ではサポートが終了しており、利用はレガシー環境の復元に限られます。

4.x系の各バージョンに共通する特徴

Gradle 4.x系では、ビルドキャッシュや並列実行などのパフォーマンス改善が段階的に進められました。また、依存関係管理のAPIが整理され、3.x系から続くjava-libraryプラグインの利用が一般化しました。

Kotlin DSLのサポートも4.x系の途中から導入され、従来のGroovy DSLに加えてbuild.gradle.ktsによるビルド設定が可能になりました。これにより、Kotlinを使うプロジェクトとの親和性が高まっています。

ただし、4.x系の各バージョンごとの詳細な変更点は公式のRelease Notesで確認する必要があります。（出典：Gradle公式サイト「Gradle Releases」）

4.x系を選ぶ際の判断ポイント

4.x系の特定バージョンが必要になるのは、主に当時のプロジェクトが依存していたGradleバージョンを再現する場合です。例えば、特定のプラグインが4.x系の特定バージョンでのみ動作するケースや、CI環境の再現が必要なケースがあります。

バージョンを選ぶ際は、プロジェクトのgradle-wrapper.propertiesに記録されているdistributionUrlを確認するのが最も確実です。手動で選ぶ場合は、必要な機能が導入されたバージョン以降で、かつ当時の安定版を使うことが推奨されます。

4.x系も現在のJDK 17以上では動作しないため、対応するJDKの用意が必要です。

要点：4.x系は3.x系の後継としてJava 9対応やKotlin DSL導入が進んだ世代。特定バージョンの選定はプロジェクトのWrapper設定を確認するのが確実。

Gradle 3.3や2.14.1など旧バージョンのZIPを公式サイトからダウンロードする方法

公式配布サーバーからのダウンロード手順

Gradleの旧バージョンZIPは、公式配布サーバーhttps://services.gradle.org/distributions/から無料でダウンロードできます。Gradle 0.7から最新版まで、すべてのバージョンの-bin.zipが公開されています。

1. Gradle Releasesページ（https://gradle.org/releases/）にアクセスします。
2. ページ下部の旧バージョン一覧から目的のバージョンを選択します。
3. ZIPファイルのリンクから直接ダウンロードします。
4. ダウンロードしたZIPを解凍し、binディレクトリを環境変数PATHに追加します。

直接URLを指定する場合は、バージョン番号を変えるだけで任意のバージョンを取得できます。（出典：Gradle公式サイト「Gradle Releases」）

ZIPファイルの種類とURL命名規則

公式配布サーバーでは、以下の2種類のZIPが提供されています。

URLはhttps://services.gradle.org/distributions/gradle-{バージョン}-{タイプ}.zipの形式です。例えばGradle 3.5.1の場合はgradle-3.5.1-bin.zip、Gradle 3.0の場合はgradle-3.0-bin.zipとなります。

通常は-bin.zipで十分ですが、ソースコードを参照したい場合は-all.zipを選びます。

手動ダウンロードが必要なケースと注意点

Gradle Wrapperが設定されているプロジェクトでは、gradlewコマンドの実行時に自動的にZIPがダウンロードされます。そのため、通常の開発では手動ダウンロードは不要です。手動取得が必要になるのは、以下のようなケースです。

• オフライン環境でビルドする場合
• CI/CDパイプラインで特定バージョンを固定したい場合
• レガシープロジェクトのビルド環境を手動で復元する場合
• 教育・学習目的で過去のバージョンを調査する場合

手動で配置する場合は、Gradle WrapperのdistributionUrlが参照する場所と一致させる必要があります。また、Gradleはオープンソースであり、旧バージョンも含めて無料で入手できます。

要点：旧バージョンのZIPは公式配布サーバーから無料で入手可能。URLは「gradle-{バージョン}-{bin|all}.zip」形式で、通常はbin版で十分。

旧バージョンのGradleを選ぶ際に確認すべきJavaバージョン互換性と注意点

Gradleの実行に必要なJavaバージョン

Gradleを実行するためのJDKバージョンは、Gradleのバージョンごとに異なります。特に旧バージョンでは、現在のJDKでは動作しない点に注意が必要です。

Gradle 3.0ではJava 6での実行サポートが終了し、Java 7以上が必須となりました。旧バージョンを動かすには、対応するJDKを別途インストールする必要があります。（出典：Gradle公式ドキュメント「Gradle 3.0 Release Notes」「Compatibility Matrix」）

Gradleの実行環境とコンパイル対象の違い

Gradle自体を実行するJavaバージョンと、プロジェクトのソースコードをコンパイルするJavaバージョンは別物です。例えばGradle 3.xでは、Gradleの実行にはJava 7以上が必要ですが、コンパイル対象としてはJava 6も引き続きサポートされていました。

この区別を理解していないと、古いJavaアプリケーションをビルドする際に誤ったGradleとJDKの組み合わせを選んでしまう可能性があります。GradleにはJava Toolchainsという仕組みがあり、Gradleを実行するJDKとビルドに使用するJava環境を分離できます。

旧バージョンのGradleを選ぶ際は、まず実行環境のJDKバージョンを確認し、その上でコンパイル対象のJavaバージョンを設定します。（出典：Gradle公式ドキュメント「Compatibility Matrix」）

旧バージョンを安全に使うためのチェックリスト

旧バージョンのGradleを利用する前に、以下の点を確認してください。

• プロジェクトのWrapper設定：gradle-wrapper.propertiesに記載されたバージョンを確認する
• 実行するJDKのバージョン：旧Gradleが対応するJDK（3.x系ならJava 7〜8）を用意する
• ビルドスクリプトの互換性：3.x系のbuild.gradleが現在のGradleと互換性がない場合がある
• プラグインのバージョン：当時のプラグインが現在のリポジトリから取得可能か確認する
• セキュリティとサポート：3.x系はサポート終了しており、セキュリティ修正は提供されない

旧バージョンの利用はレガシー環境の復元に限定し、新規開発では現行の安定版とGradle Wrapperを使うことが公式推奨です。（出典：Gradle公式ドキュメント「Gradle Wrapper Basics」）

要点：旧Gradleの実行には対応するJDKが必要。Gradle 3.x系はJava 7〜8で動作し、現在のJDK 17以上では動かない。実行環境とコンパイル対象のJavaバージョンを混同しないこと。