Changes between Version 20 and Version 21 of PySideForAndroid

Timestamp:

Feb 17, 2013, 7:00:43 PM (11 years ago)

Author:

Martin Kolman

Comment:

--

PySideForAndroid

@@ -130 +130 @@
 
 ===== C++ wrapper =====
+The {{{main.cpp}}} and {{{main.h}}} files are used to build a C++ Python wrapper. This wrapper is build against the the Android-compiled python libraries in {{{build_dependencies/python}}} by Necessitas. 
+
+Once the APK is deployd to the device and started, this wrapper is run. It initializes it's build-in Python interpreter, which tries to start the {{{/data/data/org.modrana.PySide.Example/main.py}}} Python file. This Python code then imports PySide, instantiates a QApplication and starts the main loop.
+
+Behind the scenes, Necessitas handles wrapping the QApplication to an Android activity and showing it on the screen. It also handles other stuff like keyboard input & Qt Mobility.
+
+====== main.h ======
+This file contains important paths for the C++ wrapper.
+
+{{{
+#ifndef MAIN_H
+#define MAIN_H
+
+#define MAIN_PYTHON_FILE "/data/data/org.modrana.PySideExample/files/main.py"
+
+#define PYTHON_HOME "/data/data/org.modrana.PySideExample/files/python/"
+
+#define PYTHON_PATH "/data/data/org.modrana.PySideExample/files/python/lib/python2.7/lib-dynload:/data/data/org.modrana.PySideExample/files/python/lib/python2.7/:/data/data/org.modrana.PySideExample/files/python/lib/python2.7/site-packages:/data/data/org.modrana.PySideExample/files/python/lib"
+
+#define LD_LIBRARY_PATH "/data/data/org.modrana.PySideExample/files/python/lib:/data/data/org.modrana.PySideExample/files/python/lib/python2.7/lib-dynload:/data/data/org.kde.necessitas.ministro/files/qt/lib/"
+
+#define PATH "/data/data/org.modrana.PySideExample/files/python/bin:$PATH"
+
+#define THEME_PATH "/data/data/org.modrana.PySideExample/files/python/themes/"
+
+#define QML_IMPORT_PATH "/data/data/org.modrana.PySideExample/files/python/imports/"
+
+#endif // MAIN_H
+}}}
+
+* {{{MAIN_PYTHON_FILE}}} - path to the main Python file to run once the application is started
+* {{{PYTHON_HOME}}}
+* {{{LD_LIBRARY_PATH }}} - '':'' separated list of paths used to look for libraries when loading them
+* {{{PATH}}} - search path for executables
+* {{{THEME_PATH}}} - path to the main themes folder for Qt Components
+* {{{QML_IMPORT_PATH}}} - path to the Qt Components {{{imports}}} folder
+
+====== main.cpp ======
+This is the C++ wrapper, it contains the embedded Python interpreter that is used to start the application and also sets some important environmental variables specified through {{{main.h}}} .
+
+===== The example Python application =====
 
 ===== Bundling =====
 
 ====== Modified QtActivity ======
+
+====== my_python_project.zip ======
 
 ====== python27.zip ======