Unity Gradle에 대한 간단한 가이드
Unity의 Gradle 관련 내용을 이해하기 쉽게 정리하였습니다. 이 문서는 Unity에서 Android 애플리케이션을 개발할 때 필요한 Gradle 사용법과 관련된 내용입니다.
Gradle이란?
Gradle은 빌드 자동화 도구로, Android 애플리케이션 생성 및 패키징을 보다 쉽고 효율적으로 관리하는 데 도움을 줍니다. Unity는 Android 프로젝트를 빌드할 때 Gradle을 사용하며, 이를 통해 여러 빌드 프로세스를 자동화하고 일반적인 빌드 오류를 방지하는 데 도움이 됩니다.
Android용 Gradle 프로젝트 익스포트
Unity 프로젝트를 Gradle 프로젝트로 익스포트하여 Android Studio와 같은 외부 도구로 빌드할 수 있습니다. Android 관련 문서에서 더 자세한 내용을 확인할 수 있습니다.
버전 호환성
각 Unity 버전과 Gradle 버전 간의 호환성을 나타내는 표입니다.
| Unity 버전 | Gradle 버전 | Android Gradle 플러그인 버전 |
|---|---|---|
| 2022.2 | 2022.3 | 7.1.2 |
| 2022.1 | 2021.3 | 7.1.2 |
| 2020.3 | 6.1.14 | 4.0.1 |
| 2019.4 | 5.6.4 | 3.4.0 |
참고: 커스텀 Gradle 또는 Android Gradle 플러그인 버전을 사용하려면 버전 호환성을 확인해야 합니다.
Gradle 프로젝트 파일 목록
Unity 프로젝트에 있는 Gradle 프로젝트 파일과 그 용도를 설명합니다.
| Gradle 프로젝트 파일 | 용도 |
|---|---|
| Main Manifest | Android 애플리케이션에 대한 메타데이터 포함 |
| Unity Launcher Manifest | 런처에 대한 메타데이터 포함 |
| Main Gradle | 애플리케이션을 라이브러리로 빌드하는 방법 정보 포함 |
| Launcher Gradle | 애플리케이션 빌드 방법에 대한 지침 포함 |
| Base Gradle | 프로젝트 간에 공유되는 설정 포함 |
| Gradle Properties | Gradle 빌드 환경 설정 포함 |
| Gradle Settings | 외부 종속성을 해결하기 위한 아티팩트 저장소 선언 포함 |
| Proguard | 축소화 프로세스 및 규칙 설정 담고 있음 |
Gradle 프로젝트 구조
Unity 프로젝트를 Gradle 프로젝트로 내보내면 두 가지 모듈이 포함됩니다.
- UnityLibrary 모듈: Unity 런타임 및 프로젝트 데이터 포함
- 런처 모듈: 애플리케이션 이름 및 아이콘 포함
주요 파일 설명
이하에는 Gradle 프로젝트 내 주요 파일이 어떤 내용을 포함하고 있는지 설명합니다.
| 파일 | 설명 |
|---|---|
| build.gradle | 모든 모듈에 영향을 주는 기본 Gradle 파일 |
| gradle.properties | 애플리케이션 빌드 방법 설정 |
| AndroidManifest.xml | 최종 Android 앱 매니페스트에 병합되는 내용 포함 |
| local.properties | 빌드 시스템의 환경 설정 포함 |
| settings.gradle | Android Gradle 프로젝트의 모든 모듈 지정 |
| unityLibrary | UnityLibrary 모듈에 관련된 파일 및 폴더 포함 |
결론
이 문서에서 다룬 Gradle의 사용법을 통해 Unity에서 Android 애플리케이션을 더 쉽게 개발하고 관리할 수 있습니다. Gradle의 다양한 기능을 활용하여 빌드 프로세스를 자동화하고 효율적인 개발 환경을 구축하세요. 각 섹션을 참고하여 프로젝트에 필요한 설정을 적용해 보세요.