kivy / kivy / 30008832315

60%

Build Type

push

github

Committed by web-flow

Commit Message

kivy.mobile Android backend for Window geometry, metrics scaling, and keyboard input type (#9345)

* kivy.mobile: add Android backend for window/display geometry

Implement the Android platform backend for kivy.mobile using jnius,
exposing DPI, scale, keyboard height, safe area, display cutout and
system-bar insets. The backend:

* is import-safe off-device and on API < 30 (jnius imports and
  WindowInsets.Type resolution are guarded/lazy), degrading to
  zeros/None with a single warning instead of failing to import;
* uses DisplayMetrics.density (not scaledDensity) for scale so the
  user's font scale is not double-counted;
* documents the per-feature Android API-level requirements;
* drives keyboard-height updates by polling the IME inset from a Kivy
  Clock tick, with the polling-vs-listener rationale documented inline;
* logs (rather than silently swallows) exceptions raised by
  keyboard-height subscribers while keeping subscribers isolated.

* kivy.core.window: source mobile keyboard height and safe area from kivy.mobile

Route Window.keyboard_height through kivy.mobile.get_keyboard_height()
for both Android and iOS, and subscribe to kivy.mobile keyboard-height
updates. Refresh Window.safe_area on both size and rotation changes
(Android orientation changes arrive as window resizes, not rotation
property changes), with a next-frame refresh so an early null inset read
does not stick at zero, and without swallowing errors raised by
on_safe_area observers.

* kivy.mobile: add test suite for the Android backend

Exercise android.py's real reflection paths through a fake jnius harness:
metric reads, keyboard-height polling and change notification, safe-area
unioning of system bars and display cutout, graceful degradation
off-device and on API 29, subscription idempotence, and isolation of a
raising keyboard-height subscriber.

* kivy.metrics: source fontscale from kivy.mobile

Route Metrics.fontscale through kivy.mobile like dpi and density, instead
o... (continued)

Coverage Stats

3263 of 6505 branches covered (50.16%)

361 of 380 new or added lines in 5 files covered. (95.0%)

2 existing lines in 2 files now uncovered.

29230 of 48856 relevant lines covered (59.83%)

1.18 hits per line