feat(android): statusBarHeight parity and cutoutSize (#13733)

* test * feat(android): statusBarHeight parity and cutoutSize * remove empty line * apidocs * missing gitignore

Author: m1ga

android/modules/ui/src/java/ti/modules/titanium/ui/UIModule.java

@@ -26,16 +26,22 @@
 importandroid.content.res.Configuration;
 importandroid.content.res.Resources;
 importandroid.graphics.Color;
+importandroid.graphics.Rect;
 importandroid.graphics.drawable.Drawable;
+importandroid.os.Build;
 importandroid.text.InputType;
 importandroid.text.util.Linkify;
+importandroid.view.DisplayCutout;
 importandroid.view.View;
+importandroid.view.Window;
 importandroid.webkit.WebViewClient;
 importandroid.widget.Toast;
 
 importandroidx.annotation.NonNull;
 importandroidx.appcompat.app.AppCompatDelegate;
 
+importjava.util.List;
+
 @Kroll.module
 publicclassUIModuleextendsKrollModuleimplementsTiApplication.ConfigurationChangedListener
 {
@@ -571,6 +577,64 @@ public int getUserInterfaceStyle()
 returngetUserInterfaceStyle(TiApplication.getInstance().getResources().getConfiguration());
  }
 
+@Kroll.getProperty
+publicintstatusBarHeight()
+ {
+if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
+Windoww = TiApplication.getAppCurrentActivity().getWindow();
+if (w == null) return0;
+Viewdv = w.getDecorView();
+if (dv == null) return0;
+if (dv.getRootWindowInsets() == null) return0;
+DisplayCutoutdpc = dv.getRootWindowInsets().getDisplayCutout();
+if (dpc == null) return0;
+List<Rect> rects = dpc.getBoundingRects();
+if (rects.size() > 0) {
+inth = dpc.getBoundingRects().get(0).height();
+return (int) newTiDimension(h, TiDimension.TYPE_HEIGHT).getAsDefault(dv);
+ }
+ }
+return0;
+ }
+
+@Kroll.getProperty
+publicKrollDictgetCutoutSize()
+ {
+KrollDictreturnValue = newKrollDict();
+returnValue.put("top", 0);
+returnValue.put("left", 0);
+returnValue.put("height", 0);
+returnValue.put("width", 0);
+
+if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
+Windoww = TiApplication.getAppCurrentActivity().getWindow();
+if (w == null) returnreturnValue;
+Viewdv = w.getDecorView();
+if (dv == null) returnreturnValue;
+if (dv.getRootWindowInsets() == null) returnreturnValue;
+DisplayCutoutdpc = dv.getRootWindowInsets().getDisplayCutout();
+if (dpc == null) returnreturnValue;
+List<Rect> rects = dpc.getBoundingRects();
+
+intcutouts = rects.size();
+int[] result = newint[cutouts * 4];
+intindex = 0;
+
+if (rects.size() > 0) {
+intdh = dpc.getBoundingRects().get(0).height();
+intdw = dpc.getBoundingRects().get(0).width();
+intdt = dpc.getBoundingRects().get(0).top;
+intdl = dpc.getBoundingRects().get(0).left;
+
+returnValue.put("left", (int) newTiDimension(dl, TiDimension.TYPE_LEFT).getAsDefault(dv));
+returnValue.put("top", (int) newTiDimension(dt, TiDimension.TYPE_TOP).getAsDefault(dv));
+returnValue.put("width", (int) newTiDimension(dw, TiDimension.TYPE_WIDTH).getAsDefault(dv));
+returnValue.put("height", (int) newTiDimension(dh, TiDimension.TYPE_HEIGHT).getAsDefault(dv));
+ }
+ }
+returnreturnValue;
+ }
+
 @Override
 publicStringgetApiName()
  {

apidoc/Titanium/UI/UI.yml

@@ -2807,6 +2807,15 @@ properties:
 osver: {ios: {min: "13.0"}}
 since: "9.1.0"
 
+ - name: cutoutSize
+summary: Returns the position and shape of the Android notch. Read more about the notch [here](https://developer.android.com/develop/ui/views/layout/display-cutout).
+description: |
+ Using Android 9+ it will return the bounding box of the Android notch. It will return `top`,`left, `width` and `height`.
+type: CutoutSize
+permission: read-only
+platforms: [android]
+since: "12.1.0"
+
  - name: statusBarHeight
 summary: The total height of the status bar including safe area padding.
 description: |
@@ -2856,3 +2865,25 @@ examples:
  win.add(table);
  win.open();
  ```
+
+---
+name: CutoutSize
+summary: Dictionary object of parameters for the <Titanium.UI.cutoutSize>.
+since: "12.1.0"
+platforms: [android]
+properties:
+ - name: left
+type: Number
+summary: The left margin of the cutout.
+
+ - name: right
+type: Number
+summary: The left margin of the cutout.
+
+ - name: width
+type: Number
+summary: The width of the cutout
+
+ - name: height
+type: Number
+summary: The height of the cutout