eliasdorneles / beeware-android-template

Template for starting a native Android app using Python and the BeeWare tools

BeeWare Android Template

A template for starting a native Android app using Python and the BeeWare tools.

More specifically, it uses VOC for compiling Python into Java bytecode and Briefcase to package as an Android app.

Using this template

Requirements: you need to have Python 3, Java JDK and the Android SDK installed

0. Create a virtualenv using Python 3 (3.5 recommended).

1. Install cookiecutter. This is a tool used to bootstrap complex project templates:

   $ pip install cookiecutter
   

2. Run cookiecutter on this template:

   $ cookiecutter https://github.com/eliasdorneles/beeware-android-template
   

3. Add your code to the project.

4. Install Briefcase. This is a tool that produces a version of your project that can be deployed to specific platforms:

   $ pip install briefcase
   

5. Start the Android emulator or connect your Android device

6. Build and run your app with:

   $ python setup.py android --start
   

Example apps

• TicTacToe (created before this template, but using the same building blocks)
• Drawing app (created with this template)
• Todo app (created with this template)