Déploiement
Intégrez le clavier dans votre app : consultez le guide Démarrage rapide. Disposition du package, copie manuelle, polices, licences et autres options détaillées : Déploiement avancé.
Ce dont vous avez besoin
Une release LNVK précompilée (plugin + données dictionnaire). Les helpers de déploiement copient le plugin QML et share/lnvirtualkeyboard/dictionaries/ à côté de votre exécutable avec la disposition préfixe d'installation par défaut (bin/, qml/, share/ sous une même racine).
CMake (recommandé)
Ajoutez le répertoire release à CMAKE_PREFIX_PATH, liez votre app et appelez le helper de déploiement :
cmake_minimum_required(VERSION 3.16)
project(MyApp LANGUAGES CXX)
find_package(Qt6 REQUIRED COMPONENTS Quick)
find_package(LNVK REQUIRED CONFIG) # CMAKE_PREFIX_PATH=/path/to/LNVK
add_executable(myapp main.cpp)
target_link_libraries(myapp PRIVATE Qt6::Quick)
set_target_properties(myapp PROPERTIES RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/bin")
ln_virtual_keyboard_deploy(myapp LANGUAGES en fr)
Dans main.cpp, ajoutez le chemin d'import QML avant engine.load() :
engine.addImportPath(QCoreApplication::applicationDirPath() + QStringLiteral("/../qml"));
Configurez et compilez :
cmake -B build -DCMAKE_PREFIX_PATH="/path/to/LNVK"
cmake --build build
Après la build, l'arborescence ressemble à :
build/
├── bin/myapp
├── qml/Ln/VirtualKeyboard/ ← plugin + qmldir
└── share/lnvirtualkeyboard/
└── dictionaries/ ← dispositions, thèmes, données IME/prédiction
Lancez myapp depuis build/bin/ (ou installez l'arborescence complète en conservant les chemins relatifs).
qmake
Ajoutez une ligne à votre fichier .pro :
include(/path/to/LNVK/integration/lnvirtualkeyboard.pri)
Compilez comme d'habitude. Le fichier .pri copie le plugin et les dictionnaires dans votre répertoire de sortie avec la même disposition que CMake.
Pour n'embarquer que les langues utilisées par votre app :
LNVK_LANGUAGES = en fr
include(/path/to/LNVK/integration/lnvirtualkeyboard.pri)
Étapes suivantes
| Objectif | Où regarder |
|---|---|
| Propriétés QML, profils, thèmes | Démarrage rapide, Langues, Thèmes, Configuration |
| Installations plus légères, chemins personnalisés, copie manuelle | Déploiement avancé |
| Polices embarquées optionnelles ou vos propres fichiers | Déploiement avancé — Polices |
| Fichiers de licence en cas de redistribution | Déploiement avancé — Licences |
Dictionnaires .pred personnalisés | Déploiement avancé — Prédiction personnalisée |
Version Qt
Utilisez la release qui correspond à votre version majeure de Qt (Qt 5.15 ou Qt 6.x).