- JDK 1.8
- Android SDK
- Android NDK
- Buildozer
Based on the quickstart instructions at http://buildozer.readthedocs.io/en/latest/installation.html
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install build-essential ccache git libncurses5:i386 libstdc++6:i386 libgtk2.0-0:i386 libpangox-1.0-0:i386 libpangoxft-1.0-0:i386 libidn11:i386 python2.7 python2.7-dev openjdk-8-jdk unzip zlib1g-dev zlib1g:i386
Alternatively, the JDK available from http://www.oracle.com/technetwork/java/javase/downloads/index.html can be installed instead of the openjdk-8-jdk package.
Additional package for building libgmp
sudo apt-get install m4
Additional package for the pycrypto recipe
This had to be installed due to an error regarding the <gnu/stubs.h> include not found.
sudo apt-get install libc6-dev-i386
sudo pip install --upgrade cython==0.25.2
git clone https://github.com/kivy/buildozer.git
cd buildozer
sudo python2.7 setup.py install
Assuming lbrydroid as the current working folder:
- Copy
buildozer.spec.sampletobuildozer.specin thelbry-androidfolder. Runningbuildozer initinstead will create a newbuildozer.specfile. - Update
buildozer.specsettings to match your environment. Basic recommended settings are outlined below.
| Setting | Description |
|---|---|
| title | application title |
| package.name | package name (eg. lbrynet) |
| package.domain | package domain (eg. io.lbry) |
| source.dir | the location of the application main.py |
| version | application version |
| requirements | the module requirements for building the application |
| services | list of Android background services and their corresponding Python entry points |
| android.permissions | Android manifest permissions required by the application. This should be set to INTERNET at the very least to enable internet connectivity |
| android.api | Android API version (21 and 24 have been tested to result in a successful build) |
| android.sdk | Android SDK version (21 and 24 have been tested to result in a successful build) |
| android.ndk | Android NDK version (13b has been tested to result in a successful build) |
| android.ndk_path | Android NDK path. buildozer will automatically download this if not set |
| android.sdk_path | Android SDK path. buildozer will automatically download this if not set |
| p4a.source_dir | Path to the python-for-android repository folder. Currently set to the included p4a folder |
| p4a.local_recipes | Path to a folder containing python_for_android recipes to be used in the build. The included recipes folder includes recipes for a successful build |
Run buildozer android debug to build a debug APK, or buildozer android release to build a release APK.
To deploy and run the APK on a connected Android device, you can run buildozer android debug deploy run.
Run buildozer android clean to clean the package if you intend to rebuild.