Déploiement d'applications QML

Cette page fournit des informations sur le déploiement des applications QML. Elle traite de l'utilisation d'Qt Creator pour le déploiement, ainsi que de l'utilisation du système de ressources Qt pour regrouper les fichiers QML et d'autres ressources avec l'exécutable de l'application.

Le déploiement d’applications avec Qt Creator

Qt Creator déploie et regroupe les applications QML sur diverses plateformes. Pour les appareils mobiles, Qt Creator peut directement regrouper les applications au format de paquet spécifique à la plateforme, tel que l’APK.

Lorsque vous exécutez vos applications sur la plateforme cible, celles-ci doivent accéder à l’emplacement des bibliothèques QML. Si vous utilisez qmake, la variable d’environnement ` QT_INSTALL_QML ` pointe vers l’emplacement de ces bibliothèques. Les programmes d’installation Qt installent les bibliothèques QML dans le répertoire : <version>/ <COMPILATEUR>/qml.

Utilisation du système de ressources Qt avec QML

Le système de ressources Qt permet de stocker des fichiers de ressources sous forme de fichiers binaires dans l’exécutable d’une application. Le système de ressources Qt est utilisé pour les applications Qml, car il permet de référencer les fichiers Qml et d’autres ressources – telles que les images et les fichiers audio – via le schéma URI du système de ressources plutôt que par des chemins relatifs ou absolus vers des ressources du système de fichiers.

L’API du module QML de CMake place automatiquement vos fichiers QML dans le système de ressources. Pour y accéder, chargez votre fichier QML principal en tant que ressource ou en tant qu’URL utilisant le schéma qrc. Le chemin d’accès dans le système de ressources où se trouvent vos fichiers QML peut être obtenu en concaténant :

• l’URL RESOURCE_PREFIX que vous avez transmise à qt_add_qml_module.
• /qt/qml, si vous n’ avez pas transmis d’ RESOURCE_PREFIX à qt_add_qml_module et que la politique QTP0001 est définie sur NEW.
• /, si vous n’ avez pas transmis d’ RESOURCE_PREFIX à ` qt_add_qml_module ` et que la politique QTP0001 est définie sur ` not ` et ` NEW`.
• Si vous n’ avez pas passé NO_RESOURCE_TARGET_PATH à qt_add_qml_module: l’ URI que vous avez passé à qt_add_qml_module, les points étant remplacés par des barres obliques.

Par exemple, un module nommé My.Own.Module est placé à l’emplacement :

• :/qt/qml/My/Own/Module/ si vous avez spécifié /qt/qml comme RESOURCE_PREFIX, ou si vous n’ avez pas passé RESOURCE_PREFIX et que la politique QTP0001 est définie sur NEW.
• :/My/Own/Module/ si vous avez spécifié / comme RESOURCE_PREFIX, ou si vous n' avez pas transmis RESOURCE_PREFIX et que la politique QTP0001 n' est pas définie sur NEW.
• :/Some/Prefix/My/Own/Module/ si vous avez défini « Some/Prefix/ » comme RESOURCE_PREFIX
• :/ si vous avez spécifié NO_RESOURCE_TARGET_PATH

Une fois cette opération effectuée, tous les fichiers spécifiés par des chemins relatifs dans QML sont chargés à partir du système de ressources. L’utilisation du système de ressources est totalement transparente pour la couche QML ; cela signifie que tout le code QML doit faire référence aux fichiers de ressources à l’aide de chemins relatifs et ne doit pas utiliser le schéma qrc. Ce schéma ne doit être utilisé qu’à partir du code C++ pour faire référence aux fichiers de ressources.

Informations connexes

• Déploiement d’applications Qt
• Qt Creator: Exécution sur de nombreuses plateformes
• Exposition des attributs des types C++ vers QML
• Le système de ressources Qt