/** * Copyright (c) 2015-present, Facebook, Inc. * All rights reserved. * * This source code is licensed under the BSD-style license found in the * LICENSE file in the root directory of this source tree. An additional grant * of patent rights can be found in the PATENTS file in the same directory. * * @providesModule AppRegistry * @flow */ 'use strict'; var BatchedBridge = require('BatchedBridge'); var BugReporting = require('BugReporting'); var ReactNative = require('react/lib/ReactNative'); var invariant = require('fbjs/lib/invariant'); var renderApplication = require('renderApplication'); const infoLog = require('infoLog'); if (__DEV__) { // In order to use Cmd+P to record/dump perf data, we need to make sure // this module is available in the bundle require('RCTRenderingPerf'); } var runnables = {}; var runCount = 1; type ComponentProvider = () => ReactClass; type AppConfig = { appKey: string, component?: ComponentProvider, run?: Function, }; /** * `AppRegistry` is the JS entry point to running all React Native apps. App * root components should register themselves with * `AppRegistry.registerComponent`, then the native system can load the bundle * for the app and then actually run the app when it's ready by invoking * `AppRegistry.runApplication`. * * To "stop" an application when a view should be destroyed, call * `AppRegistry.unmountApplicationComponentAtRootTag` with the tag that was * pass into `runApplication`. These should always be used as a pair. * * `AppRegistry` should be `require`d early in the `require` sequence to make * sure the JS execution environment is setup before other modules are * `require`d. */ var AppRegistry = { registerConfig: function(config: Array) { for (var i = 0; i < config.length; ++i) { var appConfig = config[i]; if (appConfig.run) { AppRegistry.registerRunnable(appConfig.appKey, appConfig.run); } else { invariant(appConfig.component, 'No component provider passed in'); AppRegistry.registerComponent(appConfig.appKey, appConfig.component); } } }, registerComponent: function(appKey: string, getComponentFunc: ComponentProvider): string { runnables[appKey] = { run: (appParameters) => renderApplication(getComponentFunc(), appParameters.initialProps, appParameters.rootTag) }; return appKey; }, registerRunnable: function(appKey: string, func: Function): string { runnables[appKey] = {run: func}; return appKey; }, getAppKeys: function(): Array { return Object.keys(runnables); }, runApplication: function(appKey: string, appParameters: any): void { const msg = 'Running application "' + appKey + '" with appParams: ' + JSON.stringify(appParameters) + '. ' + '__DEV__ === ' + String(__DEV__) + ', development-level warning are ' + (__DEV__ ? 'ON' : 'OFF') + ', performance optimizations are ' + (__DEV__ ? 'OFF' : 'ON'); infoLog(msg); BugReporting.addSource('AppRegistry.runApplication' + runCount++, () => msg); invariant( runnables[appKey] && runnables[appKey].run, 'Application ' + appKey + ' has not been registered. This ' + 'is either due to a require() error during initialization ' + 'or failure to call AppRegistry.registerComponent.' ); runnables[appKey].run(appParameters); }, unmountApplicationComponentAtRootTag: function(rootTag : number) { ReactNative.unmountComponentAtNodeAndRemoveContainer(rootTag); }, }; BatchedBridge.registerCallableModule( 'AppRegistry', AppRegistry ); module.exports = AppRegistry;