114 lines
3.6 KiB
JavaScript
114 lines
3.6 KiB
JavaScript
/**
|
|
* 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('ReactNative');
|
|
|
|
var invariant = require('fbjs/lib/invariant');
|
|
var renderApplication = require('renderApplication');
|
|
|
|
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<any>;
|
|
|
|
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<AppConfig>) {
|
|
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<string> {
|
|
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');
|
|
console.log(msg);
|
|
BugReporting.init();
|
|
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;
|