Skip to content

Commit 7914417

Browse files
committed
Updated bootstrap doc
1 parent eb282b9 commit 7914417

File tree

1 file changed

+47
-0
lines changed

1 file changed

+47
-0
lines changed

doc/source/bootstraps.rst

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,3 +16,50 @@ automatically build everything appropriately.
1616
This page describes the basics of how bootstraps work so that you can
1717
create and use your own if you like, making it easy to build new kinds
1818
of Python project for Android.
19+
20+
21+
Current bootstraps
22+
==================
23+
24+
python-for-android includes the following bootstraps by default, which
25+
may be chosen by name with a build parameter, or (by default) are
26+
selected automatically in order to fulfil your build requirements. For
27+
instance, if you add 'sdl2' in the requirements, the sdl2 backend will
28+
be used.
29+
30+
p4a is designed to make it fairly easy to make your own bootstrap with a new backend,
31+
e.g. one that creates a webview interface and runs python in the
32+
background to serve a flask or django site from the phone itself.
33+
34+
35+
pygame
36+
------
37+
38+
This builds APKs exactly like the old p4a toolchain, using Pygame as
39+
the windowing and input backend.
40+
41+
This bootstrap automatically includes pygame, kivy, and python. It
42+
could potentially be modified to work for non-Kivy projects.
43+
44+
sdl2
45+
----
46+
47+
This builds APKs using SDL2 as the window and input backend. It is not
48+
fully developed compared to the Pygame backend, but has many
49+
advantages and will be the long term default.
50+
51+
This bootstrap automatically includes SDL2, but nothing else.
52+
53+
You can use the sdl2 bootstrap to seamlessly make a Kivy APK, but can
54+
also make Python apps using other libraries; for instance, using
55+
pysdl2 and pyopengl. `Vispy <http://vispy.org/>`_ also runs on android
56+
this way.
57+
58+
empty
59+
-----
60+
61+
This bootstrap has no dependencies and cannot actually build an
62+
APK. It is useful for testing recipes without building unnecessary
63+
components.
64+
65+

0 commit comments

Comments
 (0)