2011-03-16 15:04:34 +00:00
|
|
|
.. _android:
|
|
|
|
|
|
|
|
|
|
Kivy on Android
|
|
|
|
|
===============
|
2011-02-03 03:07:30 +00:00
|
|
|
|
2011-10-14 14:24:57 +00:00
|
|
|
Kivy is able to run on android, but you need a phone with:
|
|
|
|
|
|
|
|
|
|
* SD Card
|
|
|
|
|
* OpenGL ES 2.0 (Android 2.2 minimum)
|
|
|
|
|
|
2011-04-22 14:24:47 +00:00
|
|
|
Requirements for android application
|
|
|
|
|
------------------------------------
|
2011-02-03 03:07:30 +00:00
|
|
|
|
2011-04-22 14:24:47 +00:00
|
|
|
As soon as you want to do an application for android platform, you must have a
|
|
|
|
|
file named `main.py` in for root directory of your application, and handling
|
|
|
|
|
the android platform in the `__name__` test::
|
2011-02-03 03:07:30 +00:00
|
|
|
|
2011-04-22 14:24:47 +00:00
|
|
|
if __name__ in ('__main__', '__android__'):
|
|
|
|
|
YourApp().run()
|
|
|
|
|
|
2011-07-15 14:43:34 +00:00
|
|
|
Create an APK
|
|
|
|
|
-------------
|
2011-04-22 14:24:47 +00:00
|
|
|
|
2011-07-15 14:43:34 +00:00
|
|
|
The whole process is described in the :ref:`packaging_android` documentation.
|
2011-02-03 03:07:30 +00:00
|
|
|
|
2011-04-22 14:24:47 +00:00
|
|
|
|
|
|
|
|
Debugging your application on android platform
|
|
|
|
|
----------------------------------------------
|
|
|
|
|
|
|
|
|
|
Android SDK ship a tool named adb. Connect your device, and run::
|
|
|
|
|
|
|
|
|
|
adb logcat
|
|
|
|
|
|
|
|
|
|
You'll see all the log, but also your stdout/stderr, Kivy logger.
|
|
|
|
|
|
|
|
|
|
|
2011-03-16 16:56:52 +00:00
|
|
|
Status of the Project
|
2011-02-03 03:07:30 +00:00
|
|
|
---------------------
|
|
|
|
|
|
2011-04-22 14:24:47 +00:00
|
|
|
This project is a derivated work of Pygame Subset for Android, made by Tom
|
|
|
|
|
Rothamel. His work is available at::
|
|
|
|
|
|
|
|
|
|
https://code.launchpad.net/~pgs4a-developer/pgs4a/mainline
|
|
|
|
|
|
|
|
|
|
This project code is available at::
|
|
|
|
|
|
|
|
|
|
https://code.launchpad.net/~tito-bankiz/pgs4a/kivy
|
|
|
|
|
|
|
|
|
|
We made that branch to be able to:
|
2011-02-03 03:07:30 +00:00
|
|
|
|
2011-04-22 14:24:47 +00:00
|
|
|
- integrate Kivy android-support branch in the build
|
|
|
|
|
- create opengl es 2 surface with stencil buffer
|
|
|
|
|
- enable multitouch event
|
2011-10-14 14:24:57 +00:00
|
|
|
- custom python native launcher that run the main.py
|
2011-04-22 14:24:47 +00:00
|
|
|
- default activation of WRITE_EXTERNAL_STORAGE permission
|
2011-10-14 14:24:57 +00:00
|
|
|
- *Video providers* (done in 1.0.8 version using ffmpeg-android)
|
2011-02-03 03:07:30 +00:00
|
|
|
|
2011-04-22 14:24:47 +00:00
|
|
|
Currently, Kivy is not fully supported on Android. We are missing:
|
2011-02-03 03:07:30 +00:00
|
|
|
|
2011-04-22 14:24:47 +00:00
|
|
|
- Camera providers
|
|
|
|
|
- Audio (can use RenPySound) providers
|
|
|
|
|
- Keyboard mapping for main button
|
|
|
|
|
- Ability to hook app on sleep/wakeup
|
2011-02-03 03:07:30 +00:00
|
|
|
|
2011-03-16 16:56:52 +00:00
|
|
|
Tested Devices
|
|
|
|
|
--------------
|
|
|
|
|
|
|
|
|
|
These Android devices have been confirmed working with Kivy. If your
|
|
|
|
|
device is not on the list, that does not mean that it is not supported.
|
|
|
|
|
If that is the case, please try running Kivy and if it succeeds let us
|
|
|
|
|
know so that we can update this list. Note, however, that your device has
|
|
|
|
|
to support at least OpenGL 2.0 ES.
|
2011-02-10 16:04:26 +00:00
|
|
|
|
2011-04-22 14:24:47 +00:00
|
|
|
Phones
|
|
|
|
|
~~~~~~
|
|
|
|
|
|
2011-02-10 16:04:26 +00:00
|
|
|
- Motorola Droid 1
|
|
|
|
|
- Motorola Droid 2
|
2011-02-23 20:10:11 +00:00
|
|
|
- HTC Desire
|
2011-02-10 16:04:26 +00:00
|
|
|
- HTC Desire Z
|
|
|
|
|
- Xperia 10 (custom ROM 2.1 + GLES 2.0 support)
|
|
|
|
|
|
2011-04-22 14:24:47 +00:00
|
|
|
Tablets
|
|
|
|
|
~~~~~~~
|
|
|
|
|
|
|
|
|
|
- Samsung Galaxy Tab
|
|
|
|
|
- Motorola Xoom
|
2011-05-19 13:20:23 +00:00
|
|
|
- Asus EeePad Transformer
|
2011-04-22 14:24:47 +00:00
|
|
|
|
