Skip to main content

python-for-android

python-for-android is a packager for Python apps on Android. You can create your own Python distribution including the modules and dependencies you want, and bundle it in an APK along with your own code.

Features include:

  • Support for building with both Python 2 and Python 3.

  • Different app backends including Kivy, PySDL2, and a WebView with Python webserver.

  • Automatic support for most pure Python modules, and built in support for many others, including popular dependencies such as numpy and sqlalchemy.

  • Multiple architecture targets, for APKs optimised on any given device.

For documentation and support, see:

In 2015 these tools were rewritten to provide a new, easier to use and extend interface. If you are looking for the old toolchain with distribute.sh and build.py, it is still available at https://github.com/kivy/python-for-android/tree/old_toolchain, and issues and PRs relating to this branch are still accepted. However, the new toolchain contains all the same functionality via the built in pygame bootstrap.

Documentation

Follow the quickstart instructions to install and begin creating APKs.

Quick instructions to start would be:

pip install python-for-android

or to test the master branch:

pip install git+https://github.com/kivy/python-for-android.git

The executable is called python-for-android or p4a (both are equivalent). To test that the installation worked, try:

python-for-android recipes

This should return a list of recipes available to be built.

To build any distributions, you need to set up the Android SDK and NDK as described in the documentation linked above.

If you did this, to build an APK with SDL2 you can try e.g.:

p4a apk --requirements=kivy --private /home/asandy/devel/planewave_frozen/ --package=net.inclem.planewavessdl2 --name="planewavessdl2" --version=0.5 --bootstrap=sdl2

For full instructions and parameter options, see the documentation.

Support

If you need assistance, you can ask for help on our mailing list:

We also have an IRC channel:

  • Server: irc.freenode.net

  • Port: 6667, 6697 (SSL only)

  • Channel: #kivy

Contributing

We love pull requests and discussing novel ideas. Check out our contribution guide and feel free to improve python-for-android.

The following mailing list and IRC channel are used exclusively for discussions about developing the Kivy framework and its sister projects:

IRC channel:

  • Server: irc.freenode.net

  • Port: 6667, 6697 (SSL only)

  • Channel: #kivy or #kivy-dev

License

python-for-android is released under the terms of the MIT License. Please refer to the LICENSE file.

Release files for python-for-android 0.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for python-for-android 0.6.0
File Size Uploaded
python-for-android-0.6.0.tar.gz 1.6 MB Details

Release files / python-for-android-0.6.0.tar.gz

Download URL python-for-android-0.6.0.tar.gz
Size 1.6 MB
Tags Source
SHA-256 checksum
How to use checksums
f110b47c44f5aef002aa5877ba210ac035f553e1c06ce1261149e284322e94d2
BLAKE2b-256 checksum
How to use checksums
414cec25dd54a8dd45471fe50fb474d80dfca64c3a354b008269b5d6bbdee6e5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page