Contribute

Write your own recipe

A recipe allows you to compile libraries / python extension for the mobile. Most of the time, the default compilation instructions doesn’t work for the target, as ARM compiler / Android NDK introduce specifities that the library you want doesn’t handle correctly, and you’ll need to patch. Also, because the Android platform cannot load more than 64 inline dynamic libraries, we have a mechanism to bundle all of them in one to ensure you’ll not hit this limitation.

To test your own recipe via Buildozer, you need to:

  1. Fork Python for Android, and clone your own version (this will allow easy contribution later):

    git clone http://github.com/YOURNAME/python-for-android
    
  2. Change your buildozer.spec to reference your version:

    p4a.source_dir = /path/to/your/python-for-android
    
  3. Copy your recipe into python-for-android/recipes/YOURLIB/recipe.sh

  4. Rebuild.

When you correctly get the compilation and your recipe works, you can ask us to include it in the python-for-android project, by issuing a Pull Request:

  1. Create a branch:

    git checkout --track -b recipe-YOURLIB origin/master
    
  2. Add and commit:

    git add python-for-android/recipes/YOURLIB/*
    git commit -am 'Add support for YOURLIB`
    
  3. Push to Github

    git push origin master

  4. Go to http://github.com/YOURNAME/python-for-android, and you should see your new branch and a button “Pull Request” on it. Use it, write a description about what you did, and Send!