fix(android): initial gesture orientation value (#13755)

* fix(android): initial gesture orientation value * docs

Author: m1ga

android/modules/gesture/src/java/ti/modules/titanium/gesture/GestureModule.java

@@ -14,8 +14,10 @@
 importorg.appcelerator.titanium.ContextSpecific;
 importorg.appcelerator.titanium.TiApplication;
 importorg.appcelerator.titanium.TiProperties;
+importorg.appcelerator.titanium.util.TiDeviceOrientation;
 importorg.appcelerator.titanium.util.TiSensorHelper;
 
+importandroid.content.res.Configuration;
 importandroid.hardware.Sensor;
 importandroid.hardware.SensorEvent;
 importandroid.hardware.SensorEventListener;
@@ -174,12 +176,20 @@ public void onSensorChanged(SensorEvent event)
 @Kroll.getProperty
 publicbooleangetPortrait()
  {
+if (this.deviceOrientationMonitor.getLastReadOrientation() == TiDeviceOrientation.UNKNOWN) {
+intorientation = TiApplication.getAppCurrentActivity().getResources().getConfiguration().orientation;
+returnorientation == Configuration.ORIENTATION_PORTRAIT;
+ }
 returnthis.deviceOrientationMonitor.getLastReadOrientation().isPortrait();
  }
 
 @Kroll.getProperty
 publicbooleangetLandscape()
  {
+if (this.deviceOrientationMonitor.getLastReadOrientation() == TiDeviceOrientation.UNKNOWN) {
+intorientation = TiApplication.getAppCurrentActivity().getResources().getConfiguration().orientation;
+returnorientation == Configuration.ORIENTATION_LANDSCAPE;
+ }
 returnthis.deviceOrientationMonitor.getLastReadOrientation().isLandscape();
  }
 
@@ -189,6 +199,12 @@ public int getOrientation()
 returnthis.deviceOrientationMonitor.getLastReadOrientation().toTiIntId();
  }
 
+@Kroll.method
+publicvoidstopListener()
+ {
+this.deviceOrientationMonitor.stop();
+ }
+
 @Override
 publicStringgetApiName()
  {

apidoc/Titanium/Gesture/Gesture.yml

@@ -44,6 +44,15 @@ properties:
 type: Number
 permission: read-only
 
+methods:
+ - name: stopListener
+summary: Stops the gesture listener.
+description: |
+ In case you use `Titanium.Gesture.landscape` or `Titanium.Gesture.portrait` it will attach the orientation
+ listener automatically. If you just use it once you can use this method to stop the listener.
+since: "12.1.0"
+platforms: [android]
+
 events:
  - name: orientationchange
 summary: Fired when the device orientation changes.