From f536fc010907137d08bc700f1aad7d17105b41d6 Mon Sep 17 00:00:00 2001 From: Christopher Denter Date: Wed, 16 Mar 2011 17:56:52 +0100 Subject: [PATCH] docs: Reword android section --- doc/sources/guide/android.rst | 38 +++++++++++++++++++++-------------- 1 file changed, 23 insertions(+), 15 deletions(-) diff --git a/doc/sources/guide/android.rst b/doc/sources/guide/android.rst index 2ccb62633..e970ad2e6 100644 --- a/doc/sources/guide/android.rst +++ b/doc/sources/guide/android.rst @@ -3,21 +3,21 @@ Kivy on Android =============== -We want to thanks Renpy Tom for beeing able to run pygame on android, -with his `Pygame Subset for Android `_ project. +We want to thank Renpy's Tom for being able to run pygame on android, +using his `Pygame Subset for Android `_ project. -The changes made from his project are : +We made some changes to his project to be able to use it with Kivy: -- Support of multitouch event +- Support for multitouch events - OpenGL ES 2.0 surface - Include more Python modules -- Removing main() function and use __main__ hack. +- Removed main() function and use __main__ approach - Various enhancements on the build system for Kivy Introduction to the Kivy Launcher --------------------------------- -The Kivy launcher is an application to run any kivy examples stored on your +The Kivy launcher is an application to run any Kivy examples stored on your SD Card from android. See :ref:`androidinstall`. Your application must be saved into:: @@ -26,22 +26,24 @@ Your application must be saved into:: Your application directory must contain:: - main.py # <-- Your main application file - android.txt # <-- Some indication for running your application + # Your main application file: + main.py + # Some infos Kivy requires about your app on android: + android.txt -The `main.py` is the same as your original code. If you want to support android, -you must change the __main__ line to:: +The file `main.py` is the same as your original code. If you want to support +android, you must change the __main__ line to, though:: if __name__ in ('__main__', '__android__'): YourApp().run() -The `android.txt` can contain:: +The file `android.txt` must contain:: title= author= orientation= -Status of the project +Status of the Project --------------------- Missing providers: @@ -53,12 +55,18 @@ Missing providers: Missing features: - Keyboard mapping for main button -- Keyboard support in future TextInput widget +- Keyboard support in TextInput widget - Ability to hook app on sleep/wakeup - Ability for an application to have a settings screen -Working devices ---------------- +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. - Motorola Droid 1 - Motorola Droid 2