Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

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

Merged
merged 6 commits into from
Apr 17, 2017
Merged

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

Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
5eb91ca
Adding documentation of how to get buildozer to work with python3.
printathing Sep 25, 2016
e8c7769
Fixing some typos in Readme.rst.
printathing Sep 25, 2016
1d29ab1
Moving some README text to a quote instead of code section.
printathing Sep 25, 2016
e209cf0
Adding p4a.local_recipies line. I forgot that before.
printathing Sep 26, 2016
68245e2
Making step 5 of readme a code block.
printathing Sep 26, 2016
35ba75d
Removing redundant text.
printathing Sep 26, 2016
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 46 additions & 5 deletions README.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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
Expand Down