IntelliJ 의 Gradle Settings

[occidere]

IntelliJ 의 Gradle Settings

환경

• IntelliJ 버전: 2020.3

화면

설명

1. Gradle user home

• Gradle 캐시, 다운받은 파일 등을 저장할 경로.
• 만약 GRADLE_HOME 또는 PATH 와 같은 환경변수에 Gradle 경로가 이미 정의되어 있다면, IntelliJ 는 이 경로를 기본값으로 사용하도록 찾아서 제안해줌.
• 반대로 환경변수로 명시가 되어있지 않다면, 수동으로 클릭해서 설정할 수 있음.
• 여기에 설정한 값은 환경변수로 저장된 값보다 높은 우선순위를 갖는것에 유의할 것.
• IntelliJ 는 또한 homebrew 패키지 매니저로 설치한 커스텀 Gradle 경로도 지원함.

2. Generate *.iml files for modules imported from Gradle

• .iml 파일과 라이브러리 파일들이 idea.system.path 대신 .idea 디렉토리에 저장됨
• 이 옵션은 다음과 같은 경우에 유용함
  • .idea 디렉토리가 project-level 세팅으로 저장되어 있기에, 버전 컨트롤 시스템(Git 등)을 통해 IDE 에 특정적인 모듈 세팅을 공유하는 경우. 그리고 또한 build.gradle 파일에 프로젝트 세팅 설명을 추가하기 위해 gradle-idea-ext 플러그인을 사용할 수도 있음
  • 일반 IntelliJ IDEA 모듈과 Gradle 모듈을 둘다 가지고 있는 경우 정확하게 프로젝트를 열기 위한 경우
  • 프로젝트 오픈 시 IntelliJ IDEA 가 .iml 파일을 제일 먼저 읽고 import 프로세스를 실행하기 때문에 프로젝트 오픈 속도를 향상시키고 싶은 경우

만약 Gradle project 에 변경이 발생한 경우 .iml 파일도 같이 변경되기 때문에 VCS 로 관리중이라면 같이 push 해줘야 함

3. Gradle projects

• IntelliJ IDEA 로 작업할 때 몇몇 Gradle projects 들을 연결시킬 수 있음. 이 때, 선택한 프로젝트들을 각각 설정할 수 있음

4. Download external annotations for dependencies

• 이 체크박스를 선택하면 IntelliJ IDEA 는 JetBrains public repository 에서 external annotations 파일들을 저장함.
  • ex) 사진에서 화살표가 가리키는 것들

5. Build an run

• IntelliJ IDEA 가 선택된 프로젝트의 테스트 실행, 빌드, task 실행 시 어떤 옵션을 사용할 것인지 명시

6. Build and run using

• 프로젝트 빌드 및 실행 시 어떤 옵션을 사용할 것인지 선택. Use Gradle 이 기본값이며, IntelliJ IDEA 를 선택할 수도 있음
• 메인 메뉴에서 Build | Build Project 선택 시 IntelliJ IDEA 는 모듈 내 모든 소스들에 대해 Gradle classes 태스크를 실행함.
• 만약 순수하게 Java 또는 Kotlin 만으로 이뤄진 프로젝트라면 IntelliJ IDEA 를 이용한 빌드가 좀더 좋을 수도 있음. IntelliJ IDEA 는 빌드 속도를 극적으로 빠르게 할 수 있는 incremental build 를 지원함. 하지만, IntelliJ IDEA 컴파일러는 Gradle project 빌드 프로세싱의 일부 기능을 지원하지 않기 때문에 프로젝트 빌드가 제대로 안될 수도 있음.

7. Run tests using

• 테스트 실행 시 어떤 옵션을 사용할 것인지 선택. Use Gradle 이 기본값이며, IntelliJ IDEA 를 선택할 수도 있음

8. Use Gradle from

• 프로젝트에 사용할 Gradle 버전을 설정하기 위해 사용. 아래 옵션중 하나를 선택할 수 있음
  • gradle-wrapper.properties file: 권장되는 기본 옵션으로, Gradle Wrapper 를 사용함
    • 이 경우 Gradle 에게 Gradle 버전 업데이트를 위임하며, 빌드를 위해 필요한 Gradle 을 자동으로 다운받음. 이 옵션은 빌드를 위한 정확한 특정 버전의 Gradle 을 사용할 수 있게 해줌. Gradle 버전은 프로젝트 내 gradle 디렉토리의 gradle-wrapper.properties 파일에 저장되며, Gradle 버전으로 인한 문제 발생 가능성을 없애줌.
  • 'wrapper' task in Gradle build script: 이 옵션을 선택하면 Gradle wrapper 가 wrapper task 설정에 따라 설정됨. 이는 프로젝트에서 특정 버전의 Gradle 을 사용하고자 할 때 편리함.
    • 만약 기본 Gradle wrapper 옵션을 사용하던 상태에서 Gradle wrapper task 설정으로 바꾸게 되면, task 내에서 변경된 내용들은 프로젝트 import 과정에서 자동으로 적용됨.
  • Specified location: 이 옵션은 Gradle wrapper 를 사용하지 않고 특정 버전의 Gradle 을 직접 다운받아서 사용하고 싶을 때 선택할 수 있음. Gradle 이 설치된 경로를 명시하면 됨.

9. Gradle JVM

• Gradle project 를 import 하거나 tasks 들을 수행할 때 IntelliJ IDEA 가 어떤 JVM 을 바탕으로 Gradle 을 실행시킬 것인지 선택. 프로젝트에서 사용중인 JDK 를 기본값으로 사용함
• 이 값은 다른 Gradle 의 JVM 을 선택하는 옵션들보다 높은 우선순위를 가짐. IntelliJ IDEA 가 어떻게 Gradle JVM 버전을 선택하는지에 대한 과정은 Gradle JVM selection 섹션에서 확인 가능.

참고

• https://www.jetbrains.com/help/idea/gradle-settings.html