The Python for android project includes a Python module called "android". It

consists of multiple parts which are mostly there to facilitate the use of the Java API.

This module is not designed to be comprehensive. Most of the Java API is also accessible with PyJNIus,

so if you can't find what you need here you can try using the Java API directly instead.

#. In your application, you can use the billing module like this::

#. To initiate an in-app purchase, just call the buy() method::

#. Last step, create your application with `--with-billing $BILLING_PUBKEY`::

to python on android ?

about it. Without Pyjnius, the schema to access to Java API from Cython is::

Think about acceleration sensors : you want to get the acceleration values in

python nothing is available natively, but you have a java API for that : the

google API is available here

A recipe is a script that contain the "definition" of a module to compile.

When building, all the recipe build must go to::

complete build function.

Don't forget that Python for android is not Kivy only, and you might want

to use other toolkit libraries. When other toolkits will be available, this

documentation will be enhanced.

#. Create a distribute with kivy::

#. Plug your android device, and ensure you can install development application

#. If it's goes wrong, open the logcat by doing::

A good starting point to build an APK are prebuilt VirtualBox images, where

the Android NDK, the Android SDK and the Kivy Python-For-Android sources

are prebuilt in an VirtualBox image. Please search the `Download Section

<http://kivy.org/#download>`__ for

such an image. You will also need to create a device filter for the Android

We recently fixed sqlite3 compilation. In case of, you must:

* Install development headers for sqlite3 if it's not already installed. On Ubuntu:

And then, sqlite3 will be compiled, and included in your APK.

You can access through this method all Java Android API, e.g. to get the DisplayMetrics

of an Android device could fetched using the following piece of code:

You can access all fields and methods as described in the `Java Android

DisplayMetrics API <http://developer.android.com/reference/android/util/DisplayMetrics.html>`__

as shown here with the method `setToDefaults()` and the field `densityDpi`.

Before you use o view a field, you should always call `setToDefaults` to initiate

to the default values of the device.

Currently only JavaMethod, JavaStaticMethod, JavaField, JavaStaticField

and JavaMultipleMethod are built into PyJNIus, therefore such constructs like

registerListener or something like this have to be coded still in Java.

For this the Android module described below is available to access some of

the hardware in Android devices.

.. note::

There is a VirtualBox Image we provide with the prerequisites along with

Android SDK and NDK preinstalled to ease your installation woes. You can download it from `here <http://kivy.org/#download>`__.

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 patch, not bug

report. Pyhton for Android works on Linux and Mac OSX, 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)::

Ensure you have the latest cython version::

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 prefered to use:

If it's your very first time into android SDK, don't forget to follow

documentation for recommended components at::

After installing them, export both installation path, NDK version and API to use::

Also, you must configure you're PATH to add the ``android`` binary::

If you want to compile the toolchain with only kivy module::

After a long time, you'll get a "dist/default" directory containing all the compiled

libraries and build.py script to package your application using thoses

libraries.

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.::

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::

internet, and build from it, if you know what you are doing, and want to

override that, you can export the env variable `P4A_recipe_name_DIR` and

this directory will be copied and used instead.

Go fo your custom python distribution::

Then, the android package (APK) will be generated at:

save a few megabytes on the final apk file, in case your

src/blacklist.txt file remove the module you need from the list,