Qt 안드로이드 매니페스트 파일 구성

안드로이드 매니페스트는 모든 안드로이드 앱에 필요한 XML 파일입니다. 여기에는 앱이 사용하는 다양한 설정 및 기능에 대한 앱 구성과 패키지 이름, 앱 이름, 버전 등과 같은 앱 자체에 대한 세부 정보가 포함되어 있습니다. 권한 및 하드웨어 기능도 매니페스트에서 설정할 수 있습니다.

안드로이드용 Qt는 안드로이드에서 Qt 앱을 빌드하고 실행하는 데 필요한 기능, 권한 및 빌드 시스템에서 사용하는 기타 구성을 포함하는 기본 구성이 포함된 AndroidManifest.xml 버전을 유지합니다.

매니페스트 구성을 위한 Qt 프로젝트

Qt는 매니페스트 파일에서 명시적으로 설정하지 않아도 빌드 시스템에서 androiddeployqt로 전달되어 매니페스트를 올바른 값으로 채우는 몇 가지 메타 데이터를 정의합니다. 이러한 메타 데이터에는 예를 들어 "-- %%INSERT_VALUE%% --" 형식의 값이 할당됩니다:

<manifest ...
    android:versionCode="-- %%INSERT_VERSION_CODE%% --"
    ...
</manifest>

예를 들어 CMake 에 설정된 버전 코드로 채워집니다.

Qt 기본 구성

Qt는 기본적으로 다음과 같은 매니페스트 구성을 설정합니다:

<action android:name="android.intent.action.MAIN"/>
<category android:name="android.intent.category.LAUNCHER"/>

Qt 특정 메타 데이터

Qt가 설정하는 기본 매니페스트 구성 외에도 Qt는 Qt 앱에만 유효한 일부 메타 데이터를 정의합니다. 이러한 메타 데이터는 일반적으로 양식의 <activity> 섹션 아래에 있습니다:

<meta-data
    android:name="meta-data-name"
    android:value="meta-data-value" />

다음은 Qt에서 정의한 메타 데이터의 목록입니다:

애플리케이션별 메타데이터

일부 메타데이터 속성은 애플리케이션 전체에 해당하며 <application> 섹션 아래에 배치해야 합니다:

서비스의 메타 데이터

일부 메타데이터 속성은 서비스에서도 사용할 수 있습니다. 주요 속성은 다음과 같습니다:

• android.app.lib_name
• android.app.background_running
• android.app.arguments

Qt 권한 및 기능

다른 Qt 모듈은 제대로 작동하기 위해 일부 안드로이드 권한이나 기능이 필요할 수 있습니다 (예: QtMultimedia 의 카메라 권한). androiddeployqt 도구는 빌드 중에 이러한 요구 사항을 안드로이드 매니페스트에 포함시키는 작업을 처리합니다. Qt는 매니페스트에 다음 줄을 정의하고 실제 값으로 대체합니다:

<manifest ...
    <!-- %%INSERT_PERMISSIONS -->
    <!-- %%INSERT_FEATURES -->
    ...
</manifest>

권한 사용자 지정하기

Qt 6.8.1부터 Qt 모듈에 설정된 기본 권한을 재정의할 수 있습니다. 이 기능은 Qt 모듈에서 사용하는 것과 동일한 권한을 정의해야 하지만 추가 또는 다른 속성을 정의해야 하는 경우에 유용합니다.

이를 위해 Android 매니페스트 파일에서 <!-- %%INSERT_PERMISSIONS --> 자리 표시자와 함께 이러한 권한을 수동으로 정의할 수 있습니다. 수동으로 정의한 권한은 Qt 모듈에서 추가한 동일한 권한보다 우선하므로 중복을 피할 수 있습니다.

스타일 추출

Qt는 Qt Widgets 와 Qt Quick Controls 의 스타일 지정 방법을 결정하기 위해 서로 다른 방법을 사용합니다:

• default 또는 full: Qt Widgets 또는 Qt Quick Controls 사용 시 1.

  참고: 이 메서드는 Android 9.0(API 28)부터 Google에서 제한 및 제거 중인 일부 Android 비 SDK 인터페이스를 사용합니다. 따라서 Android 9.0 이상에서는 이 방법을 사용하지 않는 것이 좋습니다.

• minimal Qt Quick Controls 2를 사용하고 또는 1을 사용하지 않는 경우. 기본 또는 전체 옵션을 사용하는 것보다 빠릅니다. Qt Widgets Qt Quick Controls
• none스타일 추출을 하지 않습니다.

6.2 릴리스 이전의 Qt 매니페스트

6.2 이전 버전의 Qt에는 Qt에서 정의한 추가 메타 데이터 세트가 있었습니다. 이러한 속성은 종속성을 관리하는 데 사용되었으며 일부는 중단된 Ministro 서비스에서 사용되었습니다. Qt 6.2에서는 제거되어야 합니다. 다음은 이러한 어트리뷰트 목록입니다:

• android.app.qt_sources_resource_id
• android.app.repository
• android.app.bundled_libs_resource_id
• android.app.bundle_local_qt_libs
• android.app.use_local_qt_libs
• android.app.libs_prefix
• android.app.load_local_libs_resource_id
• android.app.load_local_jars
• android.app.static_init_classes
• android.app.qt_libs_resource_id
• android.app.ministro_not_found_msg
• android.app.ministro_needed_msg
• android.app.fatal_error_msg

안드로이드 매니페스트에 대한 자세한 내용은 안드로이드 앱 매니페스트를 참조하세요.