HarmonyOS용 Qt 애플리케이션 빌드 및 배포

이 페이지에서는 HarmonyOS용 Qt 애플리케이션을 빌드 및 패키징하는 방법과, 기기 또는 에뮬레이터에서 실행하는 방법을 설명합니다.

HAP로 패키징

HarmonyOS 애플리케이션은 HarmonyOS Ability Package(HAP) 형태로 배포됩니다. HarmonyOS를 대상으로 qt_add_executable()을 사용하여 Qt 애플리케이션 실행 파일을 생성하면, Qt는 자동으로 ‘ <target>_make_hap ’ 빌드 타깃을 생성합니다. 해당 타깃을 빌드하면 애플리케이션용 HAP가 생성됩니다:

cmake --build . --target <target>_make_hap

배포 방식

<target>_make_hap 타깃은 HarmonyOS 배포 도구인 harmonydeployqt를 실행합니다. 이 도구는 androiddeployqt와 동일한 방식을 따릅니다. 즉, 애플리케이션의 공유 라이브러리, HarmonyOS 플랫폼 플러그인(libqohos.so), 필요한 Qt 모듈, 그리고 Qt Quick 애플리케이션의 경우 QML 모듈을 수집하여 HarmonyOS 애플리케이션 템플릿에 배치합니다. 그런 다음 OpenHarmony hvigor 빌드 도구를 호출하여 최종 HAP를 조합합니다.

HarmonyOS 매니페스트(app.json5 및 module.json5)에 기록될 메타데이터를 구성하고 권한을 선언하려면, Qt for HarmonyOS CMake API에 설명된 명령어를 사용하십시오.

애플리케이션 실행

생성된 HAP를 연결된 HarmonyOS 기기나 에뮬레이터에 설치하고 실행합니다. 배포 및 디버깅을 위한 가장 편리한 방법은 DevEco Studio에서 생성된 프로젝트를 열고, 해당 실행 및 디버깅 도구를 사용하는 것입니다.