Unity는 애플리케이션을 설정하기 위한 플레이어 설정 및 빌드 설정을 제공합니다. Unity는 프로젝트를 빌드할 때 이러한 설정 옵션을 사용하여 Gradle 프로젝트 파일을 생성합니다. 하지만 Gradle 프로젝트 파일을 더 세부적으로 제어해야 하는 경우도 있습니다.
Gradle 프로젝트 파일의 콘텐츠를 수정하는 데 사용할 수 있는 방법을 알아보십시오. 일부 방법은 모든 Gradle 프로젝트 파일과 호환되지 않을 수 있습니다. 다음 표는 각 Gradle 프로젝트 파일을 수정하는 데 어떤 방법을 사용할 수 있는지 보여 줍니다.
| Gradle 프로젝트 파일 | Gradle 템플릿 | Android Project Configuration Manager | Android Studio |
|---|---|---|---|
| Main Manifest | 지원됨 | 지원됨 | 지원됨 |
| Android 런처 매니페스트 | 지원됨 | 지원됨 | 지원됨 |
| Main Gradle | 지원됨 | 지원됨 | 지원됨 |
| Launcher Gradle | 지원됨 | 지원됨 | 지원됨 |
| Base Gradle | 지원됨 | 지원됨 | 지원됨 |
| Gradle 프로퍼티 템플릿 | 지원됨 | 지원됨 | 지원됨 |
| Proguard 파일 | 지원됨 | 미지원 | 지원됨 |
Unity는 최종 Gradle 프로젝트 파일을 생성하기 위해 템플릿을 사용합니다. 이러한 템플릿을 오버라이드하여 Unity가 최종 파일을 생성하는 방식을 제어할 수 있습니다. Gradle은 Android 라이브러리에 있는 매니페스트를 최종 메인 매니페스트로 병합하고 최종 설정이 올바른지 확인합니다.
중요: 커스텀 Gradle 템플릿 파일을 사용하는 경우, 다른 기본 템플릿 파일을 사용하는 Unity 버전으로 Unity 프로젝트를 업그레이드하는 경우 커스텀 Gradle 템플릿 파일을 다시 작성해야 합니다.
이 방법을 사용하여 Gradle 프로젝트 파일을 수정하는 자세한 방법은 Gradle 템플릿 파일을 사용하여 Gradle 프로젝트 파일 수정을 참조하십시오.
Android Project Configuration Manager는 C#에서 Gradle 프로젝트 파일을 나타내는 클래스 세트입니다. API를 사용하면 지원되는 Gradle 프로젝트 파일에서 프로퍼티 및 기타 값을 수정할 수 있습니다. Unity는 빌드 포스트 프로세스 중에 수정 사항을 적용하므로 Unity 에디터가 설정한 값을 확인하고 필요한 경우 변경할 수 있습니다. Android Project Configuration Manager의 엔트리 포인트는 AndroidProjectFilesModifier 인터페이스의 OnModifyAndroidProjectFiles 메서드입니다.
Android Project Configuration Manager는 Gradle 파일 템플릿을 대체할 수 있으며 이점은 다음과 같습니다.
OnModifyAndroidProjectFiles를 실행합니다. 예를 들어 특정 Gradle 프로젝트 파일 속성을 설정할지 여부를 결정하기 위해 텍스트 파일에서 읽어 오는 경우와 같이, 파일의 콘텐츠에 따라 Gradle 프로젝트 파일 수정이 달라지는 경우 해당 파일을 빌드의 종속성으로 선언해야 합니다. 이렇게 하면 빌드 시스템이 파일을 추적하고 파일 콘텐츠를 변경하는 경우 OnModifyAndroidProjectFiles를 다시 실행할 수 있습니다. 자세한 내용은 AndroidProjectFilesModifier.Setup을 참조하십시오.이 메서드를 사용하여 Gradle 프로젝트 파일을 수정하는 자세한 방법은 Android Project Configuration Manager를 사용하여 Gradle 프로젝트 파일 수정을 참조하십시오.
Gradle 템플릿 파일을 Android Project Configuration Manager로 업그레이드하는 자세한 방법은 Android Templates Upgrader 창 레퍼런스를 참조하십시오.
중요: Gradle 템플릿 파일과 Android Project Configuration Manager API를 모두 사용하여 애플리케이션의 Gradle 프로젝트 파일을 수정할 수 있습니다. 하지만 두 가지 방법을 모두 사용하여 동일한 Gradle 프로젝트 파일을 수정할 수는 없습니다. 이 경우 Unity에서 오류가 발생합니다.
Android용 Unity 프로젝트를 익스포트하면, Unity는 Gradle 프로젝트 파일을 생성하고 익스포트한 프로젝트에 배치합니다. Android Studio에서 익스포트한 프로젝트를 열면 Gradle 프로젝트 파일을 볼 수 있습니다. Gradle 템플릿 또는 Android Project Configuration Manager를 사용하여 수정한 내용을 확인할 때 유용하며, 파일 자체를 직접 편집할 때도 유용합니다.
팁: Unity 프로젝트를 익스포트하거나 빌드할 때마다 Gradle 프로젝트 파일을 다시 수정할 필요가 없도록 하려면, Gradle 템플릿 파일 또는 Android Project Configuration Manager를 사용하여 Unity 내에서 원하는 Gradle 프로젝트 파일 수정을 수행하는 것이 가장 좋습니다.
이 방법을 사용하여 Gradle 프로젝트 파일을 수정하는 방법에 대한 자세한 내용은 Android Studio를 사용하여 Gradle 프로젝트 파일 수정을 참조하십시오.