Changes between Version 5 and Version 6 of PySideForAndroid

Timestamp:

Feb 16, 2013, 6:18:53 PM (11 years ago)

Author:

Martin Kolman

Comment:

--

PySideForAndroid

@@ -58 +58 @@
 The resulting !PySide libraries compiled for Android are located in the ''stage/lib'' folder.
 
-=== !PySide for Android example ===
+=== !PySide for Android example application ===
 This is an example, that demonstrates a fully functional standalone Android application that uses Python, !PySide and Qt Components.
 
-==== APK ====
+==== Ready-to-install APK ====
+A ready-to-install standalone APK is available here:
 
+http://modrana.org/platforms/android/pyside_example/PySideExample_1.1.apk
+
+Just install it and press the ''!PySideExample'' icon.
+
+===== First start =====
+If haven't yet installed any Ministro using Qt application on your Android device, you will be redirected to the Play store to install the Ministro application. Ministro is a manager & updater for the Qt libraries for Android. The example application requires to be installed to run.
+So just install Ministro and everything else will be handled automatically. You might need to press the ''!PySideExample'' icon again once Ministro is installed.
+
+Once Ministro is installed and does it's work, the example might still take some time to start, as it is unpacking Python, Qt Components, theme for Qt Components and the example program to it's working directory. Once the unpacking is finished, the example application will be started.
+
+The unpacking is done only once on the first application start, following starts are very fast, at least when tested on my device (HP Touchpad with CM9).
+
+===== What the example application demonstrates =====
+* sending data to Python and back
+-> the content of the entry fild is sent to Python,
+where it is painted on the PySide image and returned to QML using ImageProvider
+-> the date is retrived in Python and shown in QML
+* working text entry with the Android virtual keyboard
+* working screen rotation
+* correct Portrait/Landscape orientation switching
+-> in both normal & inverted orientations
+* working notifications (InfoBanner)
+* working ToolBar
+* working Menu
+* "tools" menu with rotation & opacity sliders for the PySide image
+
+Size
+====
+The example APK has about 16 MB. This is because it needs to bundle quite a lot of
+libraries and related files. Big part of it is actually not used by the example in any way.
+
+For normal applications it should be possible to make the resulting APK much smaller by:
+* includding only the PySide libraries that are actually used
+* removing unused Python modules
+* cutting down the Qt Components theme from all grahics & icons that are not used
+
+== Links ==
+=== Source code listing ===
+A convenient listing of sources for all the components used for the !PySide & co port to Android. :)
+
+Shiboken for Android[[BR]]
+https://github.com/M4rtinK/shiboken-android/tree/android
+
+!PySide for Android[[BR]]
+https://github.com/M4rtinK/pyside-android/tree/android
+
+!PySide for Android build scripts[[BR]]
+https://github.com/M4rtinK/android-pyside-build-scripts
+
+Qt Components[[BR]]
+https://qt.gitorious.org/~martink/qt-components/martinks-ineans-qt-components/commits/android
+
+Example program[[BR]]
+https://github.com/M4rtinK/expyside/tree/android
+
+Example project for Necessitas !QtCreator[[BR]]
+https://github.com/M4rtinK/android-pyside-example-project
+
+=== Binary listing ===
+List of relevant pre-build binaries
+
+!PySide libraries[[BR]]
+http://modrana.org/platforms/android/pyside/
+
+!PyQt libraries[[BR]]
+http://modrana.org/platforms/android/pyqt4/
+
+Python 2.7 built for android[[BR]]
+
+Qt Components for Android[[BR]]
+
+Cut-down Qt Components theme[[BR]]
+
+Example application APK[[BR]]
 
 == Acknowledgement ==