Support headlessJs (wix#1444)

Currently startApp is called from global context which results in the
app being launched when headlessJs tasks run in the background.
In order to support this use case, while not breaking existing users,
this commit adds two mechanisms which should help users detrmine if
the native Activity is running and startApp can be called safely.

1. RNN.appLaunched event is emitted is SplashActivity starts and react
   context has already been created. This is the use case of openeing
   the app while headless js task was started or has just finished and
   react context is in a "pasued" state.

2. Navigation.isAppLaunched() convenience method has been added.
   It returns a promise which when resolved, indicates if the app
   is launched and we should show the ui or not.

Usage

import {Navigation, NativeEventsReceiver} from 'react-native-navigation';

Promise.resolve(Navigation.isAppLaunched())
  .then(appLaunched => {
    if (appLaunched) {
      startApp();
    } else {
      new NativeEventsReceiver().appLaunched(startApp);
    }
  });

function startApp() {
  Navigation.startTabBasedApp({ ... });
}

Author: guyca

android/app/src/main/java/com/reactnativenavigation/bridge/EventEmitter.java

@@ -52,4 +52,11 @@ public void sendEvent(String eventId) {
         }
         reactGateway.getReactEventEmitter().sendEvent(eventId, Arguments.createMap());
     }
+
+    public void sendAppLaunchedEvent() {
+        if (!NavigationApplication.instance.isReactContextInitialized()) {
+            return;
+        }
+        reactGateway.getReactEventEmitter().sendEvent("RNN.appLaunched", Arguments.createMap());
+    }
 }

android/app/src/main/java/com/reactnativenavigation/bridge/NavigationReactModule.java

@@ -258,4 +258,9 @@ public void dismissContextualMenu(String screenInstanceId) {
     public void getOrientation(Promise promise) {
         NavigationCommandsHandler.getOrientation(promise);
     }
+
+    @ReactMethod
+    public void isAppLaunched(Promise promise) {
+        NavigationCommandsHandler.isAppLaunched(promise);
+    }
 }

android/app/src/main/java/com/reactnativenavigation/controllers/NavigationCommandsHandler.java

@@ -535,4 +535,9 @@ public static void getOrientation(Promise promise) {
         }
         promise.resolve(OrientationHelper.getOrientation(currentActivity));
     }
+
+    public static void isAppLaunched(Promise promise) {
+        final boolean isAppLaunched = SplashActivity.isResumed || NavigationActivity.currentActivity != null;
+        promise.resolve(isAppLaunched);
+    }
 }

android/app/src/main/java/com/reactnativenavigation/controllers/SplashActivity.java

@@ -11,6 +11,7 @@
 import com.reactnativenavigation.react.ReactDevPermission;
 
 public abstract class SplashActivity extends AppCompatActivity {
+    public static boolean isResumed = false;
 
     @Override
     protected void onCreate(@Nullable Bundle savedInstanceState) {
@@ -22,8 +23,11 @@ protected void onCreate(@Nullable Bundle savedInstanceState) {
     @Override
     protected void onResume() {
         super.onResume();
+        isResumed = true;
 
         if (NavigationApplication.instance.getReactGateway().hasStartedCreatingContext()) {
+            NavigationApplication.instance.getEventEmitter().sendAppLaunchedEvent();
+            overridePendingTransition(0, 0);
             finish();
             return;
         }
@@ -42,6 +46,12 @@ protected void onResume() {
         NavigationApplication.instance.startReactContextOnceInBackgroundAndExecuteJS();
     }
 
+    @Override
+    protected void onPause() {
+        super.onPause();
+        isResumed = false;
+    }
+
     private void setSplashLayout() {
         final int splashLayout = getSplashLayout();
         if (splashLayout > 0) {

src/NativeEventsReceiver.js

@@ -0,0 +1,14 @@
+import {
+  NativeAppEventEmitter,
+  DeviceEventEmitter,
+  Platform
+} from 'react-native';
+export default class NativeEventsReceiver {
+  constructor() {
+    this.emitter = Platform.OS === 'android' ? DeviceEventEmitter : NativeAppEventEmitter;
+  }
+
+  appLaunched(callback) {
+    this.emitter.addListener('RNN.appLaunched', callback);
+  }
+}

src/Navigation.js

@@ -162,6 +162,10 @@ function handleDeepLink(params = {}) {
   }
 }
 
+async function isAppLaunched() {
+  return await platformSpecific.isAppLaunched();
+}
+
 export default {
   getRegisteredScreen,
   registerComponent,
@@ -177,5 +181,6 @@ export default {
   startSingleScreenApp: startSingleScreenApp,
   setEventHandler: setEventHandler,
   clearEventHandler: clearEventHandler,
-  handleDeepLink: handleDeepLink
+  handleDeepLink: handleDeepLink,
+  isAppLaunched: isAppLaunched
 };

src/deprecated/indexDeprecated.android.js

@@ -1,8 +1,9 @@
 import Navigation from './../Navigation';
 import SharedElementTransition from './../views/sharedElementTransition';
+import NativeEventsReceiver from './../NativeEventsReceiver';
 
 module.exports = {
   Navigation,
-  SharedElementTransition
+  SharedElementTransition,
+  NativeEventsReceiver
 };
-

src/deprecated/indexDeprecated.ios.js

@@ -1,9 +1,11 @@
 import Navigation from './../Navigation';
 import {NavigationToolBarIOS} from './controllers';
 import SharedElementTransition from '../views/sharedElementTransition';
+import NativeEventsReceiver from './../NativeEventsReceiver';
 
 module.exports = {
   Navigation,
   NavigationToolBarIOS,
-  SharedElementTransition
+  SharedElementTransition,
+  NativeEventsReceiver
 };

src/deprecated/platformSpecificDeprecated.android.js

@@ -675,6 +675,10 @@ function dismissContextualMenu() {
   newPlatformSpecific.dismissContextualMenu();
 }
 
+async function isAppLaunched() {
+  return await newPlatformSpecific.isAppLaunched();
+}
+
 export default {
   startTabBasedApp,
   startSingleScreenApp,
@@ -704,5 +708,6 @@ export default {
   showSnackbar,
   dismissSnackbar,
   showContextualMenu,
-  dismissContextualMenu
+  dismissContextualMenu,
+  isAppLaunched
 };

src/platformSpecific.android.js

@@ -177,6 +177,10 @@ function setScreenStyle(screenInstanceId, style) {
   NativeReactModule.setScreenStyle(screenInstanceId, style);
 }
 
+async function isAppLaunched() {
+  return await NativeReactModule.isAppLaunched();
+}
+
 module.exports = {
   startApp,
   push,
@@ -210,5 +214,6 @@ module.exports = {
   dismissSnackbar,
   showContextualMenu,
   dismissContextualMenu,
-  setScreenStyle
+  setScreenStyle,
+  isAppLaunched
 };