Version: 2023.2
언어: 한국어
Unity 라이브러리 매니페스트
Android 사용 시작

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

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

빌드 프로세스

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

  1. Unity는 모든 AndroidProjectFilesModifier 인터페이스에 대해 AndroidProjectFilesModifier.Setup을 호출합니다. 이 콜백을 사용하여 Android Gradle 프로젝트 파일 수정에 대한 전제 조건을 설정할 수 있습니다. 자세한 내용은 AndroidProjectFilesModifier.Setup을 참조하십시오.
  2. Unity는 Unity 프로젝트에서 프로젝트 리소스, 코드 라이브러리, 플러그인, Gradle 템플릿, 매니페스트 템플릿을 수집하여 유효한 Gradle 프로젝트를 만드는 데 사용합니다.
  3. Unity는 Unity 프로젝트의 플레이어 설정과 빌드 설정을 기반으로 Gradle 템플릿과 매니페스트 파일 안에 값을 추가하고 업데이트합니다.
  4. 프로젝트를 익스포트하고 빌드하지 않고 IL2CPP 스크립팅 백엔드를 사용하도록 선택한 경우, Unity는 C# 스크립트에서 생성된 C++ 소스 파일을 Gradle 프로젝트에 배치합니다. 또는 프로젝트를 빌드하도록 선택한 경우, Unity는 libil2cpp.so 라이브러리를 Gradle 프로젝트에 배치합니다.
  5. Unity는 모든 AndroidProjectFilesModifier 인터페이스에 대해 OnModifyAndroidProjectFiles를 호출합니다. 이 콜백을 사용하여 Gradle 프로젝트 파일 값을 수정할 수 있습니다. 자세한 내용은 Android 프로젝트 설정 관리자로 Gradle 프로젝트 파일 수정을 참조하십시오.
  6. Unity는 모든 IPostGenerateGradleAndroidProject 인터페이스에 대해 OnPostGenerateGradleAndroidProject를 호출합니다. 이 콜백을 사용하여 Gradle이 애플리케이션을 빌드하기 전에 파일을 수정하거나 이동할 수 있습니다. 참고: OnPostGenerateGradleAndroidProject는 지원 중단되었으며, 대신 OnModifyAndroidProjectFiles를 사용하십시오.
  7. Unity는 Gradle을 실행하여 Gradle 프로젝트에서 애플리케이션을 빌드합니다. Gradle은 Unity 라이브러리 매니페스트, Unity 런처 매니페스트, 플러그인 매니페스트를 하나의 Android 앱 매니페스트 파일에 병합합니다.

증분 빌드 파이프라인

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

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

Unity 라이브러리 매니페스트
Android 사용 시작