[Gradle] Android Studio & Unity Gradle version

Android Studio

일반적으로 사용되고 있는 빌드 환경인 Android Studio에서의 Gradle은

• Android Studio는 Gradle을 기반으로 빌드한다.

• Android Studio에서는 Android를 위해 기능이 추가된 Android Gradle Plugin이라는 라이브러리를 사용한다.

• Android Gradle Plugin은 Gradle에 의존성을 가지기 때문에 서로 호환되는 버전을 사용해야 한다.

 

Gradle version과 Android Gradle Plugin의 정의

• Gradle version: gradle-wrapper.properties파일의 distributionUrl

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

• Android Gradle Plugin: Project의 build.gradle의 dependencies

    dependencies {
        ...
        classpath 'com.android.tools.build:gradle:3.5.1'
    }

Android Gradle & Plugin Version

Plugin version	Required Gradle version
1.0.0-1.1.3	2.2.1-2.3
1.2.0-1.3.1	2.2.1-2.9
1.5.0	2.2.1-2.13
2.0.0-2.1.2	2.10-2.13
2.1.3-2.2.3	2.14.1+
2.3.0+	3.3+
3.0.0+	4.1+
3.1.0+	4.4+
3.2.0-3.2.1	4.6+
3.3.0-3.3.3	4.10.1+
3.4.0-3.4.3	5.1.1+
3.5.0-3.5.4	5.4.1+
3.6.0-3.6.4	5.6.4+
4.0.0+	6.1.1+
4.1.0+	6.5+

---

Unity

• Unity의 경우 빌드 시 내장 Gradle을 사용한다.
• Android Gradle Plugin은 Android Studio에 의존성이 걸려있다.

 

빌드 중 Gradle에 의하여 에러가 나는 경우

※ Error Message: 

Gradle build failed. Gradle Build Error: Gradle version 5.4.1 is required. Current version is 4.6.

 

이 경우 유니티 내의 Gradle version을 올리면 해결할 수 있다.

유니티 내부 Gradle version을 올리는 방법으로는 유니티 gradle version의 lib폴더를 업데이트할 gradle version의 lib 폴더로 교체하면 된다.

 

이 작업시에는 유니티를 종료하고 해야 하며 혹시 모르니 원본을 백업해놓도록 하자.

 

경로는 유니티 기본 설치폴더 및 안드로이드 스튜디오 기본 설치 폴더를 기준으로

 

유니티 Gradle경로

C:\Program Files\Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Tools\gradle내의 lib 폴더(유니티 내에서 사용중인 Gradle버전)

 

안드로이드 스튜디오 Gradle 경로 (사용할 Gradle version)

Android Studio version 3.5 이하: C:\Program Files\Android\Android Studio\gradle\gradle-version 내 lib 폴더
Android Studio version 3.5 이상: C:\Users\UserName\.gradle\wrapper\dists\gardle-version 내 lib 폴더

 

Unity 내장 Android Gradle Version

Unity version	Plugin version	Required Gradle version
2017.1-2017.2	2.1.0	2.14
2017.4-2017.4.16	2.3.0	4.0.1
2017.4.17+	3.2.0	4.6
2018.1	2.3.0	4.0.1
2018.2	3.0.1	4.2.1
2018.3-2018.4.3f1 2019.1-2019.1.6f1	3.2.0	4.6
2018.4.4f1+ 2019.1.7f1+	3.4.0	5.1.1

---

참고사이트

developer.android.com/studio/releases/gradle-plugin?hl=en

Android Gradle 플러그인 출시 노트  |  Android 개발자  |  Android Developers

docs.unity3d.com/kr/2019.4/Manual/android-gradle-overview.html

Android용 Gradle - Unity 매뉴얼