ビルドQt Virtual Keyboard

概要

このドキュメントでは、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 手書き入力統合

Cerence Handwriting 統合は、Alphabetic および CJK（中国語・日本語・韓国語）エンジンをサポートしています。両方のエンジンは T9WriteInputMethod を通じて統合されています。入力メソッドは、一度に 1 つのエンジンで初期化されます。エンジンの選択は、現在の入力ロケールに基づいて自動的に行われます。

Cerence Handwritingの互換性

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

Cerence 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 手書き入力および 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つの文字を別の文字の上に書き込むことができます。2つの単語の間にスペースが自動的に挿入されるため、明示的な操作を行う必要はありません。

MyScript Text SDKの対応言語

MyScript Superimposed は 72 言語に対応しています。

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

MyScript デリバリーチームは、さまざまな.zip アーカイブを含むパッケージを提供します。独自の手書き文字認識アプリケーションを構築するために必要なすべてのコード、ツール、およびリソースにアクセスするには、すべてのパッケージを src/plugins/myscript/sdkと同じ保存先フォルダに解凍してください。そうすることで、CMake が自動的にそれらを認識できるようになります。

あるいは、パッケージを任意のディレクトリに展開することも可能です。その場合は、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 Virtual Keyboard をビルドし、アプリケーションに対して静的にリンクすることができます。これは、Qt も静的にビルドされる（configure コマンドラインで -static オプションを使用）ことを意味します。