Version: 2023.2
언어: 한국어
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 uses the Unity Library Manifest as a template for the Android App Manifest. If you override the Unity Library Manifest, Unity uses the file you specify as the template.
  2. Unity는 애플리케이션이 사용하는 권한, 설정 옵션 및 기능과 같은 정보로 Unity 라이브러리 매니페스트 파일과 Unity 런처 매니페스트 파일을 업데이트합니다.
  3. Gradle은 Unity 라이브러리 매니페스트, Unity 런처 매니페스트, 플러그인 매니페스트를 Android 앱 매니페스트 파일 하나로 병합합니다.

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

Important: You cannot edit the Android App Manifest file in the APK or AAB. For information on how to override the contents of an Android App Manifest, refer to Modify Gradle project files.

권한

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 런처 매니페스트
Copyright © 2023 Unity Technologies
优美缔软件(上海)有限公司 版权所有
"Unity"、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属机构在美国及其他地区的商标或注册商标。其他名称或品牌是其各自所有者的商标。
公安部备案号:
31010902002961