Qt Quick para Android

Qt Quick para Android visión general

La base de este enfoque es ofrecer las APIs Qt Qml de forma integrada para que la aplicación siga siendo una aplicación Android relativamente típica. Este enfoque ofrece un enfoque más estándar centrado en Android a costa de aprovechar la naturaleza multiplataforma de una aplicación Qt. Es el más adecuado para añadir características Qt deseables a una aplicación Android existente.

• Android crea el contenido Qt y lo controla.
• Para el desarrollo se utiliza Android Studio con el plugin Qt Tools for Android Studio.
• Para el contenido Qt, se utilizan Qt Creator o Qt Design Studio.
• Los lenguajes principales son Java y Kotlin, con QML utilizado para partes específicas como el contenido 3D.
• Puedes usar las APIs de Android que quieras, pero puedes usar JNI si quieres más control sobre la comunicación entre tu código Java y QML. Consulta QJniObject y QJniEnvironment.

En qué se diferencia de Qt para Android

La diferencia más destacada entre estos enfoques es la estructura del proyecto. Las aplicaciones Qt para Android son proyectos CMake que pueden construirse para Android u otras plataformas, mientras que un proyecto Qt Quick para Android es un proyecto Android que incluye contenido QML y sólo puede construirse para Android.

El principal objetivo del enfoque Qt para Android es dejar que Qt se encargue de la mayor parte del trabajo de la arquitectura y el código boilerplate de la aplicación y que tú te centres en el contenido. Ofrece un enfoque multiplataforma completo y fiable.

• Qt crea y controla la aplicación Android.
• Qt Creator, Qt Design Studioo Visual Studio.
• Los lenguajes principales son C++ y QML.
• Los aspectos específicos de Android están más ocultos; Qt los maneja internamente.
• Para usar las APIs de Android que aún no están disponibles como APIs de Qt, debes usar JNI. Véase QJniObject y QJniEnvironment.

Consulte Cómo funciona Qt para Android para más detalles sobre la arquitectura de Qt para Android.

Cómo funciona Qt Quick para Android

Qt Quick para Android te ofrece APIs Android que te permiten insertar contenido QML como una Vista Android en tu proyecto.

APIs

Estas son las API públicas de Java y Kotlin que utilizarás en una aplicación Android para incrustar QML.

Clases Java

• QtQuickView
• QtQuickViewContent
• QtAbstractItemModel
• QtAbstractListModel
• QtModelIndex

Interfaces

• QtQmlStatusChangeListener (que utiliza el enum QtQmlStatus )

Ejemplos de API

• Qt Quick para proyectos Android Studio
• Exposición de QtAbstractListModel a QML
• Uso de QtAbstractItemModel en proyectos de Android Studio

Cambios en main() son requeridos por Qt Quick para Android APIs

El main.cpp de una aplicación típica de Qt Quick tiene este aspecto:

#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();
}

En main() no necesitamos crear un Motor QML ni cargar ningún QML que será manejado más tarde por las APIs de Vistas de Qt Quick. Todo lo que necesitamos está en main() es:

#include <QGuiApplication>

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

    return app.exec();
}

Ejecutar Qt Quick para ejemplos Android

Qt Quick para los ejemplos de Android API son Proyectos de Android Studio

Los ejemplos de la API Qt Quick para Android se proporcionan como proyectos de Android Studio. Las carpetas de los proyectos se encuentran en la ubicación de instalación de Qt.

Por ejemplo, en la ruta de instalación por defecto de Windows, se encuentran aquí:

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

Estos proyectos ya están configurados para usar una versión del plugin Qt Gradle compatible con esta versión de Qt.

Herramientas

El plugin Qt Gradle y el plugin Qt Tools for Android Studio son proporcionados por Qt para facilitar el desarrollo. Puedes usar el plugin Gradle independientemente de un IDE como parte de tu cadena de herramientas de compilación. Qt Tools para Android Studio utiliza el plugin para construir tus proyectos en Android Studio.

A dónde ir desde aquí

Los siguientes temas adicionales se aplican a Qt Quick para Android: