Qt WebView

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

이는 Android 및 iOS와 같은 모바일 플랫폼에서 유용합니다. iOS의 경우, 정책에 따라 모든 웹 콘텐츠는 운영 체제의 웹 뷰를 사용하여 표시되어야 합니다.

Windows에서는 Qt WebView 가 콘텐츠를 렌더링하기 위해 Qt WebEngine 모듈과 WebView2를 모두 사용하여 콘텐츠를 렌더링할 수 있습니다.

리눅스에서 Qt WebView 는 Qt WebEngine 모듈에 의존합니다.

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

필수 조건

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

모듈 사용법

QML API

이 모듈의 QML 타입은 ` QtWebView ` 임포트를 통해 사용할 수 있습니다. 해당 타입을 사용하려면 .qml 파일에 다음 임포트 문장을 추가하십시오:

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 Lesser General Public License 버전 3 또는 GNU General Public License 버전 2 하에서도 사용할 수 있습니다. 자세한 내용은 Qt 라이선스를 참조하십시오.