반응형

"gradle project sync failed. basic functionality" 문제 해결하기


안녕하세요? Ready 입니다.

이번엔 안드로이드 프로젝트 생성 시 발생하는 에러 메세지 "gradle project sync failed." 문제를 해결해보도록 하겠습니다.


이 문제가 발생하는 원인은 gradle이 설치되어 있지 않거나 버전의 업데이트가 필요한 경우라고 보시면 됩니다.



문제 해결 방법



1. 최신 버전의 gradle을 https://gradle.org/install 에서 다운받습니다.


2. OS에 맞게 unpack 해줍니다.


 * Linux & MacOS

- 다운 받은 zip 파일로 디렉토리를 이동하신 후에 다음과 같이 명령어들을 입력해줍니다.


 * Windows

- 받으신 파일을 압축 해제 합니다.

- C:/Gradle 폴더를 생성해줍니다.

- 압축 해제한 폴더를 방금 생성한 C:/Gradle 폴더 안에 넣습니다. (ex - C:\Gradle\gradle-4.8.1)




3. 압축 해제한 폴더 내의 bin 경로를 Path 환경변수 설정 해줍니다.


 * Linux & MacOS

- 다음과 같은 명령어를 입력해줍니다.

(gradle-4.8.1은 현재 최신 버전 기준으로, 각자 다운 받은 버전에 맞게 이름을 변경해주시면 됩니다.)


$ export PATH=$PATH:/opt/gradle/gradle-4.8.1/bin


 * Windows

- '내 PC''의 속성에 들어가서 '고급 시스템 설정' - '환경 변수'를 클릭합니다.

- '시스템 변수'의 Path 항목을 선택하고 '편집'을 눌러 bin 폴더의 절대경로를 추가해줍니다.

  (ex- C:\gradle\gradle-4.8.1\bin)

- 확인 버튼을 누릅니다.


4. 콘솔 창(명령 프롬프트)을 열어서 "gradle -v" 명령 입력을 통해 gradle이 잘 설치되었는지 확인합니다.



5. 4번까지 모두 확인한 후에 다시 안드로이드 스튜디오를 실행하여 프로젝트를 확인해보시면 문제가 해결 됐음을 확인할 수 있을 겁니다!



반응형
  • 한비 2019.07.28 22:35

    에러 해결에 결정적인 도움을 받았습니다.
    근데 콘솔창에서 gradle -v 는 아래와 같은 에러를 냅니다.
    ---------------
    ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.

    Please set the JAVA_HOME variable in your environment to match the
    location of your Java installation.
    -----------
    운영체지는 윈10이고, 안드로이드 버전은 3.2이고 자바는 설치하지 않았습니다.
    근래의 안드로이드 버전은 자바를 설치하지 않아도 된다고 알고 있기 때문입니다.

    암튼 감사드립니다.

    • Favicon of https://readystory.tistory.com BlogIcon Dev. Ready Kim 2019.07.28 22:54 신고

      맞습니다. 안드로이드 스튜디오 2.2 버전 이상부터 OpenJDK를 포함하고 있습니다.

      하지만 설령 JDK를 설치하지 않아도 된다 하더라도 안드로이드 개발은 버전 호환이 중요하기 때문에 옛 버전이 호환될 수 있도록 자바를 설치하시는 것이 좋을 듯 보입니다ㅎㅎ

  • kkk 2019.09.02 10:51

    안드로이드스튜디오 내부에 JRE가 포함되어 jdk를 설치하지 않아도 무방합니다.

    • Favicon of https://readystory.tistory.com BlogIcon Dev. Ready Kim 2019.09.02 11:07 신고

      맞습니다. 정확하게는 안드로이드 스튜디오 2.2 버전 이상부터 최신 버전의 openJDK의 사본(JRE와는 다릅니다)을 자체적으로 포함하고 있기 때문에 사용자는 별도의 JDK를 설치하지 않아도 됩니다.
      그러나 최신 버전의 Java를 지원하지 않는 Android 버전에서도 호환되는 앱을 제작하기 위해서는 build.gradle에서 낮은 버전의 JDK로 컴파일 하겠다고 명시해주어야 하는데, 안드로이드 스튜디오는 최신 버전의 openJDK만 포함되어 있기 때문에 이때는 별도의 JDK를 설치해주어야 합니다.

반응형