Unity의 Android 애플리케이션 빌드 방법

Unity는 Android 애플리케이션을 빌드하기 위해 Gradle을 사용하므로 빌드 프로세스와 Unity가 Gradle과 상호 작용하는 방식을 이해하는 것이 좋습니다. Gradle을 사용하면 플레이어 설정 및 기타 Unity 창을 사용하여 최종 빌드의 대부분을 설정할 수 있지만 더 많이 제어하려면 매니페스트 및 템플릿 파일을 덮어쓰거나 프로젝트를 익스포트하고 Android Studio에서 편집해야 합니다.

빌드 프로세스

Android 애플리케이션을 빌드하려면 다음 단계를 따르십시오.

1. Unity가 모든 AndroidProjectFilesModifier 인터페이스에 AndroidProjectFilesModifier.Setup을 호출합니다. 이 콜백을 사용하여 커스텀 Android__ Gradle__여러 빌드 프로세스를 자동화하는 Android 빌드 시스템입니다. 이러한 자동화로 인해 많은 일반적인 빌드 오류가 발생할 가능성이 감소합니다. 자세한 정보
   See in Glossary 프로젝트 파일을 수정하기 위한 선행 조건을 설정할 수 있습니다. 자세한 내용은 AndroidProjectFilesModifier.Setup을 참조하십시오.
2. Unity가 Unity 프로젝트에서 프로젝트 리소스, 코드 라이브러리, 플러그인, Gradle 템플릿, 매니페스트 템플릿을 수집하여 유효한 Gradle 프로젝트를 만드는 데 사용합니다.
3. Unity가 Unity 프로젝트의 플레이어 설정과 빌드 설정을 기반으로 Gradle 템플릿과 매니페스트 파일 안에 값을 추가하고 업데이트합니다.
4. 프로젝트를 빌드하지 않고 익스포트하고__ IL2CPP__Unity에서 개발한 스크립팅 백엔드로, 여러 플랫폼용 프로젝트를 빌드할 때 Mono 대신 사용할 수 있습니다. 자세한 정보
   See in Glossary 스크립팅 백엔드를 사용하는 경우 Unity는 C# 스크립트에서 생성된 C++ 소스 파일을 Gradle 프로젝트에 저장합니다. 또는 프로젝트를 빌드하기로 선택한 경우 Unity는 libil2cpp.so 라이브러리를 Gradle 프로젝트에 저장합니다.
5. Unity가 모든 AndroidProjectFilesModifier 인터페이스에 OnModifyAndroidProjectFiles를 호출합니다. 이 콜백을 사용하여 Gradle 프로젝트 파일 값을 수정할 수 있습니다. 자세한 내용은 Android 프로젝트 설정 관리자를 사용하여 Gradle 프로젝트 파일 수정을 참조하십시오.
   참고: 커스텀 모듈에서만 Android Gradle 프로젝트 파일을 수정할 수 있습니다.
6. Unity가 모든 IPostGenerateGradleAndroidProject 인터페이스에 OnPostGenerateGradleAndroidProject를 호출합니다. 이 콜백을 사용하여 Gradle 애플리케이션을 빌드하기 전에 파일을 수정하거나 이동할 수 있습니다.
7. Unity가 Gradle을 실행하여 Gradle 프로젝트에서 애플리케이션을 빌드합니다. Gradle은 Unity 라이브러리 매니페스트, Unity 런처 매니페스트, 플러그인 매니페스트를 Android 앱 매니페스트 파일 하나로 병합합니다.

증분 빌드 파이프라인

Unity는 Android용 플레이어를 빌드할 때 증분 빌드 파이프라인을 사용합니다. 다음 Android 전용 증분 빌드 파이프라인 동작을 참조하십시오.

• Unity 증분 빌드/생성:
  • Gradle 파일
  • 매니페스트 파일
  • 에셋 팩
  • APK 확장 파일(obb)
  • 압축되지 않은 에셋 분할
  • Android 심볼 zip 파일
• Unity 증분 복사:
  • 플레이어 바이너리
  • Gradle 리소스
• 빌드 프로세스의 마지막 단계는 Gradle을 실행하는 것입니다. 이 시점부터 빌드 프로세스는 증분 빌드 파이프라인을 사용하지 않으며 종속성을 추적하는 것은 Gradle에 달려 있습니다.

IPostGenerateGradleAndroidProject를 구현하고 증분 빌드 파이프라인에서 사용하는 Android 파일이나 에셋을 수정하거나 이동하면 프로젝트를 빌드할 때 문제가 발생할 수 있습니다. Gradle 프로젝트 파일만 수정하려면 IPostGenerateGradleAndroidProject 대신 Android 프로젝트 설정 관리자를 사용하는 것이 가장 좋습니다. 해당 사용 사례에 IPostGenerateGradleAndroidProject를 사용해야 하며 증분 빌드 파이프라인 문제를 해결해야 하는 경우 비증분 빌드 생성을 참조하십시오.
참고: Android 프로젝트 설정 관리자는 커스텀 모듈에서만 Android Gradle 프로젝트 파일을 수정하는 데 사용할 수 있습니다.