이 페이지에서

Android 매니페스트 파일 편집

Projects > Build Settings > Build Android APK 의 구성 옵션을 사용하여 애플리케이션 개발 시 androiddeployqt 도구에 필요한 모든 설정을 지정할 수 있습니다.

‘프로젝트’의 ‘빌드 설정’ 탭에서 Android APK 빌드 단계

애플리케이션 아이콘이나 스플래시 화면과 같은 Android 전용 설정을 지정하는 데만 Android 매니페스트 파일이 필요합니다.

그러나 Play 스토어에 패키지를 게시하려면 매니페스트 파일이 필요합니다.

빌드 시스템으로 CMake를 사용하는 경우, CMakeList.txt 파일에서 Android 패키지 소스 디렉터리( QT_ANDROID_PACKAGE_SOURCE_DIR)를 지정해야 합니다.

매니페스트 파일 생성

Qt Creator 를 사용하여 Android 매니페스트 파일을 생성하려면:

  1. Projects > Build Settings > Build Android APK 로 이동한 후, ‘ Create Templates ’를 선택합니다.
  2. Android package source directory 에서 경로를 확인하십시오.

    ‘템플릿 만들기’ 대화 상자

  3. Qt 애플리케이션의 Java 부분을 확장할 계획이라면 ‘ Copy the Gradle files to Android directory ’을 선택하십시오.
  4. Finish 를 선택하면 템플릿 파일이 android 디렉터리로 복사되고, 편집을 위해 매니페스트 파일이 텍스트 형식으로 열립니다.

매니페스트 파일 옵션 설정

매니페스트 파일을 편집하려면:

  • Projects 에서 매니페스트 파일을 선택합니다.
  • Tools > Android > Manifest XML Source 로 이동합니다.

Android 매니페스트 XML 소스 편집기

Android 매니페스트 파일의 옵션 설정에 대한 자세한 내용은 Qt for Android 매니페스트 파일 구성을 참조하십시오.

편집기를 사용하여 애플리케이션 아이콘, 스플래시 화면 및 권한을 설정할 수 있습니다.

화면 방향

<activity> 섹션에서 android:screenOrientation 옵션을 설정하여 센서 측정값이나 사용자 기본 설정에 따라 화면 방향을 결정할 수 있습니다. 기본값은 unspecified 입니다.

화면 방향 옵션
방향설명
unspecified시스템이 방향을 선택합니다. 시스템이 적용하는 정책과 이에 따라 특정 상황에서 이루어지는 선택은 기기마다 다를 수 있습니다.
behind액티비티 스택에서 바로 아래에 있는 액티비티와 동일한 방향을 사용합니다.
landscape화면 너비가 높이보다 큰 가로 방향.
portrait세로 방향: 디스플레이의 높이가 너비보다 큰 방향입니다.
reverseLandscape일반 가로 방향과 반대 방향의 가로 방향입니다.
reversePortrait일반 세로 방향과 반대 방향의 세로 방향.
sensorLandscape가로 방향이지만, 기기 센서에 따라 일반 가로 방향이거나 반전된 가로 방향이 될 수 있습니다. 사용자가 센서 기반 회전을 잠근 경우에도 센서가 사용됩니다.
sensorPortrait세로 방향이지만, 기기 센서에 따라 일반 세로 방향 또는 반전 세로 방향이 될 수 있습니다. 사용자가 센서 기반 회전을 잠근 경우에도 센서가 사용됩니다.
userLandscape가로 방향이지만, 기기 센서 및 사용자 기본 설정에 따라 일반 가로 또는 반전 가로가 될 수 있습니다.
userPortrait세로 방향이지만, 기기 센서와 사용자 선호도에 따라 일반 세로 또는 반전 세로 방향이 될 수 있습니다.
sensor방향은 기기의 방향 센서에 의해 결정됩니다. 디스플레이의 방향은 사용자가 기기를 어떻게 잡고 있는지에 따라 달라집니다. 사용자가 기기를 회전하면 방향이 변경됩니다. 그러나 일부 기기는 기본적으로 네 가지 가능한 방향 모두로 회전하지 않을 수 있습니다. 네 가지 방향 모두를 허용하려면 전체 센서 옵션을 선택하십시오. 사용자가 센서 기반 회전을 잠근 경우에도 센서가 사용됩니다.
fullSensor네 가지 방향 중 어느 것이든 기기의 방향 센서에 의해 방향이 결정됩니다. 이는 ‘센서’ 옵션과 유사하지만, 기기가 일반적으로 어떻게 동작하든 상관없이 네 가지 가능한 화면 방향 중 어느 것이든 허용한다는 점이 다릅니다. 예를 들어, 일부 기기는 일반적으로 역세로 또는 역가로 모드를 사용하지 않지만, 이 옵션을 사용하면 해당 모드를 사용할 수 있습니다.
noSensor물리적 방향 센서를 참조하지 않고 방향이 결정됩니다. 센서가 무시되므로 사용자가 기기를 어떻게 움직이더라도 화면이 회전하지 않습니다.
user사용자가 현재 선호하는 방향입니다.
fullUser사용자가 센서 기반 회전을 잠근 경우, 이 옵션은 ‘사용자’ 옵션과 동일하게 작동합니다. 그렇지 않은 경우, ‘전체 센서’ 옵션과 동일하게 작동하여 네 가지 가능한 화면 방향 중 어느 것이든 허용합니다.
locked현재 회전 방향이 무엇이든 간에 그 방향으로 화면을 고정합니다.

아이콘

화면 밀도에 따라 애플리케이션 아이콘으로 사용할 이미지를 설정하려면 ‘ Tools ’ > ‘ Android ’ > ‘ Icon ’로 이동하십시오.

아이콘 편집기

낮은, 중간, 높은, 초고 DPI 디스플레이에서 애플리케이션 아이콘 및 스플래시 화면으로 표시될 서로 다른 이미지를 설정할 수 있습니다. 다음 목록은 각 범주에 일반적으로 해당하는 DPI 값을 요약한 것입니다:

  • 저밀도(LDPI): ~120dpi
  • 중간 밀도(MDPI): ~160dpi
  • 고밀도(HDPI): ~240dpi
  • 초고밀도(XHDPI): ~320dpi
  • 초초고밀도(XXHDPI): ~480dpi
  • 초초초고밀도(XXXHDPI): ~640dpi

이미지에서 각 픽셀 밀도에 적합한 해상도의 아이콘 세트를 생성하려면 ‘ Select Master Icon ’를 선택하십시오.

아이콘을 지우려면 ‘ Clear Icon ’를 선택하십시오.

스플래시 화면

스플래시 화면에 대한 설정을 지정하려면 [ Tools ] > [ Android ] > [ Splash Screen]로 이동하십시오.

시작 화면 편집기

기기의 방향과 화면 해상도에 따라 스플래시 화면으로 표시할 이미지를 선택하십시오.

Select Master Image, Select Portrait ImageSelect Landscape Image 에서 해상도가 가장 높은 이미지를 선택하십시오.

Image show mode 에서 스플래시 화면을 기기 디스플레이 중앙에 배치할지, 아니면 디스플레이 전체를 채우도록 크기를 조정할지 선택합니다.

Background color 에서 배경색을 설정하세요.

기본적으로 액티비티가 그려지면 스플래시 화면이 숨겨집니다. QNativeInterface::QAndroidApplication::hideSplashScreen()가 호출될 때까지 스플래시 화면을 계속 표시하려면 Sticky splash screen 를 선택하십시오.

Clear All 을 선택하여 모든 설정을 재설정하거나 모든 이미지를 제거할 수 있습니다.

권한

Android 6.0(API 23)부터 애플리케이션은 런타임에 권한을 요청해야 합니다( QCoreApplication::requestPermission() 참조). Android API 레벨이 더 낮은 경우, 사용자는 애플리케이션을 설치할 때 이러한 권한을 부여해야 합니다. 그러면 Android OS는 애플리케이션에 해당 데이터 및 기능에 대한 액세스 권한을 부여합니다.

권한을 설정하려면:

  1. Tools > Android > Permissions 로 이동합니다.

    권한 편집기

  2. 드롭다운 목록에서 권한을 선택한 다음, ‘ Add ’을 선택하여 ‘ Permission ’ 목록에 추가합니다.
  3. 권한을 선택한 다음, [ Edit Attributes ]을 선택하여 해당 권한의 속성을 설정합니다.

    권한 속성 편집기

  4. ' Attribute'에서 속성을 선택합니다.
  5. ' Value'에서 속성의 값을 입력합니다.
  6. ' Add '을 선택하여 속성과 값을 설정합니다.
  7. OK 를 선택하여 해당 속성을 권한에 추가합니다.

Include default permissions for Qt modulesInclude default features for Qt modules 를 선택하여 Qt 라이브러리에 필요한 권한을 추가합니다(예: android.permission.ACCESS_BACKGROUND_LOCATION 의 경우 Qt Positioning.

'Android용 개발 방법', 'Android용 개발' 및 'Android용 Qt 매니페스트 파일 구성'도 참조하십시오 .

Copyright © The Qt Company Ltd. and other contributors. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.