Руководство Gradle для начинающих

Введение
Создать Gradle Project
Конфигурация Gradle
Объяснение правил работы Gradle
Просмотр Local Repository
Конфигурация местоположения Gradle
Просмотр Gradle Repository в интернете

1. Введение

Для начала нужно удостовериться, что вы установили Gradle в Eclipse. Если вы еще не установили, то можете посмотреть инструкцию по ссылке:

Установить Buildship для Eclipse - плагин Gradle для Eclipse

Цель статьи:

Это изображение Project после завершения:

2. Создать Gradle Project

В Eclipse выбрать "New/Other"

В первом запуске, Eclipse скачает программные обеспечения Gradle.

По умолчанию, программное обеспечение Gradle будет скачано с помощью Eclipse и установлено в C:/Users/{username}/.gradle. Вы можете конфигурировать, чтобы поменять его местоположение, этот вопрос будет упомянут в аппендиксе в конце данной инструкции.

Ваш Gradle Project создан. Структура похожа на Maven project.

Заметьте, что это структура Gradle Project:

src/main/java - Место содержащее все исходные коды java
src/test/java - Место содержащее все исходные коды java для теста
build.gradle - Файл использующийся для build project (построения проекта), и объявления библиотеки
settings.gradle - Файл содержаций нужные настройки.

3. Конфигурация Gradle

build.gradle это файл чтобы вы конфигурировали библиотеки, которые будут использованы в project. Похож на pom.xml в Maven Project.

Открыть файл build.gradle для конфигурации библиотек, которые будут использованы:

Добавить код:

// https://mvnrepository.com/artifact/org.apache.commons/commons-lang3

compile group: 'org.apache.commons', name: 'commons-lang3', version: '3.0'

Примечание: Eclipse на данный момент не обновляет автоматически classpath библиотек, когда меняется файл build.gradle. Вам нужно выбрать Gradle/Refresh Gradle Project из context menu в project чтобы сделать это.

Если новая библиотека объявлена в build.gradle, они будут скачаны в локальный компьютер.

Создать класс CheckNumeric

package org.o7planning.hellogradle;


import org.apache.commons.lang3.StringUtils;

public class CheckNumeric {

    public static void main(String[] args) {
        String text1 = "0123a4";
        String text2 = "01234";

        boolean result1 = StringUtils.isNumeric(text1);
        boolean result2 = StringUtils.isNumeric(text2);

        System.out.println(text1 + " is a numeric? " + result1);
        System.out.println(text2 + " is a numeric? " + result2);

    }

}

Запустить класс CheckNumeric и получить результаты:

0123a4 is a numeric? false
01234 is a numeric? true

Вы можете увидеть какие библиотеки использует ваш project. И их расположение на жестком диске.

4. Объяснение правил работы Gradle

Выше вы создали project и он идеально работает. Project использует StringUtils это класс Apache, который не находится в стандартной библиотеке JDK в Java. Традиционно, вам нужно копировать библиотеку в Project и объявить ClassPath. Но в инструкции совершенно не нужно копировать библиотеку и объявлять classpath как традиционно. Управление библиотеки выполняется с помощью Gradle. Теперь мы объясним как работает Gradle.

Изображение выше показывает способ работы Gradle.

Объявите на build.gradle что ваш project зависит от библиотеки common-lang3 версии 3.0.
Сразу после того как вы обновили project используя инструменты Gradle. Gradle проверит существует ли данная библиотека в локальном репозитории (Local Repository) на вашем компьютере. Если нет то он скачает эту библиотеку из репозитория с интернета.
В конце, Gradle автоматически объявит ClassPath для Project указывающий на местоположение скачанного файла jar.

Поэтому вам только нужно объявить все библиотеки, которые вы хотите использовать в build.gradle. Библиотеки управляются с помощью Gradle.

5. Просмотр Local Repository

Ваш вопрос это где находится локальный репозиторий (Local Repository)?

По умолчанию Gradle скачан с помощью Eclipse и установлен в C:/Users/{username}/.gradle. Файлы библиотеки использующиеся в вашем project так же скачаны с интернета и установлены в подпапке той папки.

6. Конфигурация местоположения Gradle

По умолчанию, программное обеспечение Gradle будет скачано с помощью Eclipse и установлено в C:/Users/{username}/.gradle. Вы можете конфигурировать чтобы изменить его местоположение.

Window/References:

Нажать на правую кнопку мыши на project и выбрать Gradle/Refresh Gradle Project, Gradle будет скачан и установлен в папку которую вы настроили.