In-Game: [Android] android:windowLayoutInDisplayCutoutMode should be supported to allow edge-to-edge displays when there are cut-outs

[shichen85]

Description

We want to display the app from edge to edge on the screen even if there are cutouts. The windowLayoutInDisplayCutoutMode seemed to allow that if it is defined as always:

https://developer.android.com/reference/android/R.attr#windowLayoutInDisplayCutoutMode

However, by using an extension and using the YYAndroidManifestActivityAttributes tag, the app still ended up not drawing on the cutouts.

Steps To Reproduce

1. Use the Android developer function to simulate cutout on the testing device: https://developer.android.com/develop/ui/views/layout/display-cutout#testing
2. Run the sample, which is supposed to draw the entire display with white color
3. See that the cutout regions does not render the app
4. Change the extension's Android settings to modify the windowLayoutInDisplayCutoutMode settings to other constants such as always or shortEdges
5. Rerun the sample and see no change

Which version of GameMaker are you reporting this issue for?

IDE v2024.1100.0.651 Runtime v2024.1100.0.686

Which operating system(s) are you seeing the problem on?

Windows 10.0.22000.0

Which platform(s) are you seeing the problem on?

Android

05fa2e9f-5d9c-4fd0-9cba-706952da22d9

[jackerley]

The fix for this got a bit involved and led to adding quite a few new things.

Gradle version and gradle plugin version is now editable per project - new options in Game Options->Android->General

Option to enable Edge to Edge display is added in Game Options->Android->Graphics

Option to allow control of Display layout added to Game Options->Android->Graphics (https://developer.android.com/develop/ui/views/layout/display-cutout)

The minimum Android Compile SDK is now 34 (enforced at compile time)

A new async system message is sent when the display layout changes this has type "DisplayLayoutInfo" and contains safeinsettop, safeinsetbottom, safeinsetleft and safeinsetright these return the distance from the edge that it is safe to display in. (ie where no system ui will cover it) These values are returned on iOS and Android. On Android we also return a boundrects entry that contains information on rectangles within those areas that are non-functional (DisplayCutout If the display layout has a waterfall display this is also returned - waterfallinsetbottom/top/left/right

I've included a project that displays this info and shows how it can be read in the async event.

display_cutout.zip

[YYBartT]

Added the newly added game options to the Android Game Options manual page. Also added the new event type "DisplayLayoutInfo" to the async System event page.

[cameron-home]

Bouncing back to @jackerley, as there appears to be issues where the edge to edge display is not improving when enabled.