在使用Qt制作跨平台app时,通常目标平台都是Android和iOS。因为本身Qt所设计的平台很多,有很多功能在Android和iOS上未能提供实现,需要程序员自行制作。比如调用读取手机通讯录、使用UsbManager等。
此文章介绍JNI的基础,以便读者可以使用此技术来补全一些Qt未能做到的功能。
JNI - Java Native Interface
JNI的技术有很多年了,原先是提供让java代码直接调用c/c++代码,来做一些java代码做不到的事情,能深入做系统的功能。其原理是把c/c++代码编译成动态哭文件(dll, linux上则是so文件),此代码直接为java类中某函数的实现。那么在java代码里直接调用该函数就可以,在调用的过程中,JVM会负责动态加载该动态库到内存中,从而执行当中的c/c++代码。
Qt中所说的JNI则是方向相反,因为本身我们使用Qt所制作的android程序中,我们所编写的c/c++代码就已经是放到一个*.so的动态库文件里。android系统把apk包打开执行时,先执行Qt的QtActivity java类,从而通过JNI调用到我们的libXXX.so(此so是压缩在我们的apk中的)。而我们在此so中的代码,就要通过Qt的JNI来反过来调用java代码,所以在JNI的方向来说是反向的。
在Qt中,提供了一个Android Extras的库,首先需要在项目的pro文件中添加此库,才能使用Qt的JNI。
android { #如果构建目标(build target)是android
QT += androidextras #使用此库
}
调用java代码有两种方案
方案一:直接把java代码逐行翻译为c++代码来写
方案二:把java代码写在我们的主要Activity中,然后c++那边可以以较简单的方式调用
实例:调用android中的拍照app, java代码:
String action = "android.media.action.IMAGE_CAPTURE";
Intent intent = new Intent(action);
File extDir = Environment.getExternalStorageDirectory();
String filename = "camera.jpg";
File photo = new File(extDir, filename);
Uri takePhotoSavedUri = Url.fromFile( photo );
intent.putExtra( MediaStore.EXTRA_OUTPUT, takePhotoSavedUri );
int SHOOT_PHOTO = 1;
startActivityForResult(intent, SHOOT_PHOTO);
此java代码大致含义:发出一个Intent,系统处理这个Intent就会把拍照的app调用起来。startActivity和startActivityForResult的区别就不在此博客里详说了。
方案一:直接把java代码逐行翻译为c++代码来写
要把以上的java代码翻译成Qt C++的代码,先要知道几点:
- QAndroidJniObject这个类,能包装所有java的对象。
- 用QAndroidJniObject对包装的对象调用函数或者读取属性,有几种方法
- 在读取属性或者调用函数时,需要知道如何写清楚该属性或者函数的签名(signature)
用QAndroidJniObject来做new一个对象:
java | Qt C++ |
---|---|
File file = new File(); | QAndroidJniObject file(“java/io/File”, “()V”); |
File file = new File(“/tmp/a.txt”); | QAndroidJniObject str = QAndroidJniObject::fromString(“/tmp/a.txt”); QAndroidJniObject file(“java/io/File”, “(Ljava/lang/String;)V”, str.object()); |
用QAndroidJniObject来调用对象的方法(返回类型是对象):
java | Qt C++ |
---|---|
intent.putExtra(MediaStore.EXTRA_OUTPUT, takePhotoSavedUri); | intent.callObjectMethod(“putExtra”,”(Ljava/lang/String;Landroid/os/Parcelable;)Landroid/content/Intent;”, MediaStore__EXTRA_OUTPUT.object(), takePhotoSavedUri.object());</ |