HarmonyOS용 Qt CMake API

이 페이지에는 Qt 애플리케이션을 HarmonyOS Ability Package(HAP)로 패키징하는 방법을 구성하는 CMake 명령어, 타깃 속성 및 변수가 나열되어 있습니다.

HarmonyOS를 대상으로 qt_add_executable()을 사용하여 Qt 실행 파일을 생성하면, Qt는 HAP를 생성하는 <target>_make_hap 빌드 타깃을 자동으로 생성합니다. 아래의 명령어, 속성 및 변수는 해당 HAP의 내용과 HarmonyOS 매니페스트 파일에 기록되는 메타데이터를 제어합니다.

HarmonyOS 애플리케이션 번들은 두 가지 종류의 매니페스트로 설명됩니다. 전체 번들에 적용되는 메타데이터를 포함하는 애플리케이션 수준의 app.json5 와, 해당 번들 내의 단일 HAP 모듈을 설명하는 모듈 수준의 module.json5 입니다. 아래의 타겟 속성은 이러한 구분을 반영합니다. 즉, QT_HARMONYOS_APP_* 속성은 벤더, 버전, 레이블, 아이콘과 같은 애플리케이션 수준의 메타데이터를 설정하는 반면, QT_HARMONYOS_MODULE_DESCRIPTION 및 QT_HARMONYOS_ABILITY_ORIENTATION과 같은 속성은 모듈 수준의 메타데이터를 설정합니다. 전체 목록은 아래의 ‘타깃 속성’ 섹션을 참조하십시오.

명령어

• qt_add_harmonyos_permission()은 애플리케이션에 HarmonyOS 권한을 추가합니다.

타깃 속성

다음 대상 속성은 HAP 빌드 방식에 영향을 미칩니다.

변수

다음 변수들은 HAP 빌드 방식에 영향을 미칩니다: