Skip to content

Commit 466cdf4

Browse files
committed
Fixed redundant bootstrap explanation in doc
1 parent 729ce93 commit 466cdf4

File tree

2 files changed

+4
-46
lines changed

2 files changed

+4
-46
lines changed

doc/source/bootstraps.rst

Lines changed: 2 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -11,56 +11,12 @@ components such as Android source code and various build files.
1111
If you do not want to modify p4a, you don't need to worry about
1212
bootstraps, just make sure you specify what modules you want to use
1313
(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.
1516

1617
This page describes the basics of how bootstraps work so that you can
1718
create and use your own if you like, making it easy to build new kinds
1819
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.
6420

6521

6622
Creating a new bootstrap

doc/source/buildoptions.rst

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -56,6 +56,8 @@ the build is not fully optimised so APKs are probably a little larger
5656
and slower than they need to be. This is currently being addressed,
5757
though it's not clear how the final result will compare to python2.
5858

59+
.. _bootstrap_build_options:
60+
5961
Bootstrap
6062
---------
6163

0 commit comments

Comments
 (0)