Gradle-ビルドの実行

Gradleは、ビルドスクリプトを実行するためのコマンドラインを提供します。一度に複数のタスクを実行できます。この章では、さまざまなオプションを使用して複数のタスクを実行する方法について説明します。

複数のタスクの実行

1つのビルドファイルから複数のタスクを実行できます。Gradleは、を使用してそのビルドファイルを処理できますgradle command。このコマンドは、リストされている順序で各タスクをコンパイルし、さまざまなオプションを使用して依存関係とともに各タスクを実行します。

Example− task1、task2、task3、およびtask4の4つのタスクがあります。Task3とtask4は、task1とtask2に依存します。次の図を見てください。

上記の4つのタスクは、矢印記号で表された相互に依存しています。次のコードを見てください。コピーして貼り付けることができますbuild.gradle ファイル。

task task1 << {
   println 'compiling source'
}

task task2(dependsOn: task1) << {
   println 'compiling unit tests'
}

task task3(dependsOn: [task1, task2]) << {
   println 'running unit tests'
}

task task4(dependsOn: [task1, task3]) << {
   println 'building the distribution'
}

上記のタスクをコンパイルして実行するには、次のコードを使用できます。

C:\> gradle task4 test

出力：

:task1
compiling source
:task2
compiling unit tests
:task3
running unit tests
:task4
building the distribution

BUILD SUCCESSFUL

Total time: 1 secs

タスクを除く

実行からタスクを除外するときに、gradleコマンドと一緒に–xオプションを使用して、除外するタスクの名前を指定できます。

次のコマンドを使用して、上記のスクリプトからtask4を除外します。

C:\> gradle task4 -x test

出力：

:task1
compiling source
:task4
building the distribution

BUILD SUCCESSFUL

Total time: 1 secs

障害が発生した場合のビルドの続行

Gradleは実行を中止し、タスクが失敗するとすぐにビルドを失敗させます。障害が発生しても実行を継続できます。このためには、gradleコマンドで–continueオプションを使用する必要があります。各タスクをその依存関係とともに個別に処理します。そして、主な重要なポイントは、発生した各障害をキャッチし、ビルドの実行の最後に報告することです。タスクが失敗した場合、依存する後続のタスクも実行されないとします。

実行するビルドの選択

gradleコマンドを実行すると、現在のディレクトリでビルドファイルが検索されます。–bオプションを使用して、絶対パスとともに特定のビルドファイルを選択できます。次の例からプロジェクトhelloを選択しますmyproject.gradle にあるファイル subdir/ それを見てください。

task hello << {
   println "using build file '$buildFile.name' in '$buildFile.parentFile.name'."
}

次のコマンドを使用して、上記のスクリプトを実行できます。

C:\> gradle -q -b subdir/myproject.gradle hello

出力：

using build file 'myproject.gradle' in 'subdir'.

ビルド情報の取得

Gradleには、タスクとプロジェクトに関する情報の詳細を取得するためのいくつかの組み込みタスクが用意されています。これは、ビルドの構造と依存関係を理解し​​たり、問題をデバッグしたりするのに役立ちます。プロジェクトレポートプラグインを使用して、プロジェクトにタスクを追加すると、これらのレポートが生成されます。

プロジェクトの一覧表示

を使用して、選択したプロジェクトとそのサブプロジェクトのプロジェクト階層を一覧表示できます。 gradle –q projectsコマンド。次に例を示します。次のコマンドを使用して、ビルドファイル内のすべてのプロジェクトを一覧表示します。

C:\> gradle -q projects

出力：

------------------------------------------------------------
Root project
------------------------------------------------------------

Root project 'projectReports'
+--- Project ':api' - The shared API for the application
\--- Project ':webapp' - The Web application implementation

To see a list of the tasks of a project, run gradle <project-path>:tasks
For example, try running gradle :api:tasks

指定されている場合、レポートには各プロジェクトの説明が表示されます。次のコマンドを使用して、説明を指定できます。に貼り付けますbuild.gradle ファイル。

description = 'The shared API for the application'

リスティングタスク

次のコマンドを使用して、複数のプロジェクトに属するすべてのタスクを一覧表示できます。

C:\> gradle -q tasks

出力：

------------------------------------------------------------
All tasks runnable from root project
------------------------------------------------------------

Default tasks: dists

Build tasks
-----------
clean - Deletes the build directory (build)
dists - Builds the distribution
libs - Builds the JAR

Build Setup tasks
-----------------
init - Initializes a new Gradle build. [incubating]
wrapper - Generates Gradle wrapper files. [incubating]

