Gradle » History » Revision 5
Revision 4 (Alexey Demakov, 11/10/2015 02:11 PM) → Revision 5/9 (Alexey Demakov, 11/10/2015 02:24 PM)
h1. Gradle-based build system.
h2. История
Предыдущая версия системы сборки использовала Ant для управления сборкой и Ivy для управления зависимостями.
Система сборки представляла собой библиотечный Ant файл, который подключался к проекту и предоставлял
базовую функциональность по сборке Java проектов и управлению выпуском релизов.
Gradle реализует и расширяет эту функциональность, поэтому принято решение использовать этот инструмент для сборки проектов.
h2. Ресурсы
http://gradle.org
h2. Подключение Gradle к проекту
h3. 1. Установить gradle, определить переменную окружения GRADLE_HOME.
h3. 2. В каталоге проекта выполнить команду создания конфигурационных файлов для Java проекта:
@> gradle init --type java-library@
Другие доступные типы проектов: https://docs.gradle.org/current/userguide/build_init_plugin.html
Также будет создана обертка-запускач gradlew/gradlew.bat, которая избавляет от необходимости вручную
устанавливать gradle для сборки проекта - разработчику достаточно просто выкачать рабочую копию проекта из репозитория,
gradle будет установлен автоматически.
Имя проекта будет записано в settings.gradle. Gradle предполагает, что имя проекта совпадает с именем каталога проекта.
Если это не так, необходимо исправить имя проекта в файле settings.gradle.
Дополнительная информация:
https://docs.gradle.org/current/userguide/gradle_wrapper.html
https://docs.gradle.org/current/userguide/wrapper_plugin.html
h3. 3. Привести структуру папок в соответствие с соглашениями gradle:
src/main/java - код проекта
src/main/resources - ресурсы проекта
src/test/java - код тестов
Дополнительная информация:
https://docs.gradle.org/current/userguide/java_plugin.html#N12323
h3. 4. Указать зависимости проекта в build.gradle:
compile - зависимость, необходимая для сборки проекта
testCompile - зависимость, необходимая для сборки тестов
группа:имя:версия - формат зависимости
<pre>
dependencies {
// The production code uses the SLF4J logging API at compile time
compile ''org.slf4j:slf4j-api:1.7.12''
// Declare the dependency for your favourite test framework you want to use in your tests.
// TestNG is also supported by the Gradle Test task. Just change the
// testCompile dependency to testCompile ''org.testng:testng:6.8.1'' and add
// ''test.useTestNG()'' to your build script.
testCompile ''junit:junit:4.12''
}
</pre>
Дополнительная информация: https://docs.gradle.org/current/userguide/java_plugin.html#sec:java_plugin_and_dependency_management
h3. 5. Указать репозитории, в которых ищутся зависимости
build.gradle:
<pre>
repositories {
// репозиторий ИСП РАН, подключается, если есть зависимости от наших проектов
ivy {
url = ''http://forge.ispras.ru/repo''
layout ''pattern'', {
artifact ''[organization]/[ext]s/[artifact]-[revision](.[ext])''
}
}
// Use ''jcenter'' for resolving your dependencies.
// You can declare any Maven/Ivy/file repository here.
jcenter()
}
</pre>
Дополнительная информация: https://docs.gradle.org/current/userguide/dependency_management.html#sec:repositories
h3. 6. Настроить опции компиляции Java
build.gradle:
<pre>
sourceCompatibility = JavaVersion.VERSION_1_8
targetCompatibility = JavaVersion.VERSION_1_8
compileJava {
options.encoding = "UTF-8"
}
</pre>
Команда компилцяии Java файлов:
<pre>
> gradlew compileJava
</pre>
Компиляция и прогон тестов:
<pre>
> gradlew test
</pre>
Дополнительная информация: https://docs.gradle.org/current/userguide/java_plugin.html#N1245A
h3. 7. Подключить плагин для сборки дистрибутива
Для приложений (дистрибутив содержит библиотеки и скрипты для запуска):
build.gradle:
<pre>
apply plugin: ''application''
...
mainClassName = "org.gradle.sample.Main"
</pre>
Для библиотек (application plugin подключает это автоматически):
build.gradle:
<pre>
apply plugin: ''distribution''
</pre>
Команда сборки дистрибутива
<pre>
> gradlew distZip
</pre>
или
<pre>
> gradlew distTar
</pre>
оба сразу:
<pre>
assembleDist
</pre>
Дополнительная информация:
https://docs.gradle.org/current/userguide/distribution_plugin.html
https://docs.gradle.org/current/userguide/application_plugin.html
h3. 8. Подключить плагин для выпуска релизов
build.gradle:
<pre>
// в начало файла
import java.text.SimpleDateFormat
import java.util.regex.Matcher
import org.gradle.api.Project
plugins {
id ''net.researchgate.release'' version ''2.3.4''
}
...
// в конец файла
release {
failOnCommitNeeded = false
versionPatterns = [
// Increments build number: "0.2.5-alpha-150428" => "0.2.6-alpha-150428"
/(^\d+\.\d+\.)(\d+)(-[^-]*)(-[^-]*$)/:
{ Matcher m, Project p -> m.replaceAll("${ m[0][1] }${ (m[0][2] as int) + 1 }${ m[0][3] }" ) }
]
}
task setReleaseData << {
project.version=project.version+''-''+new SimpleDateFormat("yyMMdd").format(new Date())
}
confirmReleaseVersion.dependsOn setReleaseData
</pre>
Готовящаяся к выпуску версия (вместо текущей даты SNAPSHOT) хранится в файле gradle.properties:
<pre>
version=0.1.28-alpha-SNAPSHOT
</pre>
Команда выпуска новой версии:
<pre>
> gradlew release
</pre>
Будет предложено подтвердить или изменить номер выпускаемой версии, а затем номер следующей готовящейся версии.
Дополнительная информация: https://github.com/researchgate/gradle-release
Хорошо бы согласовать систему нумерации версий с "семантическим версионированием":http://semver.org/lang/ru/.
Есть плагин, поддерживающий этот подход: https://plugins.gradle.org/plugin/de.gliderpilot.semantic-release
h3. 9
Компиляция, прогон тестов и запуск инструментов статического анализа кода:
<pre>
> gradlew check</pre>
h3. 10. Копирование зависимостей в подкаталог ''libs''
gradle скачивает зависимости куда-то в свой кэш.
Это неудобно при использовании eclipse.
Мы привыкли, что библиотеки лежат рядом.
Копировать их в подкаталог ''libs'' проекта можно так:
build.gradle
<pre>
//copying all dependencies attached to ''compile'' into a specific folder
task copylibs(type: Copy) {
//referring to the ''compile'' configuration
from configurations.compile, configurations.testCompile
into ''libs''
}
</pre>
Запускать при изменении зависимостей:
<pre>
> gradlew copylibs
</pre>
В source code repository не класть!
Альтернатива - "gradle eclipse plugin":https://docs.gradle.org/current/userguide/eclipse_plugin.html
Но .classpath генерируется не переносимый, в source code repository его не положишь.