Android APK packager for Python scripts and apps
[![Build Status](https://travis-ci.org/kivy/python-for-android.svg?branch=develop)](https://travis-ci.org/kivy/python-for-android) [![Coverage Status](https://coveralls.io/repos/github/kivy/python-for-android/badge.svg?branch=develop&kill_cache=1)](https://coveralls.io/github/kivy/python-for-android?branch=develop) [![Backers on Open Collective](https://opencollective.com/kivy/backers/badge.svg)](#backers) [![Sponsors on Open Collective](https://opencollective.com/kivy/sponsors/badge.svg)](#sponsors)
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.
- 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:
- Website: http://python-for-android.readthedocs.io
- Mailing list: https://groups.google.com/forum/#!forum/kivy-users or https://groups.google.com/forum/#!forum/python-android.
Follow the [quickstart instructions](<https://python-for-android.readthedocs.org/en/latest/quickstart/>) 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:
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](https://python-for-android.readthedocs.io/en/latest/quickstart/#usage).
If you need assistance, you can ask for help on our mailing list:
We also have [#support Discord channel](https://chat.kivy.org/).
We love pull requests and discussing novel ideas. Check out the Kivy project [contribution guide](http://kivy.org/docs/contribute.html) and feel free to improve python-for-android.
See [our documentation](https://python-for-android.readthedocs.io/en/latest/contribute/) for more information about the python-for-android development and release model, but don’t worry about the details. You just need to make a pull request, we’ll take care of the rest.
The following mailing list and IRC channel are used exclusively for discussions about developing the Kivy framework and its sister projects:
We also have [#dev Discord channel](https://chat.kivy.org/).
python-for-android is released under the terms of the MIT License. Please refer to the LICENSE file.
In 2015 these tools were rewritten to provide a new, easier to use and extend interface. If you’d like to browse the old toolchain, its status is recorded for posterity at at https://github.com/kivy/python-for-android/tree/old_toolchain.
In the last quarter of 2018 the python recipes has been changed, the new recipe for python3 (3.7.1) has a new build system which has been applied to the ancient python recipe, allowing us to bump the python2 version number to 2.7.15. This change, unifies the build process for both python recipes, and probably solve some issues detected over the years. Also should be mentioned that this unified python recipes require to target to a minimum api level of 21, Android 5.0 - Lollipop, so in case the you need to build targeting an api level below 21, you must use an old version of python-for-android (<=0.7.1). All this work has been done using android ndk version r17c, and your build should success with that version…but be aware that the project is in constant development so…the ndk version will change at some time.
Those mentioned changes has been done this way to make easier the transition between python3 and python2. We will slowly phase out python2 support towards 2020…so…if you are using python2 in your projects you should consider to migrate it into python3.
This project exists thanks to all the people who contribute. [[Contribute](CONTRIBUTING.md)]. <a href=”https://github.com/kivy/python-for-android/graphs/contributors”><img src=”https://opencollective.com/kivy/contributors.svg?width=890&button=false” /></a>
Thank you to all our backers! 🙏 [[Become a backer](https://opencollective.com/kivy#backer)]
<a href=”https://opencollective.com/kivy#backers” target=”_blank”><img src=”https://opencollective.com/kivy/backers.svg?width=890”></a>
Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [[Become a sponsor](https://opencollective.com/kivy#sponsor)]
<a href=”https://opencollective.com/kivy/sponsor/0/website” target=”_blank”><img src=”https://opencollective.com/kivy/sponsor/0/avatar.svg”></a> <a href=”https://opencollective.com/kivy/sponsor/1/website” target=”_blank”><img src=”https://opencollective.com/kivy/sponsor/1/avatar.svg”></a> <a href=”https://opencollective.com/kivy/sponsor/2/website” target=”_blank”><img src=”https://opencollective.com/kivy/sponsor/2/avatar.svg”></a> <a href=”https://opencollective.com/kivy/sponsor/3/website” target=”_blank”><img src=”https://opencollective.com/kivy/sponsor/3/avatar.svg”></a> <a href=”https://opencollective.com/kivy/sponsor/4/website” target=”_blank”><img src=”https://opencollective.com/kivy/sponsor/4/avatar.svg”></a> <a href=”https://opencollective.com/kivy/sponsor/5/website” target=”_blank”><img src=”https://opencollective.com/kivy/sponsor/5/avatar.svg”></a> <a href=”https://opencollective.com/kivy/sponsor/6/website” target=”_blank”><img src=”https://opencollective.com/kivy/sponsor/6/avatar.svg”></a> <a href=”https://opencollective.com/kivy/sponsor/7/website” target=”_blank”><img src=”https://opencollective.com/kivy/sponsor/7/avatar.svg”></a> <a href=”https://opencollective.com/kivy/sponsor/8/website” target=”_blank”><img src=”https://opencollective.com/kivy/sponsor/8/avatar.svg”></a> <a href=”https://opencollective.com/kivy/sponsor/9/website” target=”_blank”><img src=”https://opencollective.com/kivy/sponsor/9/avatar.svg”></a>
Release history Release notifications
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size python_for_android-2019.6.6-py3-none-any.whl (577.1 kB)||File type Wheel||Python version py3||Upload date||Hashes View hashes|
|Filename, size python-for-android-2019.6.6.tar.gz (1.0 MB)||File type Source||Python version None||Upload date||Hashes View hashes|
Hashes for python_for_android-2019.6.6-py3-none-any.whl
Hashes for python-for-android-2019.6.6.tar.gz