[Build Gradle] Gradle Wrapper 란?

안녕하세요. 메로나입니다.

 

오늘은 Gradle Wrapper 파일에 대해 공부하겠습니다.

개발하실 때는 Gradle Wrapper를 건들지 않을 거예요! 알고 있으면 좋을 것 같아서 블로그에 남깁니다.

 

Gradle Wrapper는 무엇인가?

• Gradle 빌드를 실행하는데 권장되는 방법은 Gradle Wrapper를 사용하는 것입니다.
• Wrapper 스크립트는 선언된 Gradle 버전을 호출하며, 필요한 경우 미리 다운합니다.
• 프로젝트에서 gradle 폴더 -> wrapper 폴더 -> gradler-wrapper 파일이 있습니다. 

프로젝트 wrapper 파일

 

 

gradle-wrapper.properties 파일 안에는 무엇이 적혀있을까?

프로젝트 gradle-wrapper.properties 파일

 

• distributionBase : Gradle 배포 파일이 저장될 기본 디렉터리
• GRADLE_USER_HOME : 사용자 시스템의 Gradle 홈 디렉터리에 저장됨.
• distributionPath : Gradle 배포 파일이 저장될 하위 경로를 설정
• distributionUri : gradle-8.9를 다운로드할 공식 사이트(-bin이란 바이너리만 포함된 Gradle 버전을 뜻함.)
• zipStoreBase : gradle-8.9를 다운로드하면 캐시 될 디렉터리
• zipStorePath : gradle-8.9 캐시 될 디렉터리 경로를 설정
• 배포파일 : Gradle 실행에 필요한 프로그램 파일과 라이브러리가 포함된 패키지

Gradle Wrapper 작동 방식

 

1. Wrapper는 gradle-wrapper.properties 파일을 참조하여 distributionUri에 지정된 URL에서 Gradle 배포 파일을 다운합니다.

2. 다운로드된 파일은 distributionBase와 distributionPath에 지정된 경로에 저장됩니다.

3. Gradle Wrapper는 해당 배포 파일을 사용해 프로젝트 실행합니다.

 

distributionBase / distributionPath

• Gradle 배포 파일이 압축 해제된 후 저장될 경로를 정의합니다.
• 이 경로에 Gradle 실행에 필요한 파일이 준비되고, 실제 빌드 작업에 사용됩니다.

zipStoreBase / zipStorePath

• Gradle 배포 파일 (예: gradle-8.9-bin.zip)이 압축 파일 형태로 캐시 될 경로를 정의합니다.
• 다운로드된 ZIP 파일은 이 경로에 저장됩니다.

gradle-wrapper.jar 파일은 무엇이니?

Gradle Wrapper 코드가 포함된 작은 파일입니다.

프로젝트에 맞는 Gradle 버전을 다운로드하고, 설치해야 합니다.(아직 설치되지 않은 경우)

 

해당 wrapper 파일은 절대 변경하면 안 된다고 문서에 작성되어 있네요.. ㅎㅎ

개발하면서 건들지 않은 이유가 있었어요! 

개발하면서 한 번쯤 본 적은 있지만, 왜 있는지 몰랐는데 알게 되었습니다!

문서도 꼭 읽어보세요. 참고문헌에 남기겠습니다. 이상입니다~

 

참고문헌

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