Help tasks
----------
buildEnvironment - Displays all buildscript dependencies declared in root project 'projectReports'.
components - Displays the components produced by root project 'projectReports'. [incubating]
dependencies - Displays all dependencies declared in root project 'projectReports'.
dependencyInsight - Displays the insight into a specific dependency in root project 'projectReports'.
help - Displays a help message.
model - Displays the configuration model of root project 'projectReports'. [incubating]
projects - Displays the sub-projects of root project 'projectReports'.
properties - Displays the properties of root project 'projectReports'.
tasks - Displays the tasks runnable from root project 'projectReports' 
   (some of the displayed tasks may belong to subprojects).

To see all tasks and more detail, run gradle tasks --all

To see more detail about a task, run gradle help --task <task>

次のコマンドを使用して、すべてのタスクの情報を表示できます。

C:\> gradle -q tasks --all

出力：

------------------------------------------------------------
All tasks runnable from root project
------------------------------------------------------------

Default tasks: dists

Build tasks
-----------
clean - Deletes the build directory (build)
api:clean - Deletes the build directory (build)
webapp:clean - Deletes the build directory (build)
dists - Builds the distribution [api:libs, webapp:libs]
   docs - Builds the documentation
api:libs - Builds the JAR
   api:compile - Compiles the source files
webapp:libs - Builds the JAR [api:libs]
   webapp:compile - Compiles the source files

Build Setup tasks
-----------------
init - Initializes a new Gradle build. [incubating]
wrapper - Generates Gradle wrapper files. [incubating]

Help tasks
----------
buildEnvironment - Displays all buildscript dependencies declared in root project 'projectReports'.
api:buildEnvironment - Displays all buildscript dependencies declared in project ':api'.
webapp:buildEnvironment - Displays all buildscript dependencies declared in project ':webapp'.
components - Displays the components produced by root project 'projectReports'. [incubating]
api:components - Displays the components produced by project ':api'. [incubating]
webapp:components - Displays the components produced by project ':webapp'. [incubating]
dependencies - Displays all dependencies declared in root project 'projectReports'.
api:dependencies - Displays all dependencies declared in project ':api'.
webapp:dependencies - Displays all dependencies declared in project ':webapp'.
dependencyInsight - Displays the insight into a specific dependency in root project 'projectReports'.
api:dependencyInsight - Displays the insight into a specific dependency in project ':api'.
webapp:dependencyInsight - Displays the insight into a specific dependency in project ':webapp'.
help - Displays a help message.
api:help - Displays a help message.
webapp:help - Displays a help message.
model - Displays the configuration model of root project 'projectReports'. [incubating]
api:model - Displays the configuration model of project ':api'. [incubating]
webapp:model - Displays the configuration model of project ':webapp'. [incubating]
projects - Displays the sub-projects of root project 'projectReports'.
api:projects - Displays the sub-projects of project ':api'.
webapp:projects - Displays the sub-projects of project ':webapp'.
properties - Displays the properties of root project 'projectReports'.
api:properties - Displays the properties of project ':api'.
webapp:properties - Displays the properties of project ':webapp'.
tasks - Displays the tasks runnable from root project 'projectReports' 
   (some of the displayed tasks may belong to subprojects).
api:tasks - Displays the tasks runnable from project ':api'.
webapp:tasks - Displays the tasks runnable from project ':webapp'.

さまざまなオプションを説明する表のコマンドのリストを次に示します。

シニア番号 コマンド 説明
1 gradle –q help –task <タスク名> 特定のタスクまたは複数のタスクに関する使用情報（パス、タイプ、説明、グループなど）を提供します。
2 gradle –qの依存関係 選択したプロジェクトの依存関係のリストを提供します。
3 gradle -q api：dependencies --configuration <タスク名> 構成ごとに制限された依存関係のリストを提供します。
4 gradle –q buildEnvironment ビルドスクリプトの依存関係のリストを提供します。
5 gradle –qdependencyInsight 特定の依存関係への洞察を提供します。
6 Gradle –qプロパティ 選択したプロジェクトのプロパティのリストを提供します。
ja/tutorial
es/tutorial
de/tutorial
fr/tutorial
th/tutorial
pt/tutorial
ru/tutorial
vi/tutorial
it/tutorial
ko/tutorial
tr/tutorial
id/tutorial
pl/tutorial
hi/tutorial
japost
espost
depost
frpost
thpost
ptpost
rupost
vipost
itpost
kopost
trpost
idpost
plpost
hipost

© Copyright 2021 - 2024 | All Rights Reserved