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

Android 매니페스트

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

Android 매니페스트를 생성하기 위해 Unity에서는 다음과 같이 Unity 전용 템플릿 매니페스트 파일 두 가지를 사용합니다.

  • 라이브러리 매니페스트: Unity 플레이어 활동을 설정합니다. 자세한 내용은 라이브러리 매니페스트를 참조하십시오.
  • 런처 매니페스트: Unity 라이브러리를 래핑하는 애플리케이션을 설정합니다. 자세한 내용은 런처 매니페스트를 참조하십시오.

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

Android 매니페스트 생성

Unity에서 Android 애플리케이션을 빌드하면, 애플리케이션을 위한 Android 매니페스트 파일이 생성됩니다. 이렇게 하려면 다음 단계를 따르십시오.

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

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

중요: APK나 AAB 안에 있는 Android 매니페스트 파일을 편집할 수는 없습니다. Android 매니페스트 콘텐츠를 오버라이드하는 방법에 대한 자세한 내용은 [Android 매니페스트 오버라이드](overriding- android-manifest)를 참조하십시오.

권한

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
런처 매니페스트