Глава 3. Установка Gradle.

3.1 Необходимое ПО и библиотеки.

Для установки Gradle не обходим Java JDK (Java Development Kit) или JRE (Java Runtime Environment) версии 7 или выше (для проверки установленной версии, на используйте java -version). Вместе с Gradle идет своя собственная библиотека Groovy, так что отдельно ее ставить нет надобности. Любая другая установка Groovy будет проигнорирована.

Gradle использует тот JDK, который он найдет в вашем пути. В качестве альтернативы, вы можете установить переменную окружения JAVA_HOME на папку, в которую установлен желаемый JDK.



3.2 Загрузка.

Вы можете загрузить один из дистрибутивов Gradle с официального сайта.



3.3 Распаковка.

Дистрибутив Gradle упакован в ZIP-архив. Полный дистрибутив содержит:

  • Исполняемые файлы Gradle.
  • Руководство пользователя (HTML или PDF).
  • Справочное руководство по DSL.
  • Документацию по API в формате Javadoc.
  • Исчерпывающие примеры, включая те, который используются в этом учебнике, вместе с некоторыми полными и сложными сборками, которые вы можете использовать как отправную точку для вашей собственной сборки.
  • Исходные коды, но это только для справки. Если вы хотите собрать Gradle сами, то вам нужно загрузить дистрибутив исходных кодов или получить их из хранилища исходных кодов. Более подробно можно узнать здесь


3.4 Переменные окружения.

Для запуска Gradle, сначала добавьте переменную окружения GRADLE_HOME. Она должна указывать на распакованные файлы с сайта Gradle. Далее, добавьте GRADLE_HOME/bin в переменную окружения PATH. Обычно, этого достаточно для запуска Gradle.



3.5 Запуск и тестирование вашей установки.

Gradle запускается командой gradle. Для проверки правильности установки просто напечатайте gradle -v. В результате будет выведена версия и локальная конфигурация окружения (Groovy, версия JVM, операционная система и т.д.). Отображенная версия должна совпадать с версией скаченного вами дистрибутива.



3.6 Опции JVM.

Опции JVM для запуска Gradle можно установить через переменные окружения. Вы можете использовать GRADLE_OPTS или JAVA_OPTS, или обе сразу. По соглашению, JAVA_OPTS переменная окружения, которая используется многими приложениями Java. Обычный пример использования - установить HTTP-прокси в JAVA_OPTS и опции памяти в GRADLE_OPTS. Также эти переменные могут быть установлены в начала gradle или gradlew скрипта.

Обратите внимание, что на текущий момент установка опций JVM для Gradle в командной строке невозможна.