It is a fork of the Quick Android project that aims to provide a library to access Android functions from Qt/QML without using JNI.
Remarks: This project only support gradle build system.
- SystemDispatcher - A message queue for C++/Qt and Java/Android
- Send message in C++, receive in Java and vice versa.
- Data type will be converted automatically (e.g QMap <-> java.util.Map). No need to write in JNI.
- It could be used to write your own Java code
- Bundled Components
- Image Picker
- Toast
- Video Picker
- SMS Inbox reader (via Util component)
- make a phone call, makeCall (via Util component)
- sharing content using ACTION_SEND (via Share component)
- Querying and Handling of GPS Settings (via Util component)
- Wrapper of android.os.Environment / android.os.Debug / MediaScannerConnection
- Environment::getExternalStoragePublicDirectory()
- MediaScannerConnection::scanFile()
- Debug::getNativeHeapSize()
- Debug::getNativeHeapAllocatedSize()
The functions above do not require to config gradle before using.
import AndroidNative 1.0
- ImagePicker
- VideoPicker
- Toast
- Util
- Share
SystemDispatcher is a message queue component for delivering action message between C++/QML and Java. Data type in message is converted to the target platform automatically (e.g QMap <-> java.util.Map) . So that user doesn't need to write JNI to access their Java functions.
Moreover, SystemDispatcher is compilable on a non-Android platform. It doesn't cause any trouble to run on your development host.
// C++ Example
#include <AndroidNative>
// Load a Java class. It will trigger the code within `static` block
SystemDispatcher::instance()->loadClass("androidnative.example.ExampleService");
QVariantMap message;
message["value1"] = 1;
message["value2"] = 2.0;
message["value3"] = "3";
// Dispatch a message
SystemDispatcher::instance()->dispatch("androidnative.example.dummyAction", message);
// QML Example
import AndroidNative 1.0
Item {
Component.onCompleted: {
var message = {
value1: 1,
value2: 2.0,
value3: "3"
}
SystemDispatcher.dispatch("androidnative.example.dummyAction", message);
}
}
// Java Receiver
public class ExampleService {
static {
SystemDispatcher.addListener(new SystemDispatcher.Listener() {
public void onDispatched(String type , Map message) {
if (type.equals("androidnative.example.dummyAction")) {
// Process then dispatch a response back to C++/QML
SystemDispatcher.dispatch(("androidnative.example.response");
return;
}
return;
}
});
}
}
// Listen from QML
Connections {
target: SystemDispatcher
onDispatched: {
// process the message
}
}
Supported data type:
| Qt | Java |
|---|---|
| int | int |
| bool | boolean |
| QString | String |
| QVariantList | List |
| QVariantMap | Map |
import AndroidNative 1.0 as AN
AN.Share {
id: an
}
Button {
text: "Share"
onClicked: {
// Please refer to:
// https://developer.android.com/reference/android/content/Intent.html#ACTION_SEND
// for details and usage of parameters.
// if any of urls , uris or texts is specifed ACTION_SEND_MULTIPLE is invoked.
// note if remote url is specified via 'url' , the file/url is fecthed from the network.
// and the content is shared.
an.shareContent( {
// mime_type: 'image/*'
// , uri: single_uri
// , text: "This is a sample TEXT for sharing"
// , html_text: "This is a sample <b>HTML</b> for sharing"
// , subject: "This is a sample SUBJECT for sharing"
// , package: "com.whatsapp"
// , url: "https://c1.staticflickr.com/9/8121/8686001144_4ae5268a38_b.jpg"
// , uris: imageuris
// , texts: [ "This is a sample TEXT for sharing" , "Text 2" ]
//, html_texts: [ "This is a sample <b>HTML</b> for sharing" , "<b>HTML2</b>" ]
// , urls: [
// "https://c1.staticflickr.com/9/8121/8686001144_4ae5268a38_b.jpg",
// "https://c2.staticflickr.com/6/5272/14017380707_5d73fc0cb3_b.jpg"
//]
//, url : "http://www.inkwelleditorial.com/pdfSample.pdf" } );
}
}
androidnative.pri/installation.md at master · benlau/androidnative.pri
An example program is available at: androidnative.pri/examples/androidnativeexample at master · benlau/androidnative.pri
