배포 가이드

개요

이 문서는 Qt 애플리케이션과 함께 Qt Virtual Keyboard 플러그인을 배포하고 사용하는 방법을 설명합니다.

배포

다양한 Qt Virtual Keyboard 플러그인 및 파일은 다음 위치에 배포됩니다:

종속성

자세한 내용은 Qt의 라이브러리 배포하기에서 확인하세요.

통합 방법

Qt Virtual Keyboard 현재 플러그인 사용을 위한 두 가지 대체 통합 방법을 지원합니다:

• Desktop기존 애플리케이션을 변경할 필요가 없습니다. 시스템의 모든 Qt 애플리케이션에서 가상 키보드를 사용할 수 있습니다.

  이 통합 방법에서는 키보드가 전용 최상위 창에 표시됩니다.

• Application가상 키보드는 QML에서 InputPanel 항목을 인스턴스화하여 Qt 애플리케이션 자체에 내장됩니다.

  이 방법은 임베디드 장치와 같이 여러 개의 최상위 창을 지원하지 않는 환경에서 필수이지만 데스크톱 애플리케이션에서도 사용할 수 있습니다.

  이 메서드는 서버 측 가상 키보드를 제공하기 위해 Qt Wayland Compositor에서도 사용할 수 있습니다. 자세한 내용은 아래 섹션을 참조하십시오.

통합 방법은 프로젝트 파일에 의해 자동으로 선택됩니다. 그러나 데스크톱 환경에서는 QT_VIRTUALKEYBOARD_DESKTOP_DISABLE 환경 변수를 사용하거나 configure 명령줄에 -no-vkb-desktop 을 추가하여 데스크톱 통합 방법을 재정의하고 대신 애플리케이션 통합 방법을 사용할 수 있습니다.

Qt XML과 함께 Qt Virtual Keyboard 사용

이 섹션에서는 Qt Virtual Keyboard 을 컴포저로 사용하여 Qt Widgets 라인 편집 예제와 상호 작용하는 방법을 설명합니다.

예제를 실행하기 위해 우분투 18.04를 사용하며, 윈도우 시스템으로 X11을 사용합니다. 예제 컴포저(fancy-compositor)는 X11 세션 내에서 창으로 열립니다.

1. 컴포저를 시작합니다:

   QT_XCB_GL_INTEGRATION=xcb_egl QT_WAYLAND_CLIENT_BUFFER_INTEGRATION=xcomposite-egl \
   QT_IM_MODULE=qtvirtualkeyboard ./fancy-compositor -platform xcb

2. 클라이언트 애플리케이션을 실행하기 전에 QT_IM_MODULE이 설정 해제되어 있는지 확인합니다:

   unset QT_IM_MODULE

3. 줄 편집 예제를 클라이언트로 시작합니다:

   ./lineedits -platform wayland

4. 줄 편집을 클릭하면 Qt Virtual Keyboard 의 입력 패널이 열립니다.

문제가 발생하면 컴포저를 실행할 때 다음 환경 변수를 설정하여 문제를 진단하는 데 도움이 되는 디버그 출력을 얻을 수 있습니다:

WAYLAND_DEBUG=1
QT_LOGGING_RULES="qt.virtualkeyboard=true;qt.qpa.wayland*=true"

플러그인 로드

두 가지 통합 방법 모두에서 애플리케이션은 QT_IM_MODULE 환경 변수를 사용하여 플러그인을 로드해야 합니다. 예를 들어

$ QT_IM_MODULE=qtvirtualkeyboard myapp

또는 main() 함수에서:

qputenv("QT_IM_MODULE", QByteArray("qtvirtualkeyboard"));

데스크톱 연동 방법에서는 이 단계만 거치면 Qt Virtual Keyboard 을 사용할 수 있습니다. 애플리케이션 통합 방법에서는 다음 장에서 설명하는 대로 애플리케이션이 InputPanel 인스턴스를 만들어야 합니다.

입력 패널 만들기

다음 예제는 InputPanel 을 만드는 방법과 애플리케이션 컨테이너로 화면 영역을 분할하는 방법을 보여줍니다.

import QtQuick
import QtQuick.VirtualKeyboard

Item {
    id: root
    Item {
        id: appContainer
        anchors.left: parent.left
        anchors.top: parent.top
        anchors.right: parent.right
        anchors.bottom: inputPanel.top
        ...
    }
    InputPanel {
        id: inputPanel
        y: Qt.inputMethod.visible ? parent.height - inputPanel.height : parent.height
        anchors.left: parent.left
        anchors.right: parent.right
    }
}

입력 패널은 애플리케이션 컨테이너 옆에 형제 요소여야 합니다. 입력 패널을 애플리케이션 컨테이너 안에 넣으면 애플리케이션의 콘텐츠와 겹칠 수 있으므로 입력 패널을 애플리케이션 컨테이너 안에 넣지 않는 것이 중요합니다. 또한 입력 패널 높이는 사용 가능한 너비에 따라 자동으로 업데이트되며, 입력 패널의 가로 세로 비율은 일정합니다.

환경 변수

모듈에 정의된 몇 가지 환경 변수는 다음과 같습니다: