빌드 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 필기 인식 통합은 알파벳(Alphabetic) 및 CJK(중국어, 일본어, 한국어) 엔진을 지원합니다. 두 엔진 모두 T9WriteInputMethod를 통해 통합됩니다. 입력 방식은 한 번에 하나의 엔진으로 초기화됩니다. 엔진 선택은 현재 입력 로케일에 따라 자동으로 이루어집니다.

Cerence 필기 인식 호환성

Qt Virtual Keyboard Cerence 필기 인식 v8.7 이상과 호환됩니다.

Cerence 필기 인식 빌드 준비

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 디렉터리에 설치됩니다. 또한, 이러한 파일을 찾을 수 있는 다른 두 가지 방법이 있습니다:

• 환경 변수로 정의된 사용자 지정 런타임 위치
• 플러그인 바이너리에 리소스를 포함시키기 위한 -vkb-bundle-cerence 명령줄 옵션

MyScript Text SDK 통합

MyScript Text는 필기 텍스트 인식을 지원하는 애플리케이션을 구축하기 위해 설계되었습니다. MyScript Text는 개별 문자, 필기체, 인쇄체 및 중첩 필기 인식을 지원합니다. MyScript 중첩 필기 기능은 Qt Virtual Keyboard 에 통합되어 있습니다. 이 기능을 사용하면 연속된 부분들 사이에 명시적인 구분 없이 서로 겹쳐서 쓰인 글자, 단어 또는 단어의 일부를 인식할 수 있습니다. 또한 메모리 및 CPU 자원이 제한된 기기에서도 실행이 가능합니다.

MyScript Text SDK의 필기 입력 방식

최종 사용자는 아래와 같이 한 단어 조각을 다른 단어 위에 쓰거나, 한 문자를 다른 문자 위에 쓸 수 있습니다. 작성된 두 단어 사이의 공백은 자동으로 추가되므로 별도의 제스처가 필요하지 않습니다.

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 옵션을 사용).