docs: Reword android section

This commit is contained in:
Christopher Denter 2011-03-16 17:56:52 +01:00
parent f57c325cd9
commit f536fc0109
1 changed files with 23 additions and 15 deletions

View File

@ -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 <http://renpy.org/pygame/>`_ project.
We want to thank Renpy's Tom for being able to run pygame on android,
using his `Pygame Subset for Android <http://renpy.org/pygame/>`_ 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=<Application Title>
author=<Your Name>
orientation=<portrait|landscape>
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