配備ガイド

概要

このドキュメントでは、Qt Virtual Keyboard プラグインを Qt アプリケーションにデプロイして使用する方法について説明します。

配置

様々なQt Virtual Keyboard プラグインとファイルは以下の場所に配置されます：

依存関係

詳しくはQt のライブラリのデプロイ をご覧ください。

統合方法

Qt Virtual Keyboard Qtvkbstylesplugin では、プラグインを使用するために 2 つの統合方法をサポートしています：

• Desktop既存のアプリケーションに変更を加える必要がありません。システム内のすべての Qt アプリケーションが仮想キーボードを利用できます。

  この統合方法では、キーボードは専用のトップレベルウィンドウに表示されます。

• Applicationこの統合方法では、キーボードは専用のトップレベルウィンドウに表示されます。 : 仮想キーボードは Qt アプリケーションの中に埋め込まれ、QML のInputPanel アイテムをインスタンス化します。

  この方法は、複数のトップレベルウィンドウがサポートされていない環境（組み込み機器など）では必須ですが、デスクトップアプリケーションでも使用できます。

  また、このメソッドはQt Waylandコンポジタがサーバサイドの仮想キーボードを提供するために使用することもできます。詳細は以下のセクションを参照してください。

統合方法はプロジェクトファイルによって自動的に選択されます。しかしデスクトップ環境では、QT_VIRTUALKEYBOARD_DESKTOP_DISABLE 環境変数を使うか、configure コマンドラインに-no-vkb-desktop を追加することで、デスクトップ統合方式をオーバーライドし、代わりにアプリケーション統合方式を使うことができます。

Qt WaylandでQt Virtual Keyboard 。

このセクションでは、Qt Virtual Keyboard を使用して、コンポジターとしてFancy Compositor のサンプルを使用して、Qt Widgets Line Edits のサンプルと対話する方法を説明します。

ここではUbuntu 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. Line Edits のサンプルをクライアントとして起動します：

   ./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 の作成

次の例では、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
    }
}

入力パネルは、アプリケーション・コンテナの隣の兄弟要素でなければなりません。入力パネルをアプリケーション・コンテナの中に入れてはいけません。また、入力パネルの高さは使用可能な幅に応じて自動的に更新されます。

環境変数

モジュールによって定義される環境変数がいくつかあります：