Qt Quick pour Android

Qt Quick Présentation d'Android

Le principe de cette approche consiste à proposer les API Qt Qml de manière intégrée, afin que l'application reste une application Android relativement classique. Cette approche offre une solution plus standard, centrée sur Android, au détriment de la nature multiplateforme d'une application Qt. Elle est particulièrement adaptée pour ajouter des fonctionnalités Qt utiles à une application Android existante.

• C'est Android qui crée le contenu Qt et le contrôle.
• Le développement s'effectue dans Android Studio à l'aide du plugin « Qt Tools for Android Studio ».
• Pour le contenu Qt, on utilise Qt Creator ou Qt Design Studio.
• Les langages principaux sont Java et Kotlin, le QML étant utilisé pour des éléments spécifiques tels que le contenu 3D.
• Vous pouvez utiliser toutes les API Android de votre choix, mais vous pouvez recourir à JNI si vous souhaitez davantage de contrôle sur la communication entre votre code Java et QML. Consultez QJniObject et QJniEnvironment.

En quoi cela diffère-t-il de Qt pour Android ?

La différence la plus notable entre ces deux approches réside dans la structure du projet. Les applications Qt pour Android sont des projets CMake pouvant être compilés pour Android ou d’autres plateformes, tandis qu’un projet « Qt Quick for Android » est un projet Android incluant du contenu Qml et ne pouvant être compilé que pour Android.

L'objectif principal de l'approche Qt pour Android est de laisser Qt se charger de la majeure partie du travail lié à l'architecture et au code standard de l'application, afin que vous puissiez vous concentrer sur le contenu. Elle offre une approche multiplateforme complète et fiable.

• Qt crée et gère l’application Android.
• Qt Creator, Qt Design Studio, ou Visual Studio peuvent être utilisés.
• Les langages principaux sont le C++ et le QML.
• Les spécificités Android sont davantage masquées ; Qt les gère en interne.
• Pour utiliser des API Android qui ne sont pas encore disponibles sous forme d'API Qt, vous devez utiliser JNI. Consultez QJniObject et QJniEnvironment.

Consultez la section « Comment fonctionne Qt pour Android » pour plus de détails sur l'architecture de Qt pour Android.

Fonctionnement d’ Qt Quick pour Android

Qt Quick pour Android vous offre des API Android qui vous permettent d'insérer du contenu QML en tant que vue Android dans votre projet.

API

Voici les API publiques Java et Kotlin que vous utiliserez dans une application Android pour intégrer du code QML.

Classes Java

• QtQuickView
• QtQuickViewContent
• QtAbstractItemModel
• QtAbstractListModel
• QtModelIndex

Interfaces

• QtQmlStatusChangeListener (qui utilise l’énumération QtQmlStatus )

Exemples d'API

• Qt Quick pour les projets Android Studio
• Exposition de QtAbstractListModel en QML
• Utilisation de QtAbstractItemModel dans les projets Android Studio

Des modifications dans « main() » sont requises par « Qt Quick » pour les API Android

Le fichier main.cpp d'une application Qt Quick type se présente comme suit :

#include <QGuiApplication>
#include <QQmlApplicationEngine>

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);

    QQmlApplicationEngine engine;
    QObject::connect(
        &engine,
        &QQmlApplicationEngine::objectCreationFailed,
        &app,
        []() { QCoreApplication::exit(-1); },
        Qt::QueuedConnection);
    engine.loadFromModule("MyQtQuickProject", "Main");

    return app.exec();
}

Dans main(), il n’est pas nécessaire de créer un moteur QML ni de charger de fichiers QML, car ceux-ci seront gérés ultérieurement par les API de vue d’ Qt Quick. Tout ce dont nous avons besoin se trouve dans le fichier « main() » :

#include <QGuiApplication>

int main(int argc, char *argv[])
{
    QGuiApplication app(argc, argv);

    return app.exec();
}

Exécuter les exemples d’ Qt Quick pour Android

Qt Quick Les exemples d’API pour Android sont des projets Android Studio

Les exemples de l'API « Qt Quick » pour Android sont fournis sous forme de projets Android Studio. Les dossiers de ces projets se trouvent dans le répertoire d'installation de Qt.

Par exemple, dans le chemin d'installation par défaut sous Windows, ils se trouvent ici :

C:\Qt\Examples\Qt-<patch-release-number>\platforms\android\<example-name>

Ces projets sont déjà configurés pour utiliser une version du plugin Gradle Qt compatible avec cette version de Qt.

Outils

Le plugin Gradle Qt et le plugin Qt Tools for Android Studio sont fournis par Qt pour faciliter le développement. Vous pouvez utiliser le plugin Gradle indépendamment d’un IDE dans le cadre de votre chaîne d’outils de compilation. Qt Tools for Android Studio utilise ce plugin pour compiler vos projets dans Android Studio.

Et maintenant ?

Les rubriques supplémentaires suivantes s'appliquent à « Qt Quick » pour Android :