This serves as an example of how to get a simple Pygame game working on Android.

Please ensure that the main file of your game is named main.py.

Please ensure that your game will run with pygame_sdl2. Generally, this consists of adding the lines:

try:
 import pygame_sdl2
 pygame_sdl2.import_as_pygame()
except ImportError:
 pass

to the top of your main.py file, before the first import of pygame. (However, note that pygame_sdl2 does not yet implement all of pygame.)

For now, RAPT supports only python2.7.

This repository serves as a simple pygame_sdl2-ready game.

RAPT depends on your computer having a JDK in the path, and Python 2.7 installed. On Windows, you'll need a 32-bit JDK if you're using a 32-bit Python 2.7.

You may also need to install device drivers and permissions to ensure that the Android SDK will talk to your device.

Download the latest nightly build of RAPT from http://nightly.renpy.org/current/ . The file you want will end in -rapt.zip. Unzip the file. All further commands should be run from inside the rapt directory.

This can be done by running:

python android.py installsdk

RAPT will prompt you to accept various license, and create a signing key. This has to be done only once per RAPT install.

Configure the game:

python android.py configure /path/to/rapt-pygame-example

The correct answers vary depending on the game. For our example, we used:

• Full Name: Android Test
• Short Name: Android Test
• Package Name: org.renpy.android_test
• Human-readable Version: 1.0
• Version Code: 100
• Orientation: 1) Landscape
• Expansion APK: 1) No
• Android Version: 3) Android 4.0
• Application Layout: 1) Single directory, device internal storage.
• Include Source Code: no
• Permissions: VIBRATE
• SQlite3: no (may not work)
• PIL: no (may not work)

This must be done once per game.

This can be done with the command:

python android.py --launch build /path/to/rapt-pygame-example release install

This must be done each time the game changes, to ensure the latest version is on the device.