Qtバーチャルキーボードの構築

概要

このドキュメントでは、Qt Virtual Keyboard プラグインのビルド方法について説明します。

プロジェクトは以下のサブプロジェクトに分かれています：

設定オプション

以下の表は、仮想キーボード機能を設定するためのトップレベルのオプションです。これらのオプションはconfigureツールに渡されます。

Hunspellの統合

デフォルトでは、Hunspellライブラリと開発ヘッダーが見つからない限り、HunspellInputMethodは利用できない。Linux/X11ターゲットでは、libhunspell-devパッケージをインストールすることで、Hunspellライブラリを提供できます。あるいは、Hunspell gitリポジトリをsrc/plugins/hunspell/3rdparty/hunspellディレクトリにクローンすることもできます。ソースはqmakeによって自動的に検出され、プロジェクトはローカルのHunspellを使用するように設定されます。Hunspellソースを使用する場合、辞書ファイルもsrc/plugins/hunspell/3rdparty/hunspell/dataディレクトリにコピーする必要があります。

Hunspell ソースと辞書ファイルを設定した後のディレクトリ構造の例を以下に示します：

3rdparty
└── hunspell
    ├── data
    │   ├── en_GB.aff
    │   └── en_GB.dic
    ├── hunspell <-- Hunspell git repository
    └── CMakeLists.txt

Cerence Handwriting 統合

Cerence Handwriting Integration は、Alphabetic および CJK (Chinese Japanese Korean) エンジンをサポートします。どちらのエンジンも T9WriteInputMethod を介して統合されます。入力メソッドは、一度に 1 つのエンジンで初期化されます。エンジンの選択は、現在の入力ロケールに基づいて自動的に行われます。

セレンスの手書き文字との互換性

Qt Virtual Keyboard は Cerence Handwriting v8.7 以降と互換性があります。

Cerence Handwriting ビルドの準備

SDK のコンテンツは、cerenceディレクトリにあるunpack.pyスクリプトを使用して解凍する必要があります。これにより、CMake がコンテンツを見つけるための正しいディレクトリ構造が確保されます。

$ cd src/plugins/cerence/
$ python unpack.py filename.zip

これにより、src/plugins/cerence/sdkディレクトリにコンテンツが解凍され、CMake が自動的にコンテンツをピックアップできるようになります。

また、コマンドラインに追加のパラメータを追加することで、他のディレクトリに解凍することもできます。この場合、SDK の場所をconfigureスクリプトに渡す必要があります。

configure ... -vkb-cerence-sdk /path/to/cerence/sdk

セレンス SDK のレイアウト

解凍されたSDKの中身は以下のようになっています：

sdk
├───t9write
│   ├───api
│   ├───data
│   │   ├───arabic
│   │   ├───hebrew
│   │   └───thai
│   └───lib
│       ├───linux
│       │   ├───arm64
│       │   │   ├───shared
│       │   │   │   ├───alphabetic
│       │   │   │   └───cjk
│       │   │   └───static
│       │   │       ├───alphabetic
│       │   │       └───cjk
│       │   └───x86_64
│       │       ├───shared
│       │       │   ├───alphabetic
│       │       │   └───cjk
│       │       └───static
│       │           ├───alphabetic
│       │           └───cjk
│       └───win32
│           ├───x86
│           │   ├───shared
│           │   │   ├───alphabetic
│           │   │   └───cjk
│           │   └───static
│           │       ├───alphabetic
│           │       └───cjk
│           └───x86_64
│               ├───shared
│               │   ├───alphabetic
│               │   └───cjk
│               └───static
│                   ├───alphabetic
│                   └───cjk
└───xt9
    ├───api
    ├───data
    └───lib
        ├───linux
        │   ├───arm64
        │   │   ├───shared
        │   │   └───static
        │   └───x86_64
        │       ├───shared
        │       └───static
        └───win32
            ├───x86
            │   ├───shared
            │   └───static
            └───x86_64
                ├───shared
                └───static

各ディレクトリの内容は次のとおりです：

Cerence SDK が検出されると、Cerence Handwriting および XT9 統合コードが自動的に有効になります。

実行時に競合する動作を避けるため、Cerence 拡張をビルドする前に、[qtbase]/plugins/virtualkeyboardディレクトリから他の拡張をすべてクリーンアップする必要があります。Cerence 拡張は、他の仮想キーボードプラグインを必要としません。

