Gradleは、ビルド作業を高い水準で自動化するツールです。Gradleを使えば、ソフトウェアパッケージだけでなく静的なウェブサイトなど、様々なプロジェクトのビルド、テスト、公開、デプロイ、ドキュメントの生成やその他、あらゆる作業を自動化することができます。
詳細な情報については http://gradle.org を参照してください。
リリースバージョンおよびナイトリービルド版が http://gradle.org/downloads からダウンロードできます。
当然ですが、GradleはGradleによってビルドされています。Gradleはラッパーという先進的な機能を備えているので、手でGradleをインストールしなくてもGradleを使って作業することができます。ラッパーはWindowsではバッチスクリプトとして、その他のOSではシェルスクリプトとして提供されます。
このプロジェクトは、そのラッパーを使ってビルドするべきです。一般的に言っても、ラッパーが同梱されているGradleプロジェクトはラッパーを使ってビルドしてください。それにより、プロジェクトが想定する正しいバージョンのGradleでビルドできます。
Gradleプロジェクト全体をビルドするには、チェックアウトしたディレクトリのルートで次のコマンドを実行してください。
./gradlew build
これで、全てのコードがコンパイルされ、全ドキュメントが生成され、テストも全て実施されます。これには、速いマシンでも一時間程度掛かるかもしれません。Gradleの全ての機能を仮想的に実行する結合テストを含む、数千ものテストが実行されるためです。テスト項目には、バージョン間の互換性チェック、サンプルやJavadoc内のスニペットが正しいかどうかの確認、デーモンプロセスの機能確認などが含まれています。
ソースツリーからインストールするには、以下のいずれかのコマンドを実行してください。
./gradlew install -Pgradle_installPath=/usr/local/gradle-source-build
これは、最小構成のインストールを行うコマンドです。Gradleを実行するのに必要なものだけがインストールされます（ドキュメントなどは含まれない）。-Pgradle_installPathでインストール先を指定しています。
インストールが完了すれば、以下のようにしてビルドを実行できます。
/usr/local/gradle-source-build/bin/gradle ≪some task≫
ドキュメントなどを含むフルインストールを行うには次のコマンドを実行します。
./gradlew installAll -Pgradle_installPath=/usr/local/gradle-source-build
本プロジェクトは、Gradleの機能を利用してマルチプロジェクトの論理的な構造をカスタマイズしています。物理的にはビルド上のサブプロジェクトは全てsubprojects/サブディレクトリに配置されていますが、ビルド実行時にはsettings.gradleの設定によりトップレベルの子プロジェクトとして扱われます。
このため、例えばcoreサブプロジェクトはsubprojects/coreにありますが、次のようにしてビルドできます。
./gradlew core:build
docプロジェクトの場合はこうです。
./gradlew docs:build
その他のサブプロジェクトについても同様です。
Gradleプロジェクトに協力したい、またパッチやプルリクエストを送りたいといった際は、http://gradle.org/development を参照してください。開発者に連絡を取る方法について知ることができます。
ビルドというのはとても複雑なトピックなので、どなたであってもGradleのコードベースで作業を始めるならGradleの開発チームは喜んでサポートします。 ビルド時に困った点を修正したいといった場合は、細かいことでも遠慮なく開発チームまでご連絡ください。
単に何かを修正したいときや小さな機能を追加したいといった場合は、修正を加えたサブプロジェクトでcheckタスクを走らせれば、品質的にはたいてい十分です。たとえば、そのパッチが`launcher'に対するものであれば、次のようにタスクを実行します。
./gradlew launcher:check
これで、そのモジュールに対するテストとコード品質のチェックが実施されます。
docs subprojectのREADMEを参照してください。
プロジェクトのルートディレクトリで次のコマンドを実行するだけで、IDEAで開くことができるようになります。
./gradlew idea
このコマンドは、IDEAがプロジェクトを認識できるように適切なIDEAメタデータを生成します。
このプロジェクトは、現在Eclipseではビルドできません。将来できるようになったときはこの節を参考にしてください。
次のコマンドを実行します。
./gradlew eclipse
このコマンドはEclipseのメタデータを生成し、Eclipseプロジェクトとしてインポートできるようにします。しかし、ちゃんと動くようにするには、さらに手でいくつかのセットアップ作業が必要になるはずです。