Android 빌드 툴체인
결론
JDK 17 · NDK r27c · CMake 3.22.1 은 Unity 6 전 버전 공통입니다. Gradle과 Android Gradle Plugin(AGP)은 Unity 패치 버전마다 고정돼 있으니, Unity Hub로 설치되는 내장 버전을 그대로 쓰는 것을 기본으로 합니다.
JDK · NDK · CMake
| Unity | JDK | NDK | CMake |
|---|---|---|---|
| 6000.0.38f1 이상, 6.1 이상 | 17 (OpenJDK) | r27c (27.2.12479018) | 3.22.1 |
| 6000.0.0f1 ~ 6000.0.37f1 | 17 (OpenJDK) | r23b (23.1.7779620) | 3.22.1 |
| 2022.3 LTS | 11 (OpenJDK) | r23b (23.1.7779620) | 미지원 |
NDK r27c는 16KB 페이지 크기 대응과 묶여 있습니다. 자체 C++ 라이브러리도 같은 NDK로 빌드하세요.
Gradle · Android Gradle Plugin
| Unity | Gradle | AGP |
|---|---|---|
| 6.3 LTS | ||
| 6000.3.26f1 이상 | 9.3.1 | 9.1.1 |
| 6000.3.17f1 ~ 6000.3.25f1 | 9.1.0 | 9.0.0 |
| 6000.3.1f1 ~ 6000.3.16f1 | 8.13 | 8.10.0 |
| 6.0 LTS | ||
| 6000.0.85f1 이상 | 9.3.1 | 9.1.1 |
| 6000.0.79f1 ~ 6000.0.84f1 | 9.1.0 | 9.0.0 |
| 6000.0.61f1 ~ 6000.0.78f1 | 8.13 | 8.10.0 |
| 6000.0.45f1 ~ 6000.0.60f1 | 8.11 | 8.7.2 |
| 6000.0.1f1 ~ 6000.0.44f1 | 8.4 | 8.3.0 |
| 6.6 | ||
| 6000.6.3f1 이상 | 9.3.1 | 9.1.1 |
| 6000.6.1f1 ~ 6000.6.2f1 | 9.3.1 | 9.0.0 |
패치 업데이트로 Gradle 메이저가 바뀝니다
6.3은 6000.3.17f1, 6.0은 6000.0.79f1에서 Gradle 8 → 9, AGP 8 → 9로 넘어갑니다. 같은 LTS 안의 패치 업데이트지만 빌드 시스템 메이저가 바뀌는 구간입니다. 다음을 쓰고 있다면 업데이트 전에 빌드를 따로 검증하세요.
- 커스텀 Gradle 템플릿 (
mainTemplate.gradle,launcherTemplate.gradle,settingsTemplate.gradle등) - Gradle 플러그인을 직접 적용하는 서드파티 SDK
- Android Studio로 Export한 프로젝트를 별도 CI에서 빌드하는 구성
Gradle이나 AGP를 Unity 내장 버전이 아닌 것으로 바꿔 쓰려면, 두 버전 간 호환성을 Android Gradle Plugin 릴리스 노트에서 먼저 확인하세요.
Android SDK 도구
Unity는 Android SDK 버전을 엄격하게 요구하지 않습니다. 아래는 Unity가 함께 설치하는 버전입니다.
| Unity | Build Tools | Command-line Tools | Platform Tools |
|---|---|---|---|
| 6000.3.28f1 이상 | 36.0.0 | 21.0 | 37.0.1 |
| 6000.3.26f1 ~ 6000.3.27f1 | 36.0.0 | 16.0 | 37.0.1 |
| 6000.3.0f1 ~ 6000.3.25f1 | 36.0.0 | 16.0 | 36.0.0 |
| 6000.0.86f1 이상 | 36.0.0 | 21.0 | 37.0.1 |
| 6000.0.85f1 | 36.0.0 | 16.0 | 37.0.1 |
| 6000.0.60f1 ~ 6000.0.84f1 | 36.0.0 | 16.0 | 36.0.0 |