Android와 Unity 간 버전 호환성 관리

안드로이드 스튜디오는 Gradle을 빌드 도구로 사용하며 Android Gradle Plugin(AGP)을 이용해서 Gradle에게 명령을 내린다. 그리고 Gradle은 안드로이드 프로젝트 빌드를 할 때 JDK를 이용한다. 때문에 Studio, Gradle, AGP, JDK는 서로 버전이 호환되어야 하며, 여기에 Kotlin으로 프로젝트를 작성했다면 Kotlin 플러그인 버전도 맞아야 한다.

단일 개발환경에서 프로젝트를 만드는 경우 이런 문제는 편집기가 알아서 조율해 주기 때문에 크게 신경 쓸 필요가 없다. 그러나 유니티 에디터로 개발한 안드로이드 앱에 안드로이드 스튜디오에서 만든 라이브러리를 붙이는 등 서로 다른 개발환경에서 만든 프로젝트를 합치는 경우 버전 호환성은 상당히 치명적으로 작용할 수 있다. 그래서 알아둘 필요가 있는 이슈다.

Android 공식 문서
Gradle 공식 문서
Unity 공식 문서

버전 확인

Android Studio 환경

• Android Studio: 상단 메뉴 Help > About
• JDK: 상단 메뉴 File > Settings > Build, Excution, Deployment > Build Tools > Gradle
• Gradle: 상단 메뉴 File > Project Structure > Project
  (gradle-wrapper.properties > distributionUrl 에서도 확인 가능)
• AGP: 상단 메뉴 File > Project Structure > Project
  (Project레벨 build.gradle > plugins > com.android.application 및 com.android.library 에서도 확인 가능)
• Kotlin Plugin: Project레벨 build.gradle > plugins > org.jetbrains.kotlin.android

Unity Editor 환경

• Unity 버전: Unity Hub > Installs
• Gradle: (Windows) ${유니티 설치폴더}\Hub\Editor${유니티 버전명}\Editor\Data\PlaybackEngines\AndroidPlayer\Tools\gradle\lib
• AGP: {프로젝트 폴더}\Assets\Plugins\Android\mainTemplate.gradle 문서의 buildscript > dependencies > classpath 'com.android.tools.build:gradle:${버전명}'
  (Android SDK)
• JDK: Preferences > External Tools > JDK

버전 호환성 관리

Android Studio ↔ AGP ↔ JDK

Android Studio 버전	호환되는 Gradle Plugin 버전	기본 JDK
Giraffe	3.2 ~ 8.1	11
Flamingo	3.2 ~ 8.0	11
Electric Eel	3.2 ~ 7.4	11
Dolphin	3.2 ~ 7.3	11
Chipmunk	3.2 ~ 7.2	11
Bumblebee	3.2 ~ 7.1	11
Arctic Fox	3.1 ~ 7.0	11
4.2.x		11
4.1.x		8(버전 조정 불가)

• Unity Editor 2022.2 미만 버전은 JDK 8만 지원한다. 해당 버전의 Unity Editor를 쓴다고 해서 Android Studio도 반드시 JDK 8을 써야 하는 건 아니지만, 혹시나 JDK 관련 에러가 다른 방법으로 고쳐지지 않을 경우 스튜디오 버전을 4.1.x로 내리는 것을 시도해보면 좋을 것 같다. 참고 공식문서
• Keystore파일도 생성 당시 JDK 버전에 따라 달라지므로 JDK 버전 때문에 스튜디오를 재설치했을 경우 Keystore를 포함한 캐시 파일을 완전히 날리고 다시 설치하는 것이 좋다.

JDK ↔ Gradle

JDK 버전	필요한 최소 Gradle 버전
19	7.6
18	7.5
17	7.3
16	7.0
15	6.7
14	6.3
13	6.0
12	5.4
★11	5.0
10	4.7
9	4.3
★8	2.0

AGP ↔ Gradle

AGP 버전	필요한 최소 Gradle 버전
8.1	8.0
8.0	8.0
7.4	7.5
7.3	7.4
7.2	7.3.3
7.1	7.2
7.0	7.0
4.2.x	6.7.1
4.1.x	6.5
4.0.x	6.1.1
3.6.x	5.6.4
3.5.x	5.4.1
3.4.x	5.1.1
3.3.x	4.10.1
3.2.x	4.6

Gradle ↔ Kotlin

Gradle 버전	내장된 Kotlin 버전	테스트 완료된 최소 Kotlin 버전
8.0.x	1.8.10	1.6.10
7.6	1.7.10	1.3.72
7.5	1.6.21	1.3.72
7.3	1.5.31	1.3.72
7.2	1.5.21	1.3.72
7.0	1.4.31	1.3.72
6.8	1.4.20	1.3.21
6.5	1.3.72	1.3.21
6.4	1.3.71	1.3.21
6.3	1.3.70	1.3.21
6.1	1.3.61	1.3.21
6.0	1.3.50
5.6	1.3.41
5.5	1.3.31
5.3	1.3.21
5.2	1.3.20
5.1	1.3.11
5.0	1.3.10

Unity ↔ Gradle ↔ JDK

공식 문서

Unity 버전	내장된 Gradle 버전	호환되는 최대 AGP 버전	지원하는 OpenJDK 버전
2023.1	7.3.3	7.2.1	11
2022.2	7.2	7.1.2	11
2022.1 2021.3 2021.2 2021.1 (2021.1.16f1 부터) 2020.3 (2020.3.15f1 부터)	6.1.1	4.0.1	8
2021.1 (2021.1.15f1 까지) 2020.3 (2020.3.14f1 까지) 2020.2 2020.1	5.6.4	4.0.1	8
2019.4 2019.3 2019.2 2019.1 (2019.1.7f1 부터) 2018.4 (2018.4.4f1 부터)	5.1.1	3.4.0	8
2019.1 (2019.1.6f1 까지) 2018.4 (2018.4.3f1 까지) 2018.3 2017.4 (2017.4.17 부터)	4.6	3.2.1	8