▪︎ Gradle Wrapper 기초

▫︎ 빌드 권장 방식

• Gradle 빌드를 실행하는 권장 방법은 Gradle Wrapper 를 이용하는 것이다.

ㅤ

▫︎ Gradle Wrapper 초기화 과정

1. 서버에서 배포판을 다운로드
2. 배포판을 Gradle User Home에 저장하고 Unpack
3. Gradle User Home 에 저장된 배포판을 사용

ㅤ

▫︎ OS 에 따른 Wrapper 스크립트 파일 종류

• Linux / macOS : gradlew
• Windows : gradlew.bat

ㅤ

▫︎ 설치 방법

• wrapper 는 인터넷에서 다운로드 받는 것이 아니다.
• 로컬 머신 (컴퓨터) 에 설치된 Gradle 을 이용하여 gradlew wrapper 명령어로 wrapper 파일을 생성해야 한다.
• 설치 링크 : https://docs.gradle.org/current/userguide/installation.html#installation

ㅤ

▫︎ Wrapper 장점

1. 자동으로 특정 Gradle 버전을 다운로드 받고 사용한다.

2. 주어진 Gradle 버전에서의 프로젝트를 표준화한다.

   • 표준화 == 빌드 환경을 일관되게 유지

3. 다른 유저와 환경에서도 동일한 Gradle 버전을 공급한다.

4. Gradle 을 수동으로 설치할 필요 없이 Gralde 빌드를 실행시키기 쉽다.

   • 수동 설치처럼 프로그램 다운로드, 설치, Path 설정을 할 필요가 없다.
   • gradle 스크립트 명령어 (./gradlew) 로 자동 설치 및 빌드 가능하다.

ㅤ

▪︎ Gradle Wrapper 사용

• Gradle 실행 방법에는 두 가지가 존재한다.

  1. gradle 명령어 - 시스템에 설치된 Gradle 배포판 사용
  2. gradlew 또는 gradlew.bat 명령어 - Gradle Wrapper 사용

• Gradle Wrapper 를 사용하여 빌드를 실행하도록 강력 권장한다.

  • 빌드에 있어서 안정적이며, 제어 가능하며, 표준화된 실행을 보장한다.

• 터미널 실행 결과
  

ㅤ

▪︎ Gradle Wrapper 파일 이해

▫︎ gradle-wrapper.jar

• Gradle Wrapper 코드가 포함된 작은 jar 파일이다.

• 프로젝트를 위한 정확한 버전의 Gradle를 다운로드하고 설치하는 역할을 한다.

• wrapper 실행에 필요한 Java 클래스들이 컴파일된 형태다.

ㅤ

▫︎ gradle-wrapper.properties

• Gradlew Wrapper 를 위한 구성 속성들이 포함된 파일이다.

• Gradle 배포판의 다운로드 URL, 배포판 타입 등이 저장되어 있다.

ㅤ

▫︎ gradlew

• Unix 기반 시스템 (Linux, Mac) 용 셸 스크립트이다.

• gradle-wrapper.jar 을 실행하여 gradle 을 수동으로 설치하지 않고 tasks 를 처리한다.

ㅤ

▫︎ gradlew.bat

• Windows 기반 시스템의 배치 스크립트이다.

• gradlew 의 기능과 동일하며, Windows 시스템 위에서 실행된다는 차이점만 존재한다.

ㅤ

---

참고

• https://docs.gradle.org/current/userguide/gradle_wrapper_basics.html