QtAndroid：QAndroidJniObject 之 Qt给Android进程发送广播

QtAndroid：QAndroidJniObject 之 Qt给Android进程发送广播

本文编译环境：Android Qt 5.15.2 Mulit-Abi

在开始之前，如果你还不了解QAndroidJniObject是如何与Android进行交互的，建议你先花5分钟的时间了解QAndroidJniObject的基础。

QAndroidJniObject

QAndroidJniObject属于androidextras模块，要使用它，需要在pro文件中加入以下代码：

QT += androidextras

QAndroidJniObject是对原始 JNI 类型的封装，代表了一个Java对象（类的实例），它提供了很多方法供开发者使用，主要分为三类：

• 构造一个Java对象
• 调用Java静态（类）方法
• 调用Java实例方法

构造 Java 对象

要调用Java类库，需要构造Java对象，QAndroidJniObject提供了下列构造函数来创建JNI对象：

QAndroidJniObject();
explicit QAndroidJniObject(const char *className);
explicit QAndroidJniObject(const char *className, const char *sig, ...);
explicit QAndroidJniObject(jclass clazz);
explicit QAndroidJniObject(jclass clazz, const char *sig, ...);
QAndroidJniObject(jobject obj);

还有一个静态方法供我们从一个QString对象来构造Java中的String对象

static QAndroidJniObject fromString(const QString &string);

构造函数又分为了两类，一类是根据 Java类名 和 Java类构造函数签名 来创建 JNI 对象；一类是根据已有的 JNI 对象（也可结合 Java 构造函数签名）来创建 QAndroidJniObject 对象。

使用 JNI 的两点基础：一、全路径类名

Java的全路径类名，是包含了包名的。Java中的包（package）类似于C++中的namespace，一个包里可以包含了多个类，一方面方便将关联的类组织到一起，另一方面也可以避免名字冲突。

如Java中的String类：

String类在包 java.lang 中，全路径类名为 java.lang.String 。当我们在C++以字符串方式描述一个Java类时，需要把 “.” 替换为 “/”，如 java.lang.String，字符串描述为 “java/lang/String” 。

使用JNI的两点基础：二、方法签名

方法签名的表述形式为：(Arguments)ReturnType 。圆括号中的是参数列表，紧跟圆括号的是返回值类型。

例如 “(I)C” 的意思就是参数为 int，返回值为 char。

当一个Java方法的参数或返回值类型为对象时，需要使用全路径类名，并且添加前缀 “L” 和后缀 “;” 。

例如 “(Ljava/lang/String;)Ljava/lang/String;” ，表示一个方法的参数类型为 String，返回值也是 String 。

使用全局类名构造Java对象（无参）

intent类时Android提供的、用于组件间通信的一种机制。通过 Intent，你可以调用其它的系统功能或第三方提供的功能，比如你可以调用拨打电话的功能，可以显示联系人，也可以调用相机等。我们在使用 Intent 时可以置顶一个action，action代表你要做的动作，还可以在 Intent 中携带数据给被调用的一方。Intent 的全路径类名为 android.content.Intent。

我们可以这么构造一个 Intent对象：

QAndroidJniObject intent("android/content/Intent");

上面的代码就会调用 Intent 的默认构造函数来构造一个 Intent 对象。

值得注意的是，使用 QAndroidJniObject(const char *className) 这个构造函数来创建 Java 对象，一定要确保你指定的 Java 类有无构造参数（即默认构造函数）。

使用全局类名构造Java对象（带参）

explicit QAndroidJniObject(const char *className, const char *sig, ...);

这个构造函数根据类名 className 和指定签名的构造函数来创建 JNI 对象。

还是以 Intent 为例，Intent 有一个构造函数，原型是：

public Intent(String action) {
    throw new RuntimeException("Stub!");
}

我们就根据这个构造函数来创建 Intent 对象，C++ 代码如下：

QAndroidJniObject action = QAndroidJniObject::fromString("android.settings.SETTINGS");
QAndroidJniObject intent("android/content/Intent","(Ljava/lang/String;)V", action.object<jstring>());

在上面的代码中，我们先使用 QAndroidJniObject::fromString 构造了一个 Java 的 String 对象作为我们的 action ，这个 action 会打开 Android 系统设置。

然后我们调用 Intent 的 Intent(String action)构造函数来创建一个 Intent 类。 构造函数没有返回值，参数为 String， 所以函数签名是 “(Ljava/lang/String;)V”。QAndroidJniObject 的 object 方法返回它所持有的 java 对象， action.object() 返回的就是 jstring 。

调用 Java 实例方法

有了 Java 对象，我们就可以调用这个对象的实例方法。

所谓实例方法，就是一个类的非静态方法，需要先有对象才能调用。而类方法，指的就是类的静态方法；

QAndroidJniObject 提供了下列方法以方便我们调用 Java 实例方法：

   template <typename T>
    T callMethod(const char *methodName) const;
    template <typename T>
    T callMethod(const char *methodName, const char *sig, ...) const;
    template <typename T>
    QAndroidJniObject callObjectMethod(const char *methodName) const;
    QAndroidJniObject callObjectMethod(const char *methodName,
                                const char *sig,
                                ...) const;

两个 callMethod 方法，调用 Java 对象的那些返回值为基础类型（如int、double等）的实例方法；其中一个带参数，一个不带参数；callMethod 是模板方法，模板参数为 Java 方法的返回值的类型。两个 callObjectMethod 方法则调用 Java 对象的那些返回值为对象（类实例）的实例方法。

使用 QAndroidJniObject 发送广播

在学习了以上基础后，我们开始进入今天的正式主题：

在Android中发送广播的对象是Activity，发送前需要创建一个 Intent 对象，且为它指定action。以下是 Java 代码：

Intent intent=new Intent();
intent.setAction("CAST_ACTION");
intent.putExtra("name","TEST");  // 传递给广播接收器
sendBroadcast(intent);

我们需要将其转为C++的写法：

引入头文件：

#include <QtAndroid>
#include <QAndroidJniObject>
#include <QAndroidIntent>

QAndroidJniObject activity = QtAndroid::androidActivity();  // 获取当前的Activity
QAndroidIntent intent("CAST_ACTION");  // 创建Intent 对象
QString tempStr = "TEST";
intent.putExtra("name", tempStr.toUtf8()); // 以ByteArry的形式传值（在Android端也需要通过ByteArray来接收，并转为String）
activity.callMethod<void>("sendBroadcast","(Landroid/content/Intent;)V", intent.handle().object());

参考链接：
Qt Doc
QtAndroid详解(1)：QAndroidJniObject