Qt WebView

Qt WebView 를 사용하면 QML 애플리케이션 내에서 웹 콘텐츠를 표시할 수 있습니다. 전체 웹 브라우저 스택을 포함하지 않기 위해 Qt WebView 는 적절한 경우 네이티브 API를 사용합니다.

이는 Android 및 iOS와 같은 모바일 플랫폼에서 유용합니다. iOS에서는 모든 웹 콘텐츠가 운영 체제의 웹 보기를 사용하여 표시되도록 정책이 지정되어 있습니다.

Windows 및 Linux에서 Qt WebView 는 Qt WebEngine 모듈을 사용하여 콘텐츠를 렌더링합니다.

macOS에서는 시스템 웹 보기가 iOS와 동일한 방식으로 사용됩니다.

전제 조건

Qt WebView 모듈이 모든 플랫폼에서 올바르게 작동하도록 하려면 다음을 호출해야 합니다. QtWebView::initialize() 인스턴스를 생성하기 전에 QGuiApplication 인스턴스를 생성하기 전과 윈도우의 QPlatformOpenGLContext 을 생성하기 전에 호출해야 합니다.

모듈 사용하기

QML API

모듈의 QML 유형은 QtWebView 가져오기를 통해 사용할 수 있습니다. 이 유형을 사용하려면 .qml 파일에 다음 import 문을 추가하세요:

import QtWebView

C++ API

Qt 모듈의 C++ API를 사용하려면 모듈 라이브러리에 직접 또는 다른 종속성을 통해 링크해야 합니다. CMake 및 qmake를 비롯한 여러 빌드 도구가 이를 지원합니다.

CMake로 빌드하기

find_package() 명령을 사용하여 Qt6 패키지에서 필요한 모듈 컴포넌트를 찾습니다:

find_package(Qt6 REQUIRED COMPONENTS WebView)
target_link_libraries(mytarget PRIVATE Qt6::WebView)

자세한 내용은 CMake로 빌드 개요를 참조하세요.

qmake로 빌드하기

qmake로 빌드하도록 모듈을 구성하려면 프로젝트의 .pro 파일에 QT 변수의 값으로 모듈을 추가합니다:

QT += webview

제한 사항

플랫폼 제한으로 인해 WebView 을 다른 QML 컴포넌트와 겹치는 것은 지원되지 않습니다. 이렇게 하면 플랫폼마다 다를 수 있는 예측할 수 없는 결과가 발생할 수 있습니다. 또한 애플리케이션은 WebView 의 이벤트에 의존하여 Qt 이벤트 전달 시스템으로 전파할 수 없습니다. 예를 들어, 특정 이벤트를 처리하기 위해 WebView 위에 보이지 않는 항목을 "오버레이"하거나 WebView 에서 처리하지 않는 이벤트를 상위 항목에서 처리하는 것은 불가능합니다.

예제

애플리케이션에서 API를 사용하는 방법에 대한 데모는 Qt WebView 예시를 참조하세요.

참조

• Qt WebView QML Types
• Qt WebView C++ Classes and Namespaces

라이선스

Qt WebView 는 The Qt Company의 상용 라이선스에 따라 사용할 수 있습니다. 또한 GNU 약소 일반 공중 사용 허가서 버전 3 또는 GNU 일반 공중 사용 허가서 버전 2에 따라 사용할 수 있습니다. 자세한 내용은 Qt 라이선스를 참조하십시오.