feat(android): Add immersive configuration to Splash

[xzilja]

This adds additional flag to capacitor config called splashImmersive that allows to hide not only status bar (achieved by using already existing splashFullScreen flag) but also software navigation bar. More info available here https://developer.android.com/training/system-ui/immersive#immersive

This particular configuration uses "Sticky Immersive" approach https://developer.android.com/training/system-ui/immersive#sticky-immersive

closes #2423

[xzilja]

@jcesarmobile I wanted to ask for your help with this one. I'll attach gif below that shows current functionality, you will notice these 2 issues

1. Navbar is not hidden instantly as statusbar is
2. if <item name="android:background">@drawable/splash</item> is set inside style, when navbar is hidden screen jumps down, ideally it should remain fixed all the time. If I set it to just black color for example, it is no longer an issue, but it takes a while to see splash screen graphic.

Unfortunately my knowledge of android is not enough to figure out why exactly this is happening. As you can see in #2423 there are few more things I am doing maybe its missing here? I tried adding setOnSystemUiVisibilityChangeListener, but it didn't make any difference. One other thing that is different there is Override for onWindowFocusChanged method, but I have no clue how to apply it inside Splash file atm.

[jcesarmobile]

No idea, try with windowBackground instead of background

[xzilja]

Same issue, also tried to add match_parent to android layout width and height. But besides this it does what it needs to do and hides software ui fully. Could you let me know if it is good to merge or if some changes are still needed? Once approved I will add this to documentation as well.

I will continue trying ideas out to fix this "jump" effect as they come.

[xzilja]

@jcesarmobile I spent 2h trying to fix this jump today, but came up empty handed. Can this be merged as is, or should we keep looking for solution? Perhaps you could suggest someone I can reach out to that might be able to help?

[jcesarmobile]

looks good.
merging now that the jump was fixed in another PR.
would be good if you could send another PR documenting it on https://github.com/ionic-team/capacitor/blob/master/site/docs-md/apis/splash-screen/index.md
and if you also document splashFullScreen even better.

[xzilja]

Added documentation #2613

[Epameinondas-Theodoropoulos]

I still have the same problem. Only the top bar is hidden.
The Navigation bar (bottom one) is still visible.

I have this in my capacitor.config.json
` "plugins": {

"SplashScreen": {
  "backgroundColor": "#07070a",
  "splashFullScreen": true,
  "splashImmersive": true
}

}`

and this is android\app\src\main\res\values\styles.xml

` <style name="AppTheme.NoActionBarLaunch" parent="AppTheme.NoActionBar">

    <item name="android:windowFullscreen">true</item>
    <item name="android:windowContentOverlay">@null</item>
</style>

`
check the picture below from the splash screen
https://imgur.com/a/CLtGuEC

[faithfulojebiyi]

I'm also experiencing the same issue with the jump...

[mjatin-globalizeMe]

For Capacitor, I did like this, and it works fine!

	"SplashScreen": {
		"launchShowDuration": 5000,
		"launchAutoHide": true,
		"splashImmersive": true,
		"androidScaleType": "CENTER_CROP",
		"useDialog": false,
		"backgroundColor": "#63d99f"
	},

[Pacjonek]

I had a different problem. In my case, the gray bar was displayed in place of the status bar.
I had to add the following line (style.xml):

        <item name="android:background">@android:color/white</item>

or if you want to have white background only during launch:

        <item name="android:windowBackground">@android:color/white</item>
        <item name="android:fitsSystemWindows">true</item>