Skip to content

Update usage.rst #285

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.

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

Merged
merged 1 commit into from
Nov 15, 2014
Merged
Changes from all commits
Commits
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
14 changes: 9 additions & 5 deletions docs/source/usage.rst
Original file line number Diff line number Diff line change
Expand Up @@ -17,18 +17,22 @@ You can include other modules (or "recipes") to compile using `-m`::
./distribute.sh -m "openssl kivy"
./distribute.sh -m "pil ffmpeg kivy"

.. note::

Recipes are instructions for compiling Python modules that require C extensions.
The list of recipes we currently have is at:
https://github.com/kivy/python-for-android/tree/master/recipes

You can also specify a specific version for each package. Please note that the
compilation might **break** if you don't use the default version. Most recipes
have patch to fixes android issues, and might not apply if you specify a
version. We also recommend to clean build/ before changing version.::

./distribute.sh -m "openssl kivy==master"

The list of available recipes is available at:
https://github.com/kivy/python-for-android/tree/master/recipes

From python-for-android 1.1, you can now specify pure-python package into the
-m. It will use virtualenv and pip to install pure-python modules into the
Python modules that don't need C extrnsions don't need a recipe and can be included this way.
From python-for-android 1.1 on, you can now specify pure-python package into the
distribution. It will use virtualenv and pip to install pure-python modules into the
distribution. Please note that compiler are deactivated, and will break any
module who try to compile something. If compilation is needed, write a recipe::

Expand Down