Skip to content

Commit f6df2bd

Browse files
inclementopacam
authored andcommitted
Added libffi headers troubleshooting note to doc (#1972)
1 parent be8566d commit f6df2bd

File tree

1 file changed

+11
-4
lines changed

1 file changed

+11
-4
lines changed

doc/source/troubleshooting.rst

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ get help with any problems using the same channels as Kivy itself:
2424
- by email to the `kivy-users Google group
2525
<https://groups.google.com/forum/#!forum/kivy-users>`_
2626
- on `#support Discord channel <https://chat.kivy.org/>`_
27-
27+
2828
If you find a bug, you can also post an issue on the
2929
`python-for-android Github page
3030
<https://github.com/kivy/python-for-android>`_.
@@ -58,7 +58,7 @@ grepping this).
5858
When your app crashes, you'll see the normal Python traceback here, as
5959
well as the output of any print statements etc. that your app
6060
runs. Use these to diagnose the problem just as normal.
61-
61+
6262
The adb command passes its arguments straight to adb itself, so you
6363
can also do other debugging tasks such as ``python-for-android adb
6464
devices`` to get the list of connected devices.
@@ -88,7 +88,7 @@ At the top level, this will always contain the same set of files::
8888
The Python distribution is in the assets folder::
8989

9090
$ cd assets
91-
$ ls
91+
$ ls
9292
private.mp3
9393

9494
``private.mp3`` is actually a tarball containing all your packaged
@@ -169,7 +169,7 @@ fix it, change your code to reference
169169
websocket-client: if you see errors relating to 'SSL not available'
170170
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
171171
Ensure you have the package backports.ssl-match-hostname in the buildozer requirements, since Kivy targets python 2.7.x
172-
172+
173173
You may also need sslopt={"cert_reqs": ssl.CERT_NONE} as a parameter to ws.run_forever() if you get an error relating to host verification
174174

175175
Requested API target 19 is not available, install it with the SDK android tool
@@ -183,3 +183,10 @@ version).
183183
If using buildozer this should be done automatically, but as a
184184
workaround you can run these from
185185
``~/.buildozer/android/platform/android-sdk-20/tools/android``.
186+
187+
ModuleNotFoundError: No module named '_ctypes'
188+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
189+
190+
You do not have the libffi headers available to python-for-android, so you need to install them. On Ubuntu and derivatives these come from the `libffi-dev` package.
191+
192+
After installing the headers, clean the build (`p4a clean builds`, or with buildozer delete the `.buildozer` directory within your app directory) and run python-for-android again.

0 commit comments

Comments
 (0)