kivy / kivy / 27977218873

60%

push

github

feat: introduce kivy.mobile — platform-neutral bridge for mobile window/display geometry (#9331)

* feat: introduce kivy.mobile namespace for mobile window/display geometry

Add kivy/mobile/ package as a platform-neutral bridge for runtime
information Kivy needs on mobile platforms (DPI, scale, safe area,
keyboard height).  Platform dispatch lives in kivy/mobile/_platform/:

  ios.py     — full UIKit implementation via ctypes / ObjC runtime:
               get_dpi (lookup table), get_scale (nativeScale),
               get_safe_area (safeAreaInsets), live keyboard height via
               NSNotificationCenter UIKeyboardWillChangeFrameNotification.
  android.py — delegates to jnius / android platform module; exposes
               get_display_cutout() and get_system_bar_insets() (Tier-2).
  generic.py — desktop fallback; get_dpi() reads from the Window provider,
               all mobile-only values return safe zeros.

Wire kivy.mobile into existing callers:
  * kivy/metrics.py: replace bare `import ios` / `import android` in
    get_dpi() and get_density() with `from kivy.mobile import ...`.
  * kivy/core/window/__init__.py: replace _get_ios_kheight() bare import,
    add Window.safe_area DictProperty refreshed on startup and on_rotate,
    add _refresh_safe_area() helper.

Add kivy/tests/test_mobile.py with desktop-runnable unit tests covering
the generic fallback and the full public API contract.

* refactor: remove get_kheight() from kivy.mobile public API

get_kheight() was an internal Kivy convention (used by _get_ios_kheight)
that was never documented as public API. The canonical name is
get_keyboard_height(). Removing the alias keeps the kivy.mobile surface
clean from the start.

get_kheight() is retained in the kivy-ios ios.py template for backward
compatibility with apps that import it directly from the platform shim.

* docs: clarify Android implementation uses jnius (always present in p4a)

* refactor: make android.py an explicit placehold... (continued)

3250 of 6484 branches covered (50.12%)

128 of 252 new or added lines in 6 files covered. (50.79%)

28826 of 48405 relevant lines covered (59.55%)

1.18 hits per line