[Gradle] Gradle 수동 다운로드 설치

📡 Gradle을 다운로드하는 이유는?

Gradle Wrapper가 지정한 버전이 로컬에 없을 때

android/gradle/wrapper/gradle-wrapper.properties 파일을 보면:

distributionUrl=https\://services.gradle.org/distributions/gradle-8.3-all.zip

이 URL에 명시된 Gradle 버전(예: 8.3)이 로컬에 없다면 자동으로 다운로드합니다.

✅ 1. 먼저, 수동 다운로드

브라우저에서 직접 접속하거나 사내망에서는 외부 다운로드 툴을 써서 아래 URL에서 받으세요:

📥 https://services.gradle.org/distributions/gradle-8.10.2-all.zip

파일 크기는 약 150MB 정도입니다.

✅ 2. 저장 위치

Flutter(Android)의 Gradle Wrapper가 이 파일을 자동으로 찾는 위치는:

C:\Users\YOUR_USERNAME\.gradle\wrapper\dists\​

이 디렉토리는 다음과 같이 구성되어야 합니다:

C:\Users\YOUR_USERNAME\.gradle\wrapper\dists\gradle-8.10.2-all\<해시>\gradle-8.10.2-all.zip​

✅ 3. 정확한 디렉토리 구조 만드는 법

① .gradle\wrapper\dists 경로 열기

explorer %USERPROFILE%\.gradle\wrapper\dists

② gradle-8.10.2-all 폴더 만들기

C:\Users\YOUR_USERNAME\.gradle\wrapper\dists\gradle-8.10.2-all\

③ 내부에 해시 디렉토리 만들기 (이 부분이 중요!)

Gradle이 내부적으로 생성하는 무작위 해시 폴더가 필요합니다.
자동으로 생성되도록 하려면 이렇게 하세요:

🎯 트릭: 일부러 flutter run 실행해 보기

flutter run

→ 에러가 다시 발생하더라도 이때 Gradle이 다음 경로에 해시 디렉토리를 생성합니다:

C:\Users\YOUR_USERNAME\.gradle\wrapper\dists\gradle-8.10.2-all\<랜덤한 해시 폴더>\

해당 폴더를 열어보면 gradle-8.10.2-all.zip.lck 같은 lock 파일만 있을 수 있습니다.

④ 그 폴더에 수동 다운로드한 .zip 복사

예:

C:\Users\YOUR_USERNAME\.gradle\wrapper\dists\gradle-8.10.2-all\a1b2c3d4e5f6g7h8i9j0\gradle-8.10.2-all.zip

그리고 lock 파일은 삭제해도 됩니다.

✅ 4. 다시 빌드

flutter clean
flutter pub get
flutter run

이제 Gradle을 다시 다운로드하지 않고, 로컬 .zip을 압축 해제해서 사용할 거예요.

📌 추가 팁: 완전 오프라인 모드 설정

Gradle이 인터넷에 접근 못 하도록 강제로 오프라인 빌드하려면:

flutter build apk --offline