Skip to content

Commit 049dfdf

Browse files
committed
Updates troubleshooting instructions to reflect current structure.
1 parent d049f9e commit 049dfdf

File tree

1 file changed

+19
-15
lines changed

1 file changed

+19
-15
lines changed

doc/source/troubleshooting.rst

Lines changed: 19 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -85,31 +85,35 @@ At the top level, this will always contain the same set of files::
8585
AndroidManifest.xml classes.dex META-INF res
8686
assets lib YourApk.apk resources.arsc
8787

88-
The Python distribution is in the assets folder::
88+
The user app data (code, images, fonts ..) is packaged into a single tarball contained in the assets folder::
8989

9090
$ cd assets
9191
$ ls
92-
private.mp3
92+
private.tar
9393

94-
``private.mp3`` is actually a tarball containing all your packaged
95-
data, and the Python distribution. Extract it::
94+
``private.tar`` is a tarball containing all your packaged
95+
data. Extract it::
9696

97-
$ tar xf private.mp3
97+
$ tar xf private.tar
9898

99-
This will reveal all the Python-related files::
99+
This will reveal all the user app data (the files shown below are from the touchtracer demo)::
100100

101101
$ ls
102-
android_runnable.pyo include interpreter_subprocess main.kv pipinterface.kv settings.pyo
103-
assets __init__.pyo interpreterwrapper.pyo main.pyo pipinterface.pyo utils.pyo
104-
editor.kv interpreter.kv _python_bundle menu.kv private.mp3 widgets.pyo
105-
editor.pyo interpreter.pyo libpymodules.so menu.pyo settings.kv
102+
README.txt android.txt icon.png main.pyc p4a_env_vars.txt particle.png
103+
private.tar touchtracer.kv
106104

107-
Most of these files have been included by the user (in this case, they
108-
come from one of my own apps), the rest relate to the python
109-
distribution.
105+
Due to how We're required to ship ABI-specific things in Android App Bundle,
106+
the Python installation is packaged separately, as (most of it) is ABI-specific.
107+
108+
For example, the Python installation for ``arm64-v8a`` is available in ``lib/arm64-v8a/libpybundle.so``
109+
110+
``libpybundle.so`` is a tarball (but named like a library for packaging requirements), that contains our ``_python_bundle``::
111+
112+
$ tar xf libpybundle.so
113+
$ cd _python_bundle
114+
$ ls
115+
modules site-packages stdlib.zip
110116

111-
The python installation, along with all side-packages, is mostly contained
112-
inside the `_python_bundle` folder.
113117

114118

115119
Common errors

0 commit comments

Comments
 (0)