Android Studio를 사용하며 자주 겪는 Gradle 관련 오류 해결 방법

오래간만에 Android Studio 를 사용하다 자주 겪게 되는 오류 메시지의 대처법에 대해 간단히 다루어 보겠습니다.

먼저, 가장 빈번하게 겪게 되는 오류입니다. 보통 다음과 유사한 메시지가 표시됩니다.

오전 11:31:31 Failed to refresh Gradle project 'ImmersiveMode'

The project is using an unsupported version of the Android Gradle plug-in (0.8.3).

Version 0.9.0 introduced incompatible changes in the build language.

Please read the migration guide to learn how to update your project.

Open migration guide, fix plug-in version and re-import project

이 문제는 빌드스크립트(build.gradle)에서 사용하는 안드로이드 Gradle 플러그인의 버전이 더 이상 호환되지 않아 생기는 문제이며, 대부분 빌드스크립트 내에 정의 된 플러그인 버전을 최신 버전으로 수정하면 해결됩니다.

아래 빌드스크립트에서 빨간 부분으로 표시된 부분이 빌드스크립트에서 사용할 플러그인 버전을 의미하며, 아래에서는 0.9 버전대를 사용하도록 설정하여 프로젝트 오류를 해결하였습니다. (이 글 작성 당시 플러그인의 최신 버전)

[build.gradle]

buildscript {

  repositories {

    mavenCentral()

  }

  dependencies {

    classpath 'com.android.tools.build:gradle:0.9.+'

  }

}

다음으로 발생하는 오류는 Gradle 버전이 맞지 않아 발생하는 오류입니다. 안드로이드 스튜디오 업데이트에 맞춰 사용하는 Gradle버전도 바뀌어 발생하는 문제인데요, 보통 다음과 같은 에러 메시지가 표시됩니다.

오전 11:28:15 Failed to refresh Gradle project 'ImmersiveMode'

The project is using an unsupported version of Gradle. Please use version 1.10.

Please point to a supported Gradle version in the project's Gradle settings or in the project's Gradle wrapper (if applicable.)

Fix Gradle wrapper and re-import project Gradle settings

이럴 때에는 프로젝트 경로/gradle/wrapper/gradle-wrapper.properties 파일을 열어 맨 아래 distributionsUrl의 맨 뒤 버전을 변경해주면 됩니다. (gradle-1.10-bin.zip → 1.10을 원하는 버전으로 변경)

[ProjectDir]/gradle/wrapper/gradle-wrapper.properties

#Wed Apr 10 15:27:10 PDT 2013

distributionBase=GRADLE_USER_HOME

distributionPath=wrapper/dists

zipStoreBase=GRADLE_USER_HOME

zipStorePath=wrapper/dists

distributionUrl=http\://services.gradle.org/distributions/gradle-1.10-bin.zip