[Bug Fix] React Native Prebuild - gradlew 에러

지금까지 eas build에도 시간은 걸렸으나 에러는 발생하지 않았다. 그런데 이번에 google-services.json이나 FCM 서비스 계정 정보를 등록하면서 eas build에서 에러가 발생했다. EAS 무료 사용자이다 보니 작업 큐에서 시간을 너무 많이 사용하여 아래 명령어로 수행을 했다. eas build와 다르게 아래 명령어는 android 폴더를 생성하는 prebuild를 수행했다. 그러면서 gradle 에러가 발생하기 시작했다.

npx expo run:android

터미널 Error 메시지

에러의 원인을 파악하고 해결해본다.

 

eas-cli 업데이트

최신버전의 eas-cli로 업데이트 한다.

npm install -g eas-cli@latest

 

로컬에서 prebuild 테스트

빌드 전에 로컬에서 prebuild가 제대로 작동하는지 캐시를 제거하고 확인해본다. adroid 폴더가 생겼고 gradle 에러가 발생했다.

npx expo prebuild --clean

 

안드로이드 빌드 테스트

gradlew 명령어로 빌드 실패 로그를 열어볼 수 있다. 문제의 원인은 현재 Java 8을 사용하고 있지만, Expo SDK 53은 Java 11이상이 필요하다.

cd android && ./gradlew assembleDebug

---------------------------------------
FAILURE: Build failed with an exception.

* What went wrong:
Could not resolve all dependencies for configuration 'classpath'.
> Could not resolve project :gradle-plugin:settings-plugin.
  Required by:
      unspecified:unspecified:unspecified
   > Dependency requires at least JVM runtime version 11. This build uses a Java 8 JVM.
> Could not resolve project :expo-gradle-plugin:expo-autolinking-settings-plugin.
  Required by:
      unspecified:unspecified:unspecified
   > Dependency requires at least JVM runtime version 11. This build uses a Java 8 JVM.

* Try:
> Run this build using a Java 11 or newer JVM.
> Run with --stacktrace option to get the stack trace.
> Run with --info or --debug option to get more log output.
> Run with --scan to get full insights.
> Get more help at https://help.gradle.org.

BUILD FAILED in 11s

 

Java 버전 확인 및 해결

현재 java 버전을 확인해보고, 나는 블로그 글에 맞춰서 Java 11 설치 및 Windows 환경변수 설정을 해줬다. Java 11 SDK를 다운받기 위해서는 Oracle 홈페이지에 들어가서 로그인을 해줘야 한다. 그리고 Windows에서 인식할 수 있도록 아래에 있는 이미지처럼 JAVA_HOME 변수와 path에 java 11 bin 폴더의 경로를 추가해줬다.

java -version

JAVA 11 환경변수 설정

 

+) 로컬 빌드에서 Android Gradle plugin 버전 문제가 계속 발생해서 Java 17버전로 다시 설치해다.

+) 지금 사용하고 있는 버전: Gradle 9.0, Windows X64 Java SE Development Kit 17.0.12

 

빌드 재시도

새로운 환경변수 반영을 위해 터미널을 껐다가 켜준다. 캐시를 제거하고 다시 EAS 클라우드 빌드를 수행한다.

# 로컬 빌드
npx expo run:android

# EAS 빌드 실행 (클라우드에서 Java 11 사용)
eas build --platform android --profile development --clear-cache