To help you get started, we've collected the most common ways that python-for-android is being used within popular public projects.

codelv / enaml-native-cli / python-for-android / pythonforandroid / recipe.py View on Github

class IncludedFilesBehaviour(object):
    '''Recipe mixin class that will automatically unpack files included in
    the recipe directory.'''
    src_filename = None

    def prepare_build_dir(self, arch):
        if self.src_filename is None:
            print('IncludedFilesBehaviour failed: no src_filename specified')
            exit(1)
        shprint(sh.rm, '-rf', self.get_build_dir(arch))
        shprint(sh.cp, '-a', join(self.get_recipe_dir(), self.src_filename),
                self.get_build_dir(arch))


class BootstrapNDKRecipe(Recipe):
    '''A recipe class for recipes built in an Android project jni dir with
    an Android.mk. These are not cached separatly, but built in the
    bootstrap's own building directory.

    To build an NDK project which is not part of the bootstrap, see
    :class:`~pythonforandroid.recipe.NDKRecipe`.
    '''

    dir_name = None  # The name of the recipe build folder in the jni dir

    def get_build_container_dir(self, arch):
        return self.get_jni_dir()

    def get_build_dir(self, arch):
        if self.dir_name is None:
            raise ValueError('{} recipe doesn\'t define a dir_name, but '

View more ways to use python-for-android

python-for-android

python-for-android (p4a) is a development tool that packages Python apps into binaries that can run on Android devices.

It can generate:

• Android Package (APK) files, ready to install locally on a device, especially for testing. This format is used by many app stores but not Google Play Store.
• Android App Bundle (AAB) files which can be shared on Google Play Store.
• Android Archive (AAR) files which can be used as a re-usable bundle of resources for other projects.

It supports multiple CPU architectures.

It supports apps developed with Kivy framework, but was built to be flexible about the backend libraries (through "bootstraps"), and also supports PySDL2, and a WebView with a Python web server.

It automatically supports dependencies on most pure Python packages. For other packages, including those that depend on C code, a special "recipe" must be written to support cross-compiling. python-for-android comes with recipes for many of the mosty popular libraries (e.g. numpy and sqlalchemy) built in.

python-for-android works by cross-compiling the Python interpreter and its dependencies for Android devices, and bundling it with the app's python code and dependencies. The Python code is then interpreted on the Android device.

It is recommended that python-for-android be used via Buildozer, which ensures the correct dependencies are pre-installed, and centralizes the configuration. However, python-for-android is not limited to being used with Buildozer.

Documentation

More information is available in the online documentation including a quickstart guide.

python-for-android is managed by the Kivy team.

Support

Are you having trouble using python-for-android or any of its related projects in the Kivy ecosystem? Is there an error you don’t understand? Are you trying to figure out how to use it? We have volunteers who can help!

The best channels to contact us for support are listed in the latest Contact Us document.

Code of Conduct

In the interest of fostering an open and welcoming community, we as contributors and maintainers need to ensure participation in our project and our sister projects is a harassment-free and positive experience for everyone. It is vital that all interaction is conducted in a manner conveying respect, open-mindedness and gratitude.

Please consult the latest Code of Conduct.

Contributors

This project exists thanks to all the people who contribute. [Become a contributor].

Backers

Thank you to all of our backers! 🙏 [Become a backer]

Sponsors

Special thanks to all of our sponsors, past and present. Support this project by [becoming a sponsor].

Here are our top current sponsors. Please click through to see their websites, and support them as they support us.