Version: 2023.1
언어: 한국어
Unity 애플리케이션용 Gradle 프로젝트 파일 수정
Android Project Configuration Manager를 사용하여 Gradle 프로젝트 파일 수정

Gradle 템플릿 파일을 사용하여 Gradle 프로젝트 파일 수정

Gradle 프로젝트 파일의 포맷과 콘텐츠를 어느 정도 제어하려면 자체 커스텀 템플릿으로 Unity의 기본 템플릿을 오버라이드할 수 있습니다. 이 작업을 수행하는 방법은 다음과 같습니다.

  1. Edit > Project Settings로 이동하여 프로젝트 설정 창을 엽니다.
  2. Player 탭을 선택한 다음 Android 플레이어 설정을 엽니다.
  3. Publishing Settings 섹션에서 커스텀 템플릿을 생성하려는 Gradle 프로젝트 파일 타입에 해당하는 체크박스를 활성화합니다.이렇게 하면 Gradle 프로젝트 템플릿 파일이 생성되고 파일에 대한 경로가 표시됩니다.
  4. 템플릿 파일을 수정하여 최종 Gradle 프로젝트 파일의 최종 포맷과 콘텐츠를 제어합니다.

템플릿 수정이 예상한 결과를 제공하는지 확인하려면 프로젝트 익스포트를 실행하고 결과 프로젝트에서 최종 Gradle 프로젝트 파일을 확인합니다.

템플릿 변수

커스텀 Gradle 템플릿 파일에서 다음 변수를 사용할 수 있습니다.

변수 설명
DEPS 프로젝트 종속성 리스트입니다. 이는 해당 프로젝트가 사용하는 라이브러리의 리스트입니다.
APIVERSION 빌드할 API 버전입니다. Unity는 해당 버전과 TARGETSDKVERSION을 같은 값(Android 플레이어 설정Target API Level)으로 설정합니다.
MINSDKVERSION 애플리케이션을 지원하는 최소 API 버전입니다.
BUILDTOOLS 사용할 SDK 빌드 툴입니다.
TARGETSDKVERSION 대상으로 지정할 API 버전입니다. Unity는 해당 버전과 APIVERSION을 같은 값(Android 플레이어 설정Target API Level)으로 설정합니다.
APPLICATIONID Android 애플리케이션 ID입니다. 예: com.mycompany.myapp
MINIFY_DEBUG 디버그 빌드를 축소할지 여부를 나타냅니다.
PROGUARD_DEBUG 디버그 빌드에서 축소화를 위해 ProGuard를 사용할지 여부를 나타냅니다.
MINIFY_RELEASE 릴리스 빌드를 축소할지 여부를 나타냅니다.
PROGUARD_RELEASE 릴리스 빌드에서 축소화를 위해 ProGuard를 사용할지 여부를 나타냅니다.
USER_PROGUARD 축소화를 위해 사용할 커스텀 ProGuard 파일을 지정합니다.
SIGN 이 빌드가 서명된 경우 signingConfigs 섹션을 완료합니다.
SIGNCONFIG 빌드가 서명될지 여부를 나타냅니다. 이 프로퍼티가 signingConfig.release로 설정되면 빌드가 서명됩니다.
DIR_GRADLEPROJECT Unity가 Gradle 프로젝트를 만드는 디렉토리입니다.
DIR_UNITYPROJECT Unity 프로젝트의 디렉토리입니다.
PLAY_ASSET_PACKS 애플리케이션에 포함할 에셋 팩을 지정합니다.
BUILTIN_NOCOMPRESS 압축하지 않을 파일 확장자의 기본 목록을 지정합니다. 파일 확장자는 .unity3d, .ress, .resource, .obb, .bundle, .unityexp입니다.

커스텀 settingsTemplate.gradle 파일은 다음 변수를 포함할 수도 있습니다.

변수 설명
INCLUDES Gradle 프로젝트에 포함된 Android Library 플러그인의 목록입니다.

커스텀 gradleTemplate.properties 파일은 다음 변수를 포함할 수도 있습니다.

변수 설명
JVM_HEAP_SIZE Java 가상 머신(JVM) 힙의 최대 크기입니다.
STREAMING_ASSETS Gradle이 압축하지 않아야 하는 Steaming Assets 폴더에 있는 파일의 목록입니다.
ADDITIONAL_PROPERTIES 애플리케이션의 추가 프로퍼티를 포함합니다. 여기에는 다음이 포함됩니다.
• Gradle 템플릿 버전.
• Unity 프로젝트 경로.
• 애플리케이션이 Android 앱 번들 퍼블리싱 포맷을 사용하는 경우, 네이티브 라이브러리를 압축된 상태로 유지하도록 표시하는 플래그.
• 애플리케이션이 GameActivity 애플리케이션 엔트리 포인트를 사용하는 경우, AndroidX를 사용하도록 표시하는 플래그.

추가 리소스

Unity 애플리케이션용 Gradle 프로젝트 파일 수정
Android Project Configuration Manager를 사용하여 Gradle 프로젝트 파일 수정