To build a Groovy project, you use the Groovy plugin. This plugin extends the Java plugin to add Groovy compilation capabilities to your project. Your project can contain Groovy source code, Java source code, or a mix of the two. In every other respect, a Groovy project is identical to a Java project, which we have already seen in 7章Javaクイックスタート.
Groovyプロジェクトをビルドするのには、Groovyプラグインを使います。このプラグインはJavaプラグインを拡張して、Groovyのコンパイル能力をプロジェクトに加えます。 プロジェクトはGroovyソースコード、Javaソースコード、またはこれらの両方を含むことができます。これ以外の点では、Groovyプロジェクトは7章Javaクイックスタートですでに見たJavaプロジェクトを同じです。
Let's look at an example. To use the Groovy plugin, add the following to your build file:
実例を見てみましょう。Groovyプラグインを使うためには、ビルドファイルに以下を記述を追加します:
例9.1 Groovyプラグイン
build.gradle
apply plugin: 'groovy'
ノート: 本例のソースコードは、Gradleのバイナリ配布物またはソース配布物に含まれています。以下の場所をご参照ください。samples/groovy/quickstart
This will also apply the Java plugin to the project, if it has not already been applied. The Groovy plugin
extends the compile
task to look for source files in directory
src/main/groovy
, and the compileTest
task to look for test source
files in directory src/test/groovy
. The compile tasks use joint compilation for these
directories, which means they can contain a mixture of Java and Groovy source files.
これにより、(もしまだなら)プロジェクトにはJavaプラグインも適用されます。Groovyプラグインはcompile
タスクを拡張してsrc/main/groovy
ディレクトリにあるソースファイルも参照するようにし、またcompileTest
タスクを拡張してsrc/test/groovy
ディレクトリにあるテスト用ソースファイルも参照するようにします。compileタスクはこれらのディレクトリに対してジョイントコンパイルを使うので、javaとgroovyのソースファイルが混在していてもかまいません。
To use the Groovy compilation tasks, you must also declare the Groovy version to use and where to find the
Groovy libraries. You do this by adding a dependency to the groovy
configuration.
The compile
configuration inherits this dependency, so the Groovy libraries will
be included in classpath when compiling Groovy and Java source. For our sample, we will use Groovy 2.2.0
from the public Maven repository:
Groovy用のcompileタスクを使うには、GroovyのバージョンとGroovyライブラリを探してくる場所を宣言する必要があります。これは、compile
コンフィギュレーションに依存関係を追加することによって行います。この例では、Groovy 2.2.0を使用します。
例9.2 Dependency on Groovy
build.gradle
repositories {
mavenCentral()
}
dependencies {
compile 'org.codehaus.groovy:groovy-all:2.3.6'
}
Here is our complete build file:
以下にビルドファイルの全体を示します:
例9.3 Groovy用のビルドファイル(全体)
build.gradle
apply plugin: 'eclipse' apply plugin: 'groovy' repositories { mavenCentral() } dependencies { compile 'org.codehaus.groovy:groovy-all:2.3.6' testCompile 'junit:junit:4.11' }
Running gradle build
will compile, test and JAR your project.
gradle build
を実行すれば、プロジェクトがコンパイル、テストされ、JARが生成されます。
This chapter describes a very simple Groovy project. Usually, a real project will require more than this. Because a Groovy project is a Java project, whatever you can do with a Java project, you can also do with a Groovy project.
この章では非常にシンプルなGroovyプロジェクトについて説明しました。通常、実プロジェクトではこの例よりもっと複雑な記述が必要でしょう。GroovyプロジェクトはJavaプロジェクトでもあるので、Javaプロジェクトで可能なことなら何でもGroovyプロジェクトでも可能です。
You can find out more about the Groovy plugin in 24章Groovyプラグイン, and you can find more
sample Groovy projects in the samples/groovy
directory in the Gradle distribution.
24章Groovyプラグインでは、Groovyプラグインをより詳しく説明しています。また、Gradle配布物のsamples/groovy
ディレクトリには、Groovyプロジェクトの実例が多く含まれています。