What's the difference between 'window' and 'screen' in the Dimensions API

The documentation on Dimensions is quite poor (outstanding issue), so you'll have to dive into the code to understand what is going on. If you look at the source of Dimensions, you'll see this comment on line 47:

// Screen and window dimensions are different on android

If you trace back the history using blame, you'll find this commit on the relevant section of code pointing to this old issue which itself points to this issue about Dimensions reporting different screen heights.

I don't know enough about Android itself, but from what I can gather, it appears that Android can report back two different numbers:

1. width/height with soft menu bar
2. width/height without soft menu bar (so the actual entire screen)

A quick test on my Android device printing out these values and I was able to confirm that window's height < screen's height. So in all likelihood, this means:

• window: reports width/height without the soft menu bar
• screen: reports entire screen's width/height

I didn't follow back this product pain about orientation changes on Android, so I don't know how rotating your screen affects this.

On Android, window reflects the section of the total screen made available for this app. There are at least 3 cases where screen and window may be different:

• If an Android device has the device navigation bar open, the window height will be lower than screen height by the height of the navigator. This is illustrated in this answer by RY Zheng which was linked to in an answer to this question which got deleted.

• If the app is shown in Android's split screen/multi-window mode, with windows for two apps side by side, window width or height will be lower than for screen based on how much of the width or height is given to that screen. This is "documented" in a PR by ThisIsMissEm on the react-native documentation that was closed becuase no-one from Facebook reviewed it.

• If an Android device had "screen zoom" or "display size" setting changed in Accessibility settings while the app was open, the scale, width and height properties for window will update to reflect the zoom but the properties for screen will not. If the app is restarted, the window scale property will match that of the screen.

  If an element with fixed dimensions fails to scale on changing screen zoom without restarting the app, multiplying those dimensions by Dimensions.get('window').scale / Dimensions.get('screen').scale may help.

Width and height for window will be the same size or smaller than screen; with one exception: if the app was opened with "display size" or "screen zoom" setting set high then this was set lower with the app still open. In this case the height and width will be greater and the scale will be lower by the same ratio.