[Bug]: adjustMarginsForEdgeToEdge Not Working on Android (Capacitor 7.1.0)

[ckoon-infopro]

Capacitor Version

Capacitor Doctor

Latest Dependencies:

@capacitor/cli: 7.1.0
@capacitor/core: 7.1.0
@capacitor/android: 7.1.0
@capacitor/ios: 7.1.0

Installed Dependencies:

@capacitor/cli: 7.1.0
@capacitor/core: 7.1.0
@capacitor/android: 7.1.0
@capacitor/ios: 7.1.0

[success] Android looking great! 👌
[error] Xcode is not installed

Other API Details

Platforms Affected

• iOS
• Android
• Web

Current Behavior

The new adjustMarginsForEdgeToEdge feature introduced in Capacitor 7.1.0 does not appear to be working as expected. I have installed Capacitor 7.1.0, set this option to 'auto' and 'force' in my configuration, but margins are not being adjusted accordingly.

Expected Behavior

When set to "force", margins should always be adjusted for edge-to-edge display.
When set to "auto", margins should be adjusted if running on Android 15 and windowOptOutEdgeToEdgeEnforcement is false or missing.

Project Reproduction

Any Android project with Capacitor 7.1.0 installed.

Additional Information

After some troubleshooting, I found that the following check fails:

if (webView instanceof CapacitorWebView capacitorWebView) {
    capacitorWebView.setBridge(bridge);
    capacitorWebView.edgeToEdgeHandler(bridge);
}

The edgeToEdgeHandler method does not get called because webView is not an instance of CapacitorWebView. This seems to be preventing the margins from being adjusted as expected.

Could this be a bug, or is there an additional setup required to ensure webView is correctly recognized as a CapacitorWebView?

[ionitron-bot]

This issue needs more information before it can be addressed. In particular, the reporter needs to provide a minimal sample app that demonstrates the issue. If no sample app is provided within 15 days, the issue will be closed.
Please see the Contributing Guide for how to create a Sample App.
Thanks! Ionitron 💙

[sufian1985]

Simply create a new ionic sample app i.e. tabs app with the latest version and running on it on android device still results in the header overlapping issue due to android edge to edge display which was expected to be resolved with capacitor 7.1.0 release

[moose4lord]

Hmmmm...after some experimenting, I seem to be getting somewhat reasonable results when I use adjustMarginsForEdgeToEdge. I think maybe you're misunderstanding what the parameter does.

Setting adjustMarginsForEdgeToEdge=force does not force the display to render edge-to-edge. Instead it forces insets to be applied so the status bar and nav bar are displayed properly when edge-to-edge mode is active. At least, after running various combinations of adjustMarginsForEdgeToEdge and windowOptOutEdgeToEdgeEnforcement, that's the conclusion I've come to. Here's a table of screenshots I got:

	windowOptOutEdgeToEdgeEnforcement=false	windowOptOutEdgeToEdgeEnforcement=true
adjustMarginsForEdgeToEdge=disable	❌ BAD	❌ BAD
adjustMarginsForEdgeToEdge=force	✅ OK	✅ OK
adjustMarginsForEdgeToEdge=auto	✅ OK	❌ BAD

I'm not sure why some combinations work, but others do not.

[marcorombach]

It seems like, there are some plugins that also affect the edge-to-edge behaviour. For me the plugin capacitor-community/image-to-text caused no margins to be applied no matter which setting I choose for adjustMarginsForEdgeToEdge.
The issue #7917 explains the reason for this.

[Yernike]

It is not working for me, have no effect adjustMarginsForEdgeToEdge='force'

@capacitor/cli: 7.1.0
@capacitor/core: 7.1.0
@capacitor/android: 7.1.0
@capacitor/ios: 7.1.0