display-cutout

buildozer/default.spec

@@ -163,6 +163,13 @@ fullscreen = 0
 # (bool) If True, your application will be listed as a home app (launcher app)
 # android.home_app = False
 
+# (str) Defaults to never for ignoring cutouts/notch
+# A display cutout is an area on some devices that extends into the display surface.
+# It allows for an edge-to-edge experience while providing space for important sensors on the front of the device.
+# Available options for Android API >= 28 are default, shortEdges, never and defaults to never.
+# Android documentation: https://developer.android.com/develop/ui/views/layout/display-cutout
+#android.display_cutout = never
+
 # (str) Path to a custom whitelist file
 #android.whitelist_src =
 

buildozer/targets/android.py

@@ -816,6 +816,15 @@ def execute_build_package(self, build_cmd):
         # Home-app usage
         if self.buildozer.config.getbooldefault('app', 'android.home_app', False):
             cmd.append("--home-app")
+
+        # Enable display-cutout
+        display_cutout = self.buildozer.config.getdefault('app', 'android.display_cutout', 'never')
+        if display_cutout in {'default', 'shortEdges', 'never'}:
+            cmd.append("--display-cutout={}".format(display_cutout))
+        else:
+            raise BuildozerException(
+                "You have stated the wrong option for android.display_cutout. "
+                "One of the following options are required: 'default', 'shortEdges' and 'never'.")
 
         # support for recipes in a local directory within the project
         if local_recipes:

docs/source/specifications.rst

@@ -131,3 +131,6 @@ Section [app]
 
   Defaults to false, your application will be listed as a Home App (launcher app) if true.
 
+- `display_cutout`: String, display-cutout mode to be used.
+
+  Defaults to `never`. Application will render around the cutout (notch) if set to either `default`, `shortEdges`.