Project

General

Profile

Gradle » History » Version 5

Alexey Demakov, 11/10/2015 02:24 PM

1 1 Alexey Demakov
h1. Gradle-based build system.
2
3
h2. История
4
5
Предыдущая версия системы сборки использовала Ant для управления сборкой и Ivy для управления зависимостями.
6
Система сборки представляла собой библиотечный Ant файл, который подключался к проекту и предоставлял 
7
базовую функциональность по сборке Java проектов и управлению выпуском релизов.
8
Gradle реализует и расширяет эту функциональность, поэтому принято решение использовать этот инструмент для сборки проектов.
9
10
h2. Ресурсы
11
12
http://gradle.org
13
14
h2. Подключение Gradle к проекту
15
16
h3. 1. Установить gradle, определить переменную окружения GRADLE_HOME.
17
18
h3. 2. В каталоге проекта выполнить команду создания конфигурационных файлов для Java проекта:
19
20
@> gradle init --type java-library@
21
22
Другие доступные типы проектов: https://docs.gradle.org/current/userguide/build_init_plugin.html
23
24
Также будет создана обертка-запускач gradlew/gradlew.bat, которая избавляет от необходимости вручную
25
устанавливать gradle для сборки проекта - разработчику достаточно просто выкачать рабочую копию проекта из репозитория,
26
gradle будет установлен автоматически.
27
28 3 Alexey Demakov
Имя проекта будет записано в settings.gradle. Gradle предполагает, что имя проекта совпадает с именем каталога проекта.
29
Если это не так, необходимо исправить имя проекта в файле settings.gradle.
30
31 1 Alexey Demakov
Дополнительная информация: 
32
https://docs.gradle.org/current/userguide/gradle_wrapper.html
33
https://docs.gradle.org/current/userguide/wrapper_plugin.html
34
35
h3. 3. Привести структуру папок в соответствие с соглашениями gradle:
36
37
src/main/java - код проекта
38
src/main/resources - ресурсы проекта
39
src/test/java - код тестов
40
41
Дополнительная информация:
42
https://docs.gradle.org/current/userguide/java_plugin.html#N12323
43
44
h3. 4. Указать зависимости проекта в build.gradle:
45
46
compile - зависимость, необходимая для сборки проекта
47
testCompile - зависимость, необходимая для сборки тестов
48
группа:имя:версия - формат зависимости
49
50 2 Alexey Demakov
<pre>
51 1 Alexey Demakov
dependencies {
52
    // The production code uses the SLF4J logging API at compile time
53
    compile ''org.slf4j:slf4j-api:1.7.12''
54
55
    // Declare the dependency for your favourite test framework you want to use in your tests.
56
    // TestNG is also supported by the Gradle Test task. Just change the
57
    // testCompile dependency to testCompile ''org.testng:testng:6.8.1'' and add
58
    // ''test.useTestNG()'' to your build script.
59
    testCompile ''junit:junit:4.12''
60
}
61 2 Alexey Demakov
</pre>
62 1 Alexey Demakov
63
Дополнительная информация: https://docs.gradle.org/current/userguide/java_plugin.html#sec:java_plugin_and_dependency_management
64
65 3 Alexey Demakov
h3. 5. Указать репозитории, в которых ищутся зависимости
66 1 Alexey Demakov
67 3 Alexey Demakov
build.gradle:
68 2 Alexey Demakov
<pre>
69 1 Alexey Demakov
repositories {
70
    // репозиторий ИСП РАН, подключается, если есть зависимости от наших проектов
71
    ivy {
72
      url = ''http://forge.ispras.ru/repo''
73
      layout ''pattern'', {
74
        artifact ''[organization]/[ext]s/[artifact]-[revision](.[ext])''
75
      }
76
    }
77
    // Use ''jcenter'' for resolving your dependencies.
78
    // You can declare any Maven/Ivy/file repository here.
79
    jcenter()
80
}
81
82 2 Alexey Demakov
</pre>
83 1 Alexey Demakov
Дополнительная информация: https://docs.gradle.org/current/userguide/dependency_management.html#sec:repositories
84 3 Alexey Demakov
85
h3. 6. Настроить опции компиляции Java
86
87
build.gradle:
88
<pre>
89
sourceCompatibility = JavaVersion.VERSION_1_8
90
targetCompatibility = JavaVersion.VERSION_1_8
91
92
compileJava {
93
  options.encoding = "UTF-8"
94
}
95
</pre>
96
97
Команда компилцяии Java файлов:
98
<pre>
99
> gradlew compileJava
100
</pre>
101
102
Компиляция и прогон тестов:
103
<pre>
104
> gradlew test
105
</pre>
106
107
Дополнительная информация: https://docs.gradle.org/current/userguide/java_plugin.html#N1245A
108
109
h3. 7. Подключить плагин для сборки дистрибутива
110
111
Для приложений (дистрибутив содержит библиотеки и скрипты для запуска):
112
113
build.gradle:
114
<pre>
115
apply plugin: ''application''
116
...
117
mainClassName = "org.gradle.sample.Main"
118
</pre>
119
120
Для библиотек (application plugin подключает это автоматически):
121
build.gradle:
122
<pre>
123
apply plugin: ''distribution''
124
</pre>
125
126
Команда сборки дистрибутива
127
<pre>
128
> gradlew distZip
129
</pre>
130
или
131
<pre>
132
> gradlew distTar
133
</pre>
134
оба сразу:
135
<pre>
136
assembleDist
137
</pre>
138
139
Дополнительная информация: 
140
https://docs.gradle.org/current/userguide/distribution_plugin.html
141
https://docs.gradle.org/current/userguide/application_plugin.html
142
143
144
h3. 8. Подключить плагин для выпуска релизов
145
146
build.gradle:
147
<pre>
148
// в начало файла
149
import java.text.SimpleDateFormat
150
import java.util.regex.Matcher
151
import org.gradle.api.Project
152
153
plugins {
154
  id ''net.researchgate.release'' version ''2.3.4''
155
}
156
157
...
158
159
// в конец файла
160
release {
161
  failOnCommitNeeded = false
162
163
  versionPatterns = [
164
    // Increments build number: "0.2.5-alpha-150428" => "0.2.6-alpha-150428"
165
    /(^\d+\.\d+\.)(\d+)(-[^-]*)(-[^-]*$)/: 
166
    { Matcher m, Project p -> m.replaceAll("${ m[0][1] }${ (m[0][2] as int) + 1 }${ m[0][3] }" ) }
167
  ]
168
}
169
170
task setReleaseData << {
171
  project.version=project.version+''-''+new SimpleDateFormat("yyMMdd").format(new Date())
172
}
173
174
confirmReleaseVersion.dependsOn setReleaseData
175
</pre>
176
177
Готовящаяся к выпуску версия (вместо текущей даты SNAPSHOT) хранится в файле gradle.properties:
178
<pre>
179
version=0.1.28-alpha-SNAPSHOT
180
</pre>
181
182
Команда выпуска новой версии:
183
<pre>
184
> gradlew release
185
</pre>
186
187
Будет предложено подтвердить или изменить номер выпускаемой версии, а затем номер следующей готовящейся версии.
188
189
Дополнительная информация: https://github.com/researchgate/gradle-release
190
191
Хорошо бы согласовать систему нумерации версий с "семантическим версионированием":http://semver.org/lang/ru/.
192
Есть плагин, поддерживающий этот подход: https://plugins.gradle.org/plugin/de.gliderpilot.semantic-release
193
194 4 Alexey Demakov
h3. 9
195
196 3 Alexey Demakov
Компиляция, прогон тестов и запуск инструментов статического анализа кода:
197
<pre>
198
> gradlew check</pre>
199 4 Alexey Demakov
200
h3. 10. Копирование зависимостей в подкаталог ''libs''
201
202
gradle скачивает зависимости куда-то в свой кэш.
203
Это неудобно при использовании eclipse.
204
Мы привыкли, что библиотеки лежат рядом.
205
Копировать их в подкаталог ''libs'' проекта можно так:
206
207
build.gradle
208
<pre>
209
//copying all dependencies attached to ''compile'' into a specific folder
210
task copylibs(type: Copy) {
211
  //referring to the ''compile'' configuration
212
  from configurations.compile, configurations.testCompile
213
  into ''libs''
214
}
215
</pre>
216
217
Запускать при изменении зависимостей:
218
<pre>
219
> gradlew copylibs
220
</pre>
221
222
В source code repository не класть!
223 5 Alexey Demakov
224
Альтернатива - "gradle eclipse plugin":https://docs.gradle.org/current/userguide/eclipse_plugin.html
225
Но .classpath генерируется не переносимый, в source code repository его не положишь.