Cookiedozer

Please note that this project is no longer actively maintained. 🚧

Feature-rich Cookiecutter template for Python Kivy apps that greatly simplifies the deployment to Android devices using Buildozer.

For a minimal Kivy app template please check out cookiecutter-kivy.

Features

Installable PyPI package featuring a setup.py and a TestCommand
Test suite running pytest that includes a fixture for your app using the InteractiveLauncher
Sphinx docs that can be used to generate a readable html documentation
Buildozer spec file that is used to deploy your app to an Android mobile device
Makefile featuring several targets for important tasks such as coverage and apk
Comprehensive README.rst file that contains useful information about your app

Usage

Generate a Kivy project:

cookiecutter https://github.com/hackebrot/cookiedozer

Tutorials

Parts of this template are explained in great detail over the course of the following tutorials:

Part 1: Create your own Cookiecutter template
Part 2: Extending our Cookiecutter template
Part 3: Wrapping up our Cookiecutter template

Constraints

The tool at hand for creating and deploying an apk, namely Buildozer, is currently in beta stage. Although it doesn’t depend on any library, you must have a Linux or OSX computer to be able to compile for Android.

See Buildozer Docs.

License

Distributed under the terms of the MIT license, Cookiedozer is free and open source software

Issues

This template has been tested on Ubuntu Trusty Tahr as well as Mac OS X Yosemite.

If you encounter any problems, please file an issue along with a detailed description.

hackebrot/cookiedozer