README 2.63 KB
Newer Older
Sergey Galin's avatar
Sergey Galin committed
1 2 3 4 5 6 7 8
2GIS Extensions for Qt on Android


Developers:
    Sergey A. Galin <sergey.galin@gmail.com>
    Vyacheslav O. Koscheev <vok1980@gmail.com>
    Ivan Ryabchenko <i.ryabchenko@2gis.ru>
    Ivan Avdeev <marflon@gmail.com>
Saytgalin Alexander's avatar
Saytgalin Alexander committed
9
    Alexander Saytgalin <pomidir@gmail.com>
Sergey Galin's avatar
Sergey Galin committed
10 11 12 13 14

Also uses code by:
    BogDan Vatra <bogdan@kde.org>


Sergey Galin's avatar
Sergey Galin committed
15 16 17
Please note that the modules are published under different open-source
licenses. Most part is distributed under BSD License, parts are under GNU LGPL
License (please refer to the headers in the source files).
Sergey Galin's avatar
Sergey Galin committed
18 19 20 21 22 23 24 25 26 27 28

This library supports Qt 5 and (partially) Qt 4.8 port to Android made by 2GIS.

The library is currently distributed only as a set of C++ and Java source files;
you have to create build projects or include the sources into your project.


CONTENTS


QJniHelpers
Sergey Galin's avatar
Sergey Galin committed
29
===============================================================================
Sergey Galin's avatar
Sergey Galin committed
30 31 32 33 34 35

Qt/C++ JNI helper classes.
Classes to get Android Activity object under Qt 4.8 and Qt 5.


QtOffscreenViews
Sergey Galin's avatar
Sergey Galin committed
36
===============================================================================
Sergey Galin's avatar
Sergey Galin committed
37 38 39 40 41 42 43 44 45 46 47 48 49 50

This library allows to embed native Android controls right into your Qt
application, whether it uses QML, QWidget or QGraphicsWidget UI.

Currently implemented Android controls are:

- TextEdit with full support for all text editing features like edit bar,
  selection markers and etc.

- WebView (works best for embedding static content; does not support video
  playback and has performance issues with dynamic content).


QtAndroidHelpers
Sergey Galin's avatar
Sergey Galin committed
51
===============================================================================
Sergey Galin's avatar
Sergey Galin committed
52 53 54 55 56 57 58 59 60 61 62 63 64 65

This part contains access to Android system things in a more Android-specific
manner than the cross-platform Qt can do.

- Device and screen configuration
- Filesystem information (standard directories, external cards and etc.)
- Android system message dialogs
- Notification on screen relayout (e.g. opening software keyboard)
- Access to Shared Preferences
- Toasts
- Lockers to keep WiFi and/or screen on


QtAndroidAssets
Sergey Galin's avatar
Sergey Galin committed
66
===============================================================================
Sergey Galin's avatar
Sergey Galin committed
67 68 69 70 71 72

A library which allows to use assets from a non-UI application, e.g. Android
background service.


QtAndroidCompass
Sergey Galin's avatar
Sergey Galin committed
73
===============================================================================
Sergey Galin's avatar
Sergey Galin committed
74 75 76 77 78

Homebrewn access to Android compass which addresses some problems with Qt 5
implementation.


79
QtAndroidLocation
Sergey Galin's avatar
Sergey Galin committed
80
===============================================================================
Sergey Galin's avatar
Sergey Galin committed
81 82 83 84 85

Homebrewn location provider which uses Google Fused location (when it is
available) and also standard Android positioning methods. It is faster and more
reliable than the location provider included in Qt.