79 lines
2.8 KiB
ReStructuredText
79 lines
2.8 KiB
ReStructuredText
Prerequisites
|
||
-------------
|
||
|
||
.. note:: There is a VirtualBox Image we provide with the
|
||
prerequisites along with the Android SDK and NDK preinstalled to
|
||
ease your installation woes. You can download it from `here
|
||
<http://kivy.org/#download>`__.
|
||
|
||
.. warning::
|
||
|
||
The current version is tested only on Ubuntu oneiric (11.10) and
|
||
precise (12.04). If it doesn't work on other platforms, send us a
|
||
patch, not a bug report. Python for Android works on Linux and Mac
|
||
OS X, not Windows.
|
||
|
||
You need the minimal environment for building python. Note that other
|
||
libraries might need other tools (cython is used by some recipes, and
|
||
ccache to speedup the build)::
|
||
|
||
sudo apt-get install build-essential patch git-core ccache ant python-pip python-dev
|
||
|
||
If you are on a 64 bit distro, you should install these packages too ::
|
||
|
||
sudo apt-get install ia32-libs libc6-dev-i386
|
||
|
||
On debian Squeeze amd64, those packages were found to be necessary ::
|
||
|
||
sudo apt-get install lib32stdc++6 lib32z1
|
||
|
||
Ensure you have the latest Cython version::
|
||
|
||
pip install --upgrade cython
|
||
|
||
You must have android SDK and NDK. The SDK defines the Android
|
||
functions you can use. The NDK is used for compilation. Right now,
|
||
it's preferred to use:
|
||
|
||
- SDK API 8 or 14 (15 will only work with a newly released NDK)
|
||
- NDK r5b or r7
|
||
|
||
You can download them at::
|
||
|
||
http://developer.android.com/sdk/index.html
|
||
http://developer.android.com/sdk/ndk/index.html
|
||
|
||
|
||
In general, Python for Android currently works with Android 2.3 to L.
|
||
|
||
If it's your very first time using the Android SDK, don't forget to
|
||
follow the documentation for recommended components at::
|
||
|
||
http://developer.android.com/sdk/installing/adding-packages.html
|
||
|
||
You need to download at least one platform into your environment, so
|
||
that you will be able to compile your application and set up an Android
|
||
Virtual Device (AVD) to run it on (in the emulator). To start with,
|
||
just download the latest version of the platform. Later, if you plan to
|
||
publish your application, you will want to download other platforms as
|
||
well, so that you can test your application on the full range of
|
||
Android platform versions that your application supports.
|
||
|
||
After installing them, export both installation paths, NDK version,
|
||
and API to use::
|
||
|
||
export ANDROIDSDK=/path/to/android-sdk
|
||
export ANDROIDNDK=/path/to/android-ndk
|
||
export ANDROIDNDKVER=rX
|
||
export ANDROIDAPI=X
|
||
|
||
# example
|
||
export ANDROIDSDK="/home/tito/code/android/android-sdk-linux_86"
|
||
export ANDROIDNDK="/home/tito/code/android/android-ndk-r7"
|
||
export ANDROIDNDKVER=r7
|
||
export ANDROIDAPI=14
|
||
|
||
Also, you must configure your PATH to add the ``android`` binary::
|
||
|
||
export PATH=$ANDROIDNDK:$ANDROIDSDK/platform-tools:$ANDROIDSDK/tools:$PATH
|
||
|