Установка Gradle на Ubuntu 18.04

Логотип Gradle и схема сборки проекта

Краткая справка

Gradle — свободный инструмент сборки для Java и других JVM-проектов. Использует DSL на базе Groovy (или Kotlin), интегрируется с Android Studio, IntelliJ IDEA, Eclipse и NetBeans. Для работы Gradle требуется установленная JDK.

Требования

Сервер или машина с Ubuntu 18.04.
Доступ root или пользователь с sudo.
Рабочее подключение к интернету для загрузки пакетов.

Перед началом

Обновите систему до последних пакетов и перезагрузите сервер, если это необходимо:

apt-get update -y
apt-get upgrade -y

Затем установите утилиты загрузки и распаковки:

apt-get install wget unzip -y

Важно: выполняйте команды от имени пользователя с правами sudo или root.

Установка Java

Gradle требует JDK. Установите пакет по умолчанию:

apt-get install default-jdk -y

Проверьте версию Java:

java -version

Ожидаемый пример вывода (может отличаться по версии):

openjdk version "11.0.4" 2019-07-16
OpenJDK Runtime Environment (build 11.0.4+11-post-Ubuntu-1ubuntu218.04.3)
OpenJDK 64-Bit Server VM (build 11.0.4+11-post-Ubuntu-1ubuntu218.04.3, mixed mode, sharing)

Установка Gradle через PPA

Этот способ простой и подходит для быстрого развертывания системного пакета Gradle.

Установите зависимости:

apt-get install apt-transport-https dirmngr wget software-properties-common -y

Импортируйте GPG-ключ репозитория:

apt-key adv --keyserver keyserver.ubuntu.com --recv-keys D7CC6F019D06AF36

Ожидаемый пример вывода, подтверждающий импорт ключа:

Executing: /tmp/apt-key-gpghome.XFiNpS59rU/gpg.1.sh --keyserver keyserver.ubuntu.com --recv-keys D7CC6F019D06AF36
gpg: key D7CC6F019D06AF36: public key "Launchpad PPA for Cheng-Wei Chien" imported
gpg: Total number processed: 1
gpg:               imported: 1

Добавьте PPA и установите Gradle:

add-apt-repository ppa:cwchien/gradle
apt-get update -y
apt-get install gradle -y

Проверьте установку:

gradle -v

Пример вывода для Gradle 5.6.3 (в вашем случае версия может отличаться):

Welcome to Gradle 5.6.3!

Here are the highlights of this release:
 - Incremental Groovy compilation
 - Groovy compile avoidance
 - Test fixtures for Java projects
 - Manage plugin versions via settings script

For more details see https://docs.gradle.org/5.6.3/release-notes.html


------------------------------------------------------------
Gradle 5.6.3
------------------------------------------------------------

Build time:   2019-10-18 00:28:36 UTC
Revision:     bd168bbf5d152c479186a897f2cea494b7875d13

Kotlin:       1.3.41
Groovy:       2.5.4
Ant:          Apache Ant(TM) version 1.9.14 compiled on March 12 2019
JVM:          11.0.4 (Ubuntu 11.0.4+11-post-Ubuntu-1ubuntu218.04.3)
OS:           Linux 4.15.0-20-generic amd64

Установка Gradle из официального архива (binary)

Этот способ подходит, когда нужна конкретная версия Gradle или изоляция от системных пакетов.

Загрузка Gradle

Перейдите в /opt и скачайте бинарный архив (пример для 5.6.4):

cd /opt/
wget https://services.gradle.org/distributions/gradle-5.6.4-bin.zip

Распакуйте архив:

unzip gradle-5.6.4-bin.zip

Проверьте содержимое папки:

ls /opt/gradle-5.6.4

Ожидаемый вывод:

LICENSE  NOTICE  bin  getting-started.html  init.d  lib  media

Настройка переменных окружения

Создайте скрипт в /etc/profile.d для системной доступности Gradle:

nano /etc/profile.d/gradle.sh

Добавьте:

export GRADLE_HOME=/opt/gradle-5.6.4
export PATH=${GRADLE_HOME}/bin:${PATH}

Сделайте скрипт исполняемым и загрузите переменные:

chmod +x /etc/profile.d/gradle.sh
source /etc/profile.d/gradle.sh

Проверка установки

gradle -v

Пример вывода для Gradle 5.6.4:

Welcome to Gradle 5.6.4!

Here are the highlights of this release:
 - Incremental Groovy compilation
 - Groovy compile avoidance
 - Test fixtures for Java projects
 - Manage plugin versions via settings script

For more details see https://docs.gradle.org/5.6.4/release-notes.html


------------------------------------------------------------
Gradle 5.6.4
------------------------------------------------------------

Build time:   2019-11-01 20:42:00 UTC
Revision:     dd870424f9bd8e195d614dc14bb140f43c22da98

Kotlin:       1.3.41
Groovy:       2.5.4
Ant:          Apache Ant(TM) version 1.9.14 compiled on March 12 2019
JVM:          11.0.4 (Ubuntu 11.0.4+11-post-Ubuntu-1ubuntu218.04.3)
OS:           Linux 4.15.0-65-generic amd64

Когда стоит выбирать PPA, а когда — архив

PPA: быстро, удобно, системный пакет обновляется через apt. Подходит для серверов, где важна простота администрирования.
Архив в /opt: контроль версии, можно иметь несколько версий параллельно, не влияет на системные пакеты. Подходит для CI/CD и сред разработки.

Важно: PPA может содержать другие версии и политики обновлений; для критичных систем выбирайте проверенные репозитории.

Альтернативный способ установки

SDKMAN (для локальных рабочих станций и разработчиков): управление версиями Gradle и Java, переключение между версиями на лету. Команда: curl -s “https://get.sdkman.io” | bash

Советы по безопасности и сопровождению

Проверяйте подписи/хэши архивов при установке из интернета.
Ограничьте доступ к /opt и скриптам в /etc/profile.d правами root.
При использовании PPA следите за поддержкой и доверяйте источнику.

Типичные проблемы и их решение

“gradle: команда не найдена” — убедитесь, что PATH настроен и вы выполнили source /etc/profile.d/gradle.sh или перезагрузили сессию.
Конфликты версий Java — проверьте java -version и при необходимости установите нужную JDK или используйте update-alternatives.

Чек-лист перед использованием Gradle

JDK установлен и корректно настроен (java -version).
Gradle доступен в PATH (gradle -v).
Переменные GRADLE_HOME и PATH добавлены в /etc/profile.d/ для системного доступа.
Понимаете, какой способ установки выбрали: PPA или архив.

Критерии приёмки

gradle -v выводит версию без ошибок.
Команда gradle выполняет сборку тестового проекта (например, ./gradlew build) при корректной конфигурации.
Системные переменные доступны для всех пользователей (если требуется).

Часто задаваемые вопросы

Нужна ли конкретная версия Java для Gradle?

Gradle требует установленной JDK; для каждой версии Gradle есть рекомендованные версии JDK в официальной документации. В подавляющем большинстве случаев OpenJDK 8 или 11 подходят.

Можно ли установить несколько версий Gradle одновременно?

Да: храните версии в /opt/gradle-<версия> и переключайте PATH или используйте SDKMAN для управления версиями.

Как обновить Gradle, установленный через PPA?

Обновление выполняется стандартно через apt: apt-get update && apt-get upgrade.

Итог

Вы успешно установили Gradle на Ubuntu 18.04 одним из двух способов: через PPA или из официального архива. Проверьте версию и интеграцию с JDK, используйте рекомендуемый способ в зависимости от целей (простота vs контроль версий).

Важно: если возникнут ошибки или нужна помощь с конкретным проектом Gradle — опишите проблему и мы поможем.