@@ -11,56 +11,12 @@ components such as Android source code and various build files.
11
11
If you do not want to modify p4a, you don't need to worry about
12
12
bootstraps, just make sure you specify what modules you want to use
13
13
(or specify an existing bootstrap manually), and p4a will
14
- automatically build everything appropriately.
14
+ automatically build everything appropriately. The existing choices are
15
+ explained on the :ref: `build options <bootstrap_build_options >` page.
15
16
16
17
This page describes the basics of how bootstraps work so that you can
17
18
create and use your own if you like, making it easy to build new kinds
18
19
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
20
65
21
66
22
Creating a new bootstrap
0 commit comments