Merge pull request #403 from andyDoucette/master

Adding README.rst entries for how to use buildozer with python3

README.rst

@@ -18,10 +18,10 @@ is intended in the future.
 Note that this tool has nothing to do with the eponymous online build service
 `buildozer.io <http://buildozer.io />`_.
 
-Usage example
--------------
+Installing Buildozer with python2 support:
+------------------------------------------
 
-#. Install buildozer::
+#. Install buildozer:: 
 
     # via pip (latest stable, recommended)
     sudo pip install buildozer
@@ -35,13 +35,54 @@ Usage example
     python setup.py build
     sudo pip install -e .
 
-#. Go into your application directory and do::
+#. Go into your application directory and run::
 
     buildozer init
     # edit the buildozer.spec, then
     buildozer android_new debug deploy run
 
-Example of commands::
+Installing Buildozer with python3 support:
+------------------------------------------
+
+The pip package does not yet support python3.
+
+#. Install buildozer from source::
+
+    git clone https://github.com/kivy/buildozer
+    cd buildozer
+    python setup.py build
+    sudo pip install -e 
+
+#. Download and extract the crystax ndk somewhere (~/.buildozer/crystax-ndk is one option): https://www.crystax.net/en/download
+#. Go into your application directory and execute::
+
+    buildozer init
+
+#. Edit the buildozer.spec file to fit your application
+
+#. Make sure the following lines are in your buildozer.spec file.::
+  
+    #Require python3crystax:
+    requirements = python3crystax,kivy
+
+    #Point to the directory where you extracted the crystax-ndk:
+    android.ndk_path = <Your install path here.  Use ~ for home DIR>
+
+    #To fix a "configparser.NoOptionError: No option 'p4a.local_recipes' in section: 'app'" issue:
+    p4a.local_recipes =
+
+#. Finally, build, deploy and run the app on your phone::
+
+    buildozer android_new debug deploy run
+
+#.  Please note the "android_new" buildozer target, and use that for any and all buildozer commands you run (even if the docs just say "android").  Python3 only works with the **android_new** toolchain.
+
+
+
+Examples of Buildozer commands:
+--------------------------------
+
+::
 
     # buildozer target command
     buildozer android_new clean