En esta página

Notificador de Qt para Android

Muestra cómo llamar a código Java desde Qt en una aplicación de Android.

Panel de notificaciones de Android en el que se muestra un mensaje de Qt Notifier con botones de emoticonos de alegría y tristeza

Este ejemplo muestra cómo añadir una clase Java personalizada a una aplicación de Android y cómo llamarla utilizando las API de conveniencia de JNI en Qt.

Haz clic en uno de los emoticonos para enviar una notificación en la barra de estado de la pantalla de Android.

Ejecución del ejemplo

Puedes ejecutar el ejemplo desde:

Llamada a métodos Java desde código C++

Definimos una clase Java personalizada llamada ` NotificationClient ` en el archivo `NotificationClient.java`:

package org.qtproject.example.androidnotifier;

import android.app.Notification;
import android.app.NotificationManager;
import android.content.Context;
import android.graphics.Bitmap;
import android.graphics.Color;
import android.graphics.BitmapFactory;
import android.app.NotificationChannel;

public class NotificationClient
{
    public static void notify(Context context, String message) {
        try {
            NotificationManager m_notificationManager = (NotificationManager)
                    context.getSystemService(Context.NOTIFICATION_SERVICE);

            Notification.Builder m_builder;
            if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O) {
                int importance = NotificationManager.IMPORTANCE_DEFAULT;
                NotificationChannel notificationChannel;
                notificationChannel = new NotificationChannel("Qt", "Qt Notifier", importance);
                m_notificationManager.createNotificationChannel(notificationChannel);
                m_builder = new Notification.Builder(context, notificationChannel.getId());
            } else {
                m_builder = new Notification.Builder(context);
            }

            Bitmap icon = BitmapFactory.decodeResource(context.getResources(), R.drawable.icon);
            m_builder.setSmallIcon(R.drawable.icon)
                    .setLargeIcon(icon)
                    .setContentTitle("A message from Qt!")
                    .setContentText(message)
                    .setDefaults(Notification.DEFAULT_SOUND)
                    .setColor(Color.GREEN)
                    .setAutoCancel(true);

            m_notificationManager.notify(0, m_builder.build());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

En el archivo de encabezado de la clase C++ de NotificationClient, notificationclient.h, declaramos una sencilla API de C++ para mostrar notificaciones en un dispositivo Android. Consiste en una única propiedad de tipo cadena, notification, y una ranura, updateAndroidNotification(), que llama al código Java:

class NotificationClient : public QObject
{
    Q_OBJECT
public:
    explicit NotificationClient(QObject *parent = 0);

    void setNotification(const QString &notification);
    QString notification() const;

signals:
    void notificationChanged();

private slots:
    void updateAndroidNotification();

private:
    QString m_notification;
};

Conectamos la señal notificationChanged() a la ranura updateAndroidNotification() para actualizar el texto de la notificación cuando cambia el texto de notification:

    m_notification = notification;
    emit notificationChanged();

La función ` updateAndroidNotification() ` llama al método Java responsable de enviar la notificación desde las API de la plataforma Android. Primero, construimos una cadena Java ` jstring ` a partir de la cadena de notificación; a continuación, pasamos el objeto ` jstring ` como parámetro al método ` notify() ` en Java:

void NotificationClient::updateAndroidNotification()
{
    QJniObject javaNotification = QJniObject::fromString(m_notification);
    QJniObject::callStaticMethod<void>(
                    "org/qtproject/example/androidnotifier/NotificationClient",
                    "notify",
                    "(Landroid/content/Context;Ljava/lang/String;)V",
                    QNativeInterface::QAndroidApplication::context(),
                    javaNotification.object<jstring>());
}

La llamada al método de Java utiliza ` QJniObject `, que se basa en las API de la Interfaz Nativa de Java (JNI) para comunicarse con Java. Además, en el fragmento de código anterior, estamos pasando el objeto de contexto de la aplicación, que el código estático de Java puede utilizar para acceder a las propiedades y API específicas de la aplicación.

Para asegurarnos de que nuestros botones de emoticonos funcionan como se espera, añadimos el siguiente código para cambiar el texto de la notificación si se pulsa cualquiera de ellos:

    QObject::connect(&happyButton, &QPushButton::clicked, &happyButton, []() {
        NotificationClient().setNotification("The user is happy!");
    });

    QObject::connect(&sadButton, &QPushButton::clicked, &happyButton, []() {
        NotificationClient().setNotification("The user is sad!");
    });

Proyecto de ejemplo en code.qt.io

Véase también Qt para Android.

© 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.