Gradle uses the name as the build.gradle
default name for a build file. If We write our build code in a file then we do not have the build.gradle
"to specify" the build filename when we run the tasks. We can create build files with a different name other than build.gradle
. For example we can define our build logic in a file sample.gradle
. To run the tasks from this build file we can use the command line option -b
or --build-file
followed by the file name. But we can also change the project settings and set a new default build file name to our project. With the changed project settings we don't have the command line options -b
or --build-file
.
Suppose we have the following build file with the name sample.gradle
:
View Sourceprint?
0.
// File: sample.gradle
1.
task sample(description:
‘Sample task‘
) << {
2.
println
‘Sample task‘
3.
}
4.
5.
defaultTasks
‘sample‘
To run the sample
task from the command line we can use the command line options -b
or --build-file
:
$ gradle -b sample.gradle
:sample
Sample task
BUILD SUCCESSFUL
Total time: 3.168 secs
$ gradle --build-file sample.gradle
:sample
Sample task
BUILD SUCCESSFUL
Total time: 2.148 secs
$
To change the default build of file name for our project we create a file with our settings.gradle
project. Inside The settings.gradle
file we can change the property buildFileName
for rootProject
:
View Sourceprint?
0.
// File: settings.gradle
1.
// Change default build file name for this project.
2.
rootProject.buildFileName =
‘sample.gradle‘
Now we execute the tasks from sample.gradle
without the options -b
or --build-file
:
$ gradle
:sample
Sample task
BUILD SUCCESSFUL
Total time: 3.312 secs
$
Code written with Gradle 2.1.
Gradle goodness:changing Name of the Default Build File