XT9 用の手書きデータベースと言語データベースは[qtbase]/qtvirtualkeyboard/cerenceディレクトリにインストールされます。さらに、これらのファイルの場所として、他に2つの選択肢がある：

• 環境変数で定義されたカスタムランタイムの場所
• プラグインバイナリにリソースを埋め込む-vkb-bundle-cerenceコマンドラインオプション

MyScript Text SDK の統合

MyScript Text は、手書きテキストの認識を可能にするアプリケーションを構築するために設計されています。MyScript Text では、孤立文字、草書体、印刷物、および重ね書きの認識をサポートしています。MyScript スーパーインポーズドライティングは、Qt Virtual Keyboard に統合されています。この機能により、連続する断片を明示的に区切ることなく、文字、単語、または単語の一部を重ねて認識することができます。メモリと CPU に制約のあるデバイスで実行できます。

MyScript Text SDK の入力手書きスタイル

エンドユーザーは、次の図のように、単語を 1 つずつ重ねて書いたり、文字を 1 つずつ重ねて書いたりできます。書き込まれた 2 つの単語の間にはスペースが自動的に追加されるため、明示的なジェスチャーは必要ありません。

MyScript Text SDK の対応言語

MyScript Superimposed は 72 の言語をサポートしています。

MyScript Text SDK パッケージのインストール

MyScript 配送チームでは、さまざまな.zip アーカイブを含むパッケージを提供しています。独自の手書きアプリケーションのビルドに必要なすべてのコード、ツール、およびリソースにアクセスするには、すべてのパッケージを src/plugins/myscript/sdk と同じ保存先フォルダに解凍します。

また、他のディレクトリにパッケージを展開することもできます。この場合、SDKの場所をconfigureスクリプトに渡す必要があります。

configure ... -vkb-myscript-sdk /path/to/myscript/sdk

ファイル階層は以下のようになります：

myscript
└── sdk
    ├─── conf
    ├─── doc
    ├─── edk
    ├─── engine
    │   └─── bin
    │       ├─── lin-arm64
    │       │   └─── *.so
    │       ├─── lin-armv7
    │       │   └─── *.so
    │       ├─── lin-armv7hf
    │       │   └─── *.so
    │       ├─── lin-x64
    │       │   └─── *.so
    │       ├─── lin-x86
    │       │   └─── *.so
    │       ├─── win-x64
    │       │   └─── *.dll
    │       ├─── win-x86
    │       │   └─── *.dll
    │       (etc.)
    ├─── rdk
    ├─── resources
    │   ├─── ar
    │   │   └─── *.res
    │   ├─── en_GB
    │   │   └─── *.res
    │   ├─── ja_JP
    │   │   └─── *.res
    │   ├─── ko_KR
    │   │   └─── *.res
    │   ├─── zh_CN
    │   │   └─── *.res
    │   (etc.)
    ├─── tools
    └─── voim
        ├─── api
        ├─── bin
        │   ├─── lin-arm64
        │   │   └─── *.so
        │   ├─── lin-armv7
        │   │   └─── *.so
        │   ├─── lin-armv7hf
        │   │   └─── *.so
        │   ├─── lin-x64
        │   │   └─── *.so
        │   ├─── lin-x86
        │   │   └─── *.so
        │   ├─── win-x64
        │   │   └─── *.dll
        │   ├─── win-x86
        │   │   └─── *.dll
        │   (etc.)
        └─── conf

各ディレクトリの内容の説明は以下の通りです：

MyScript Text SDK の証明書の設定

MyScript Text SDK を使用するには、有効な証明書が必要です。これは、MyScript テクノロジの正規のお客様であることを一意に識別するセキュリティ対策です。証明書は、MyScript が顧客の身元と購入した製品を追跡するのに役立ちます。

[your_login].vo.zip packageこのパッケージを解凍すると、証明書は自動的に適切な場所に置かれます。これにより、提供されたサービスやコードサンプル内で証明書が即座に動作するようになります。

MyScript Text SDK を使用して Qt Virtual Keyboard を構築する方法

MyScript Text SDK が検出されると、MyScript 統合コードが自動的に有効になります。

MyScript Text SDK 用の言語リソースは[qtbase]/qtvirtualkeyboard/myscriptディレクトリにインストールされます。

静的ビルド

仮想キーボードは、アプリケーションに対して静的にビルドおよびリンクすることができます。これは Qt も静的にビルドされることを意味します（configure コマンドラインで -static オプションを使用します）。