Прелоадер
Отключить Preloader

Gradle

Обязательные плагины: Gradle, Gradle Extension (установлен и включен по умолчанию)

IntelliJ IDEA поддерживает полнофункциональную интеграцию с Gradle, которая помогает автоматизировать процесс сборки. Вы можете легко создать новый проект Gradle, открыть и синхронизировать существующий, работать с несколькими связанными проектами одновременно и управлять ими.

Создать новый проект Gradle

  1. Запустите мастер создания нового проекта (New Project wizard). Если в IntelliJ IDEA в настоящий момент не открыто ни одного проекта, нажмите Создать новый проект (Create New Project) на экране приветствия. В противном случае выберите Файл | Новый | Проект (File | New | Project) из главного меню.
  2. Выберите Gradle из вариантов слева.

  3. Укажите SDK проекта и дополнительную платформу или библиотеку (IntelliJ IDEA добавляет соответствующий плагин в файл build.gradle).

    Если у вас нет JDK на вашем компьютере, IntelliJ IDEA может быстро загрузить JDK для вас.

    Синхронизация проекта Gradle будет ожидать загрузки JDK.

    Нажмите Next.
    • GroupId - groupId нового проекта. Вы можете опустить это поле, если планируете развернуть свой проект локально.

    • ArtifactId - artifactId, который добавляется как имя вашего нового проекта.

    • Version - По умолчанию это поле указывается автоматически. На следующей странице мастера укажите поля, похожие на координаты Maven. Эти параметры могут быть полезны, если вы решите развернуть свой проект в репозитории Maven. Указанные вами поля добавляются в файл build.gradle.

  4. Для получения дополнительной информации о координатах Maven см. Соглашения об именах Maven.

    Если указан родительский проект Gradle, указанные поля могут быть унаследованы (нажмите Inherit) от родительского.
    Нажмите Next.
  5. Укажите название и настройки местоположения. Нажмите Finish.

Открытие существующего проекта Gradle

Если в вашем проекте включен автономный режим (offline mode), открытие или повторный импорт проекта может завершиться неудачно. Чтобы решить эту проблему, отключите автономный режим и повторно импортируйте ваш проект.

  1. Если в IntelliJ IDEA в настоящий момент не открыто ни одного проекта, нажмите Open или Import на экране приветствия. В противном случае выберите File | Open из главного меню.

     Если у вас есть несколько пользовательских плагинов, которые требуют импорта проекта из модели IntelliJ IDEA, нажмите Ctrl + Shift + A и найдите действие Project from Existing Sources.

  2. В открывшемся диалоговом окне выберите каталог, содержащий проект Gradle, и нажмите ОК.

    IntelliJ IDEA открывает и синхронизирует проект в IDE.

Если вам нужно настроить параметры настройки Gradle, обратитесь к настройкам Gradle.

Проверьте Gradle JVM и уровень языка (language level)

  • Gradle JVM: когда IntelliJ IDEA открывает проект Gradle, она проверяет файл gradle.properties на наличие соответствующей версии JVM, указанной в org.gradle.java.home, и использует ее для проекта. Если он не указан, используется SDK проекта. Кроме того, вы можете использовать настройки Gradle для настройки Gradle JVM.

  •  Language level (Уровень языка): настройки уровня языка применяются для исходного корня (source root) или для модуля. Если проект Gradle имеет один связанный проект (linked project), то уровень языка проекта по умолчанию устанавливается на минимальный уровень языка среди уровней языка модуля. Уровень языка модуля установлен в sourceCompatibility в файле build.gradle.
  • Часть предварительного просмотра устанавливается на соединение флагов предварительного просмотра исходных наборов модулей. Уровень языка модуля исходного набора устанавливается на соответствующую комбинацию свойства sourceCompatibility и флага --enable-preview.

Вы можете иметь несколько проектов Gradle в одном проекте IntelliJ IDEA. Это может быть полезно, если вы храните части кода в разных проектах, имеете несколько устаревших проектов, над которыми вам нужно работать, имеете составную сборку Gradle (Gradle composite build) или работаете с микросервисами (microservices). Вы можете связать такие проекты в IntelliJ IDEA и управлять ими одновременно.

 Когда вы открываете проект Gradle, ссылка проекта устанавливается автоматически и окно инструмента Gradle (Gradle tool window) активируется.

Если проект IntelliJ IDEA не связан с проектом Gradle, то окно инструмента Gradle (Gradle tool window) отключено. В этом случае IntelliJ IDEA отображает сообщение со ссылкой, которая позволяет быстро импортировать проект Gradle и включить окно инструмента Gradle. Если окно инструмента Gradle активно, то у вас есть по крайней мере один связанный проект Gradle.

  1. Откройте Gradle tool window.

  2. В Gradle tool window нажмите the Link Gradle Project icon , чтобы прилинковать проект Gradle.

  3. В открывшемся диалоговом окне выберите нужный файл build.gradle и нажмите ОК.

  4. В Import Module из окна Gradle укажите параметры для проекта Gradle, который вы пытаетесь прилинковать, и нажмите ОК.

    Проект прилинкован. Окно инструмента Gradle (Gradle tool window) показывает панель инструментов (toolbar) и древовидное представление объектов Gradle.

Если вам нужно прилинковать ранее не прилинкованный проект, в окне Project tool щелкните правой кнопкой мыши по добавленному build.gradle или, если это модуль Gradle Kotlin, по файлу build.gradle.kts и выберите Import Gradle Project.

Добавление нового модуля Gradle в существующий проект Gradle

Вы можете добавить модуль Gradle в проект, в котором вы уже работаете.

  1. В проекте в главном меню выберите File| New | Module для открытия мастера нового модуля (New Module wizard).

  2. Если существующий проект не является проектом Gradle, то процесс добавления модуля аналогиченсозданию нового проекта Gradle. Если существующий проект является проектом Gradle, процесс добавления нового модуля будет короче. Вам необходимо указать имя вашего модуля в поле ArtifactId. Остальная информация добавляется автоматически, и вы можете использовать настройки по умолчанию или изменить их в соответствии со своими предпочтениями. Также обратите внимание, что в поле Add as module по умолчанию отображается имя вашего проекта, к которому вы пытаетесь добавить модуль. Вы можете нажать Add module, чтобы выбрать другое имя, если у вас есть другие прилинкованные проекты Gradle.

Доступ к настройкам Gradle

Используйте параметры Gradle (Gradle settings) для настройки действий по сборке и запуску для каждого прилинкованного проекта Gradle, версии Gradle, импорта изменений проекта и т. Д.

  1. В диалоговом окне Settings/Preferences Ctrl + Alt + S, перейдите в Build, Execution, Deployment| Gradle.

 

Gradle settings

Нажмите Gradle Settings на панели инструментов в окне инструмента Gradle, чтобы получить доступ к настройкам Gradle.

  1. На странице настроек Gradle настройте доступные параметры и нажмите OK, чтобы сохранить изменения.

Настройка версии Gradle для проекта

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

  1. Выберите the Gradle settings icon в окне инструмента Gradle для быстрого доступа к странице настроек Gradle.

    Gradle settings

     

  2. В списке Use Gradle from из списка выберите один из следующих параметров:
    • 'gradle-wrapper.properties' file: это рекомендуемая опция по умолчанию, в которой используется Gradle wrapper.

      В этом случае вы делегируете обновление версий Gradle в Gradle и получаете автоматическую загрузку Gradle для сборки. Эта опция также позволяет вам производить сборку с точной версией Gradle. Версия Gradle сохраняется в файле gradle-wrapper.properties в каталоге gradle вашего проекта и помогает устранить любые проблемы версии Gradle.

    • 'wrapper' task in Gradle build script: выберите эту опцию, чтобы настроить Gradle wrapper в соответствии с wrapper task configuration. Это может быть удобно, если вы предпочитаете контролировать, какую версию Gradle использовать в проекте.

      Если вы использовали опцию Gradle wrapper по умолчанию, а затем переключились на конфигурацию Gradle wrapper task, изменения, внесенные в задачу, автоматически обновятся во время импорта проекта.

    • Specified location: выберите эту опцию, если вы хотите вручную загрузить и использовать определенную версию Gradle. Укажите местоположение вашей установки Gradle и JVM, в которой IntelliJ IDEA будет запускать Gradle при импорте указанного проекта Gradle и при выполнении его задач.

    Нажмите кнопку ОК, чтобы сохранить изменения.

Добавление параметров VM для проекта Gradle

Вы можете указать параметры VM для своего проекта Gradle, используя файл gradle.properties.

  1. Создайте или откройте свой проект Gradle.

  2. В окне инструмента Project щелкните правой кнопкой мыши по проекту и в контекстном меню выберите New | File.

  3. В диалоговом окне New File введите gradle.properties в качестве имени файла и нажмите ОК.

  4. Откройте созданный файл в редакторе и добавьте необходимые параметры виртуальной машины VM .

     

    the gradle.properties file

     

Для получения дополнительной информации обратитесь к документации Gradle.

Эта страница является переводом страницы из документации Intellij IDEA.