QtJenny: Generación de clases proxy en C++ para acceder a las API de Android
Demostración que muestra el uso de QtJenny.

Descripción general
Esta demostración muestra el uso de QtJenny y lo utiliza para generar clases proxy en C++ que permiten acceder a las API de Android desde código C++. Las clases de C++ generadas se utilizan en la aplicación de interfaz de usuario de esta demostración para realizar acciones como ajustar el volumen y el brillo, activar y desactivar bloqueos de activación, enviar notificaciones y activar vibraciones. Estas acciones forman parte de las API de Android que Qt no implementa.
La generación de clases de C++ mediante QtJenny elimina la necesidad de escribir código JNI manualmente.
Cómo funciona
La demostración consta de dos partes diferenciadas: por un lado, la aplicación de interfaz de usuario, es decir, el proyecto « Qt Quick » denominado qtjenny_consumer, que utiliza el código generado por QtJenny; y, por otro, una combinación de tres proyectos Gradle diferentes denominados qtjenny_general, qtjenny_callback y qtjenny_baseclass, que, en conjunto, se encargan de la generación de código mediante QtJenny. Cada uno de los tres proyectos de Gradle contiene anotaciones de clases y configuraciones de « Gradle » para la generación de código con QtJenny.
La generación de código con QtJenny se activa automáticamente durante la configuración de CMake del proyecto qtjenny_consumer mediante la ejecución de la tarea Gradle « kaptReleaseKotlin » en cada uno de los proyectos Gradle qtjenny_general, qtjenny_callback y qtjenny_baseclass.
if (ANDROID)
if (CMAKE_HOST_SYSTEM_NAME STREQUAL "Windows")
set (gradlew_cmd "gradlew.bat")
else()
set (gradlew_cmd "./gradlew")
endif()
set (gradlew_arg "--rerun-tasks")
set (gradlew_task "kaptReleaseKotlin")
execute_process(COMMAND ${gradlew_cmd} ${gradlew_arg} ${gradlew_task}
WORKING_DIRECTORY "${PROJECT_SOURCE_DIR}/qtjenny_baseclass")
execute_process(COMMAND ${gradlew_cmd} ${gradlew_arg} ${gradlew_task}
WORKING_DIRECTORY "${PROJECT_SOURCE_DIR}/qtjenny_general")
execute_process(COMMAND ${gradlew_cmd} ${gradlew_arg} ${gradlew_task}
WORKING_DIRECTORY "${PROJECT_SOURCE_DIR}/qtjenny_callback")
else()
message(FATAL_ERROR "Example only works on Android")
endif()Al ejecutar el proyecto qtjenny_consumer, se inicia la aplicación de interfaz de usuario.
Generación de los encabezados de C++
Al ejecutar la tarea « kaptReleaseKotlin » en los proyectos Gradle, se activa un procesador de anotaciones que procesa las anotaciones declaradas en GenerateCppCode.kt.
Fragmento de código del archivo « GenerateCppCode.kt » de qtjenny_general:
@NativeClass
@NativeProxy(allMethods = false, allFields = false)
@NativeProxyForClasses(namespace = "android::os", classes = [BatteryManager::class, VibratorManager::class,
Vibrator::class, VibrationEffect::class, Context::class, PowerManager::class, PowerManager.WakeLock::class,
Handler::class, Looper::class])
@NativeProxyForClasses(namespace = "android::view", classes = [Window::class, WindowManager.LayoutParams::class])
@NativeProxyForClasses(namespace = "android::media", classes = [AudioManager::class])
@NativeProxyForClasses(namespace = "android::drawable", classes = [android.R.drawable::class])
@NativeProxyForClasses(namespace = "android::app", classes = [Activity::class, Notification::class,
Notification.Builder::class, NotificationChannel::class, NotificationManager::class])
@NativeProxyForClasses(namespace = "android::provider", classes = [Settings.Global::class, Settings.System::class,
Settings::class])
@NativeProxyForClasses(namespace = "android::content", classes = [Intent::class, ContentResolver::class])En el caso de qtjenny_general, el procesador de anotaciones genera los encabezados C++ en el directorio qtjenny_output. Dichos encabezados C++ contienen el código JNI estándar necesario para acceder a las API de Android utilizadas en qtjenny_consumer.
El script « build.gradle » a nivel de aplicación, ubicado en qtjenny_general, especifica los argumentos para kapt que implementa QtJenny. Estos argumentos se analizan en el compilador de QtJenny y se utilizan en el proceso de generación.
kapt {
arguments {
// pass arguments to jenny
arg("jenny.outputDirectory", project.file("../../qtjenny_output"))
arg("jenny.templateDirectory", project.file("../templates"))
arg("jenny.headerOnlyProxy", "true")
arg("jenny.useJniHelper", "false")
arg("jenny.useTemplates", "true")
}
}qtjenny_general
El qtjenny_general se encarga de generar envoltorios para las clases de Java, lo que permite construir objetos Java e invocar métodos en ellos. Estos envoltorios envuelven las llamadas a métodos habituales y, para las llamadas de retorno, se utilizan qtjenny_baseclass y qtjenny_callback.
qtjenny_baseclass
qtjenny_baseclass permite, en la práctica, ampliar la clase Java ContentObserver en código C++, mediante una combinación de la generación de clases base y la generación de devoluciones de llamada.
qtjenny_callback
qtjenny_callback permite, en la práctica, implementar una interfaz de Java en C++. La clase qtjenny_baseclass, que es una extensión de esta, también utiliza este mecanismo.
Para implementar una interfaz, se crea una clase proxy de Java utilizando un InvocationHandler que realiza llamadas a funciones virtuales en la jerarquía de clases de C++ generada.
Para extender una clase base, la clase extendida generada realiza llamadas a funciones virtuales dentro de la jerarquía de clases de C++ generada.
Uso de los encabezados de C++ generados en la aplicación « Qt Quick »
qtjenny_consumer es la aplicación « Qt Quick » que utiliza los encabezados C++ generados por qtjenny_general. Incluimos los encabezados generados en el fichero backend.h y los utilizamos en backend.cpp para acceder a diversas API de Android.
La interfaz de usuario de la aplicación consta de un archivo Main.qml, que está conectado a la clase BackEnd mediante las macros Q_INVOKABLE y Q_PROPERTY.
La interfaz de usuario contiene los siguientes controles y acciones.
Bloqueos de activación
Puedes activar y desactivar bloqueos de activación totales o parciales mediante Switches. Estos interruptores activan las funciones correspondientes Q_INVOKABLE de la clase Backend, que activan el bloqueo de activación y establecen el texto de estado del bloqueo de activación que se mostrará al usuario en la interfaz de usuario.
if (checked) {
myBackEnd.setFullWakeLock()
if (partialWakeLock.checked)
partialWakeLock.click()
mainWindow.wakeLockStatus = "Full WakeLock active"Para configurar un bloqueo de activación parcial se utiliza la clase WakeLockProxy, que se conecta a la API de Android PowerManager.WakeLock. Para configurar un bloqueo de activación completo se utiliza la clase WindowProxy, que se conecta a la API de Android Window.
Vibración
Se puede activar una vibración mediante la función BackEnd::vibrate(), que utiliza las clases VibrationEffectProxy, VibratorManagerProxy y VibratorProxy para generar la vibración.
Notificaciones
El envío de una notificación se gestiona en la función ` BackEnd::notfy() ` de ` Backend ` mediante el uso de la clase ` NotificationManagerProxy `.
La notificación ya se crea durante la inicialización de la clase ` Backend ` en la función ` BackEnd::createNotification() `.
Ajuste del brillo
Al ajustar el brillo con el control deslizante de la interfaz de usuario, se produce un cambio en las propiedades de la clase ` Backend `, que se gestiona en la función ` BackEnd::setBrightness() `. Allí, el brillo del sistema se ajusta mediante las clases ` SettingsProxy`, ` SystemProxy`, ` ContextProxy`, ` LayoutParamsProxy ` y ` WindowProxy `.
El control deslizante de brillo se sincroniza dinámicamente con el brillo del sistema, por lo que, si se modifica el brillo del sistema desde fuera de la aplicación, el control deslizante se ajusta para reflejar el brillo actual del sistema.
Si la aplicación no tiene permiso para escribir en la configuración del sistema, se inicia un « Activity » con el intent « ACTION_MANAGE_WRITE_SETTINGS ». Una vez iniciado este « Activity », el usuario debe conceder manualmente permiso a la aplicación para que pueda escribir en la configuración del sistema.
Ajustar el volumen
Al ajustar el volumen con el control deslizante de la interfaz de usuario, se desencadena un cambio en las propiedades de la clase Backend, que se gestionará en la función BackEnd::setVolume(). Allí se ajusta el volumen del sistema mediante la clase AudioManagerProxy.
El control deslizante de volumen se sincroniza dinámicamente con el volumen de música del sistema, por lo que, si se modifica el volumen de música del sistema desde fuera de la aplicación, el control deslizante de volumen se ajusta para reflejar el volumen de música actual del sistema.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.