Version: 2023.1
언어: 한국어
Android용 Gradle
Unity 런처 매니페스트

Android 앱 매니페스트

Android 앱 매니페스트에는 Android 애플리케이션에 대한 정보가 포함되어 있습니다. 각 애플리케이션에는 소스 세트 루트 즉 AndroidManifest.xml에 단일 Android 앱 매니페스트 XML 파일이 있습니다. Android 운영체제와 Google Play와 같은 디지털 배포 서비스에서는 애플리케이션의 이름, 애플리케이션의 엔트리 포인트, Android 버전 지원, 하드웨어 기능 지원, 애플리케이션 권한과 같은 정보를 찾기 위해 Android 앱 매니페스트를 사용합니다. Android 앱 매니페스트 파일에 대한 자세한 내용과 Android 앱 매니페스트 파일이 지정하는 설정 리스트를 보시려면 Android 앱 매니페스트에 있는 Android 개발자 문서를 참조하십시오.

애플리케이션을 나타내는 Android 앱 매니페스트를 생성하기 위해 Gradle은 소스가 다양한 매니페스트 파일을 병합합니다. 여기에는 다음 사항이 포함됩니다.

  • Unity 라이브러리 매니페스트: Unity가 생성하고 Unity 플레이어 활동을 설정하는 매니페스트 파일입니다. 자세한 내용은 Unity 라이브러리 매니페스트를 참조하십시오.
  • Unity 런처 매니페스트: Unity가 생성하고 Unity 라이브러리를 래핑하는 애플리케이션을 설정하는 매니페스트 파일입니다. 자세한 내용은 Unity 런처 매니페스트를 참조하십시오.
  • 플러그인 매니페스트: AAR(Android Archives) 또는 Android 라이브러리 프로젝트와 같은 플러그인을 나타내는 매니페스트 파일입니다.

Unity에서 Android 앱 매니페스트를 생성하기 위해 이 매니페스트 파일을 사용하는 방법에 대한 내용은 Android 앱 매니페스트 생성을 참조하십시오.

Android 앱 매니페스트 생성

Android 애플리케이션 빌드 프로세스는 애플리케이션용 Android 앱 매니페스트 파일을 생성합니다. 이렇게 하려면 다음 단계를 따르십시오.

  1. Unity는 Unity 라이브러리 매니페스트를 Android 앱 매니페스트의 템플릿으로 사용합니다. Unity 라이브러리 매니페스트를 오버라이드하는 경우, Unity는 템플릿으로 지정한 파일을 사용합니다.
  2. Unity는 애플리케이션이 사용하는 권한, 설정 옵션 및 기능과 같은 정보로 Unity 라이브러리 매니페스트 파일과 Unity 런처 매니페스트 파일을 업데이트합니다.
  3. Gradle은 Unity 라이브러리 매니페스트, Unity 런처 매니페스트, 플러그인 매니페스트를 Android 앱 매니페스트 파일 하나로 병합합니다.

Android Studio APK 분석기Apktool과 같은 다른 타사 툴을 사용하여 출력 Android 앱 번들(AAB)이나 Android 패키지(APK) 안에 있는 Android 앱 매니페스트 파일을 볼 수 있습니다.

중요: Android 앱 매니페스트 파일을 APK 또는 AAB에서 편집할 수 없습니다. Android 앱 매니페스트의 콘텐츠를 오버라이드하는 자세한 방법은 Gradle 프로젝트 파일 수정을 참조하십시오.

권한

Unity는 Android 플레이어 설정과 C# 스크립트에서 애플리케이션이 호출한 API를 기준으로 매니페스트에 필수 권한을 자동으로 추가합니다. 예를 들면 다음과 같습니다.

  • Network 클래스는 INTERNET 권한을 추가합니다.
  • Handheld.Vibrate와 같은 진동을 사용하면 VIBRATE가 추가됩니다.
  • InternetReachability 프로퍼티는 ACCESS_NETWORK_STATE를 추가합니다.
  • LocationService와 같은 위치 관련 API는 ACCESS_FINE_LOCATION을 추가합니다.
  • WebCamTexture API는 CAMERA를 추가합니다.
  • Microphone 클래스는 RECORD_AUDIO를 추가합니다.

매니페스트에 선언된 권한을 플러그인이 요청하는 경우 Unity는 Gradle 병합 단계 동안 최종 Android 앱 매니페스트에 자동으로 권한을 추가합니다. Unity는 플러그인이 사용하는 모든 Unity API를 권한 리스트에 포함합니다.

Android 런타임 권한 시스템을 Android 앱 매니페스트에 권한을 지정하는 대신 런타임에 권한 요청에 사용할 수 있습니다.

권한에 관한 자세한 내용은 Android 앱 매니페스트 권한에 있는 Android 개발자 문서를 참조하십시오.

Android용 Gradle
Unity 런처 매니페스트