Changes between Version 24 and Version 25 of PySideForAndroid

Timestamp:

Feb 17, 2013, 8:59:31 PM (13 years ago)

Author:

Martin Kolman

Comment:

--

PySideForAndroid

@@ -8 +8 @@
 * and how to bundle them with your Python program in a standalone APK
 '''NOTE:''' If you just wan't to run you Python & !PySide programs on Android, you can skip the ''Building !PySide'' section and go directly to [wiki:PySideForAndroid#PySideforAndroidexampleapplication PySide for Android example application] & [wiki:PySideForAndroid#ExampleprojectfortheNecessitasQtCreator Example project for the Necessitas Qt Creator]
-
 
 
@@ -178 +177 @@
 
 ===== Bundling =====
+The example project bundles all files needed by the application inside the standalone APK. This section describes how the bundling works.
 
 ====== Modified !QtActivity.java ======
@@ -236 +236 @@
 ===== Renaming =====
 
+====== Names ======
+There are actually two names - the project/application name and the unique application name.
+
+For the example project, they project name is {{{PySideExample}}} and the unique name is {{{org.modrana.PySideExample}}}. As you can see, the project name is also a suffix for the unique name. (You probably can use a project name that differs from the suffix, but I rather make them the same to avoid needless confusion).
+
+The unique name is very important:
+* it has to be unique so it dosn't clash with other applications
+ * for this reason, it is mostly based on a domain name you control or some other string with low possibility of being used by another developer
+* the unique name is used for path to the installation folder
+ * the example project uses the {{{org.modrana.PySideExample}}} and it is installed into {{{/data/data/org.modrana.PySideExample}}} as a result
+ * the path to the installation folder is used when setting important environmental variables, so make sure to change all the corresponding paths when changing the unique name
+
+
+====== What to rename and where ======
+Lets say we want to rename the example project from {{{PySideExample}}} to {{{BarApp}}} and from {{{org.modrana.PySideExample}}} to {{{foo.foomatic.BarApp}}} 
+
+* rename the project file:
+{{{
+mv PySideExample.pro BarApp.pro
+}}}
+
+* replace the name inside the project file:
+{{{
+sed -i "s/PySideExample/BarApp/g" BarApp.pro
+}}}
+
+* replace all unique names in {{{main.h}}}:
+{{{
+sed -i "s/org.modrana.PySideExample/foo.foomatic.BarApp/g" main.h
+}}}
+
+* replace all unique names in the {{{QtActivity}}}:
+{{{
+sed -i "s/org.modrana.PySideExample/foo.foomatic.BarApp/g" android/src/org/kde/necessitas/origo/QtActivity.java
+}}}
+
+* replace all names in the Android manifest file:
+{{{
+sed -i "s/org.modrana.PySideExample/foo.foomatic.BarApp/g" android/AndroidManifest.xml
+sed -i "s/PySideExample/BarApp/g" android/AndroidManifest.xml
+}}}
+
+* and the last is in the {{{android/res/strings.xml}}} and {{{android/build.xml}}} file:
+{{{
+sed -i "s/PySideExample/BarApp/g" android/res/values/strings.xml
+sed -i "s/PySideExample/BarApp/g" android/build.xml
+}}}
+
+
+To verify that you have really changed all of the original names or if there are still some left, you can use this command:
+
+{{{
+find . -type f -print0 | xargs -0 file | grep -P text | cut -d: -f1 | xargs grep "PySideExample"
+}}}
+
+
 ===== Replacing the application =====
 The application is located in: {{{android/res/raw/my_python_project.zip}}}
@@ -279 +335 @@
 == Ideas for improvement ==
 There is definitely still room for improvement, such as:
-* a script that renames & customizes Necessitas Qt Cretor PySide projects
+* a script that renames & customizes Necessitas Qt Creator PySide projects
 * building APKs from command line only without Qt Creator
 * show a progress bar when the bundled libs are unpacked on first start