kivy / python-for-android / 30202661691

63%

push

github

android: implement Kivy 3's bootstrap contract (`_kivy_bootstrap`) (#3356)

* android: implement Kivy 3's bootstrap contract

Kivy 3 no longer reflects a hardcoded org.kivy.android.PythonActivity.  It
imports a top-level `_kivy_bootstrap` module supplied by whoever built the APK
and pulls the current Activity from it, so Kivy stops depending on a p4a
implementation detail and p4a becomes one bootstrap satisfying the contract.

The `android` recipe is the natural home: it is already a hard dependency of the
`kivy` recipe, so every Kivy app has it, and it already knows
ACTIVITY_CLASS_NAME.  Reading the class from the generated `android.config`
means --activity-class-name is honoured rather than assumed, which the
hardcoded name in Kivy silently broke.

The contract's optional `remove_presplash()` is implemented too, restoring for
Kivy 3 the capability negotiation Kivy 2.x got from `try: import android`.  It
asks the activity for removeLoadingScreen instead of branching on the bootstrap
name, since not every build has one and such a list has already drifted.

Nothing imports the module unless Kivy 3 does, so this is inert for existing
builds; Kivy 2.3.1 keeps using the `android` module as before.

doc/source/kivy_bootstrap.rst documents the contract for bootstrap authors —
what to ship, the rules it must obey, and this file as the worked example.

* docs: trim kivy_bootstrap guide to the contract itself

Drop the minimal-implementation, worked-example, kivyforge, and on-device
verification sections per maintainer feedback. Point readers at p4a's
`_kivy_bootstrap.py` instead of reproducing it, and stop naming other
build tools.

1832 of 3194 branches covered (57.36%)

Branch coverage included in aggregate %.

5413 of 8366 relevant lines covered (64.7%)

3.88 hits per line