Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/benlau/androidnative.pri
Calling Android functions from Qt without using JNI
https://github.com/benlau/androidnative.pri
Last synced: 3 months ago
JSON representation
Calling Android functions from Qt without using JNI
- Host: GitHub
- URL: https://github.com/benlau/androidnative.pri
- Owner: benlau
- License: apache-2.0
- Created: 2017-01-15T11:44:13.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2021-07-23T05:31:03.000Z (over 3 years ago)
- Last Synced: 2024-06-16T03:35:26.258Z (5 months ago)
- Language: Java
- Homepage:
- Size: 1.47 MB
- Stars: 100
- Watchers: 17
- Forks: 15
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-qt-qml - androidnative.pri - Calling Android functions from Qt without using JNI. (Android)
README
Calling Android functions from Qt without using JNI
===========================
It is a fork of the [Quick Android](https://github.com/benlau/quickandroid) 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.
Features
========
1. SystemDispatcher - A message queue for C++/Qt and Java/Android
1. Send message in C++, receive in Java and vice versa.
1. Data type will be converted automatically (e.g QMap <-> java.util.Map). No need to write in JNI.
1. It could be used to write your own Java code
1. Bundled Components
1. Image Picker
1. Toast
1. Video Picker
1. SMS Inbox reader (via Util component)
1. make a phone call, makeCall (via Util component)
1. sharing content using ACTION_SEND (via Share component)
1. Querying and Handling of GPS Settings (via Util component)
1. Wrapper of android.os.Environment / android.os.Debug / MediaScannerConnection
C++ API
=======
1. Environment::getExternalStoragePublicDirectory()
1. MediaScannerConnection::scanFile()
1. Debug::getNativeHeapSize()
1. Debug::getNativeHeapAllocatedSize()
The functions above do not require to config gradle before using.
QML Components
==============
```
import AndroidNative 1.0
```
1. ImagePicker
1. VideoPicker
1. Toast
1. Util
1. Share
SystemDispatcher
================
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
// 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 |
Sharing Example
=================
```
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 HTML 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 HTML for sharing" , "HTML2" ]
// , 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" } );
}
}
```
Installation Instruction
========================
[androidnative.pri/installation.md at master · benlau/androidnative.pri](https://github.com/benlau/androidnative.pri/blob/master/docs/installation.md)
Example
=======
An example program is available at: [androidnative.pri/examples/androidnativeexample at master · benlau/androidnative.pri](https://github.com/benlau/androidnative.pri/tree/master/examples/androidnativeexample)
