Changes between Version 23 and Version 24 of PySideForAndroid

Timestamp:

Feb 17, 2013, 7:54:01 PM (11 years ago)

Author:

Martin Kolman

Comment:

--

PySideForAndroid

@@ -179 +179 @@
 ===== Bundling =====
 
-====== Modified QtActivity ======
+====== Modified !QtActivity.java ======
+Another mportant file is the main Android ''activity'' located in {{{android/src/org/kde/necessitas/origo/QtActivity.java}}} This is actually the first thing that is started once you press the application icon on android. It basically works as a glue between Android, Qt and in our case, Python & PySide. 
+
+The basic activity file that is part of every Necessitas Qt Creator project has been modified by the ''android_python27'' project, to look for two specific zip archives in the installation folder at startup ant to decompress them & then remover the archives.
+
+This way bundling of arbitrary files (libraries, executables, code, themes, etc.) inside the application APK has been achieved.
+
+'''NOTE:''' Necessitas Qt Creator might sometimes want to update the pre-generated *.java files with a new version. If this happens to you, check if the update didn't break or remove the bundling code in {{{QtActivity.java}}} .
+
+====== !GlobalConstants.java ======
+The file {{{android/src/org/kde/necessitas/origo/GlobalConstants.java}}} contains variables for the main {{{QtActivity}}} file.
+
+It looks like this:
+
+{{{
+package org.kde.necessitas.origo;
+
+public class GlobalConstants {
+
+        public static final String PYTHON_MAIN_SCRIPT_NAME = "main.py";
+        public static final String PYTHON_PROJECT_ZIP_NAME = "my_python_project.zip";
+        public static final String PYTHON_ZIP_NAME = "python_27.zip";
+        public static final String PYTHON_EXTRAS_ZIP_NAME = "python_extras_27.zip";
+
+        public static final boolean IS_FOREGROUND_SERVICE = true;
+
+        public static final String PYTHON_BIN_RELATIVE_PATH = "/python/bin/python";
+        public static final String PYTHON_NAME = "python";
+        public static final String PYTHON_NICE_NAME = "Python 2.7.2";
+
+        public static String[] SCRIPT_ARGS = { "--foreground" };
+
+        public static final String LOG_TAG = "PythonAPK";
+}
+
+}}}
+As you can see, you can use it to set various variables, such as name of the bundling archives or logging prefix (does this actually work ?).
 
 ====== my_python_project.zip ======
+The first archive, located in {{{android/res/raw/my_python_project.zip}}} in the project contains the Python application code. On first application start, it's contents are unpacked into:
+
+{{{/data/data/org.modrana.PySide.Example/}}}
 
 ====== python27.zip ======
-
+This file is located {{{android/res/raw/python_27.zip}}} in the project and it's content is unpacked to:
+
+{{{/data/data/org.modrana.PySide.Example/python}}}
+
+The paths set in {{{main.h}}} expect this and point the corresponding environmental variables to the {{{bin}}}, {{{lib}}}, {{{imports}}} and {{{themes}}} folders in this directory.
 
 ==== Modifying the project ====