appregistry.md

id	title
appregistry	AppRegistry

Project with Native Code Required

This API only works in projects made with react-native init or in those made with expo init or Create React Native App which have since ejected. For more information about ejecting, please see the guide on the Create React Native App repository.

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 passed into runApplication. These should always be used as a pair.

AppRegistry should be required early in the require sequence to make sure the JS execution environment is setup before other modules are required.

Methods

• setWrapperComponentProvider
• registerConfig
• registerComponent
• registerRunnable
• registerSection
• getAppKeys
• getSectionKeys
• getSections
• getRunnable
• getRegistry
• setComponentProviderInstrumentationHook
• runApplication
• unmountApplicationComponentAtRootTag
• registerHeadlessTask
• registerCancellableHeadlessTask
• startHeadlessTask
• cancelHeadlessTask

---

Reference

Methods

setWrapperComponentProvider()

static setWrapperComponentProvider(provider)

---

registerConfig()

static registerConfig(config)

---

registerComponent()

static registerComponent(appKey, componentProvider, section?)

---

registerRunnable()

static registerRunnable(appKey, run)

---

registerSection()

static registerSection(appKey, component)

---

getAppKeys()

static getAppKeys()

---

getSectionKeys()

static getSectionKeys()

---

getSections()

static getSections()

---

getRunnable()

static getRunnable(appKey)

---

getRegistry()

static getRegistry()

---

setComponentProviderInstrumentationHook()

static setComponentProviderInstrumentationHook(hook)

---

runApplication()

static runApplication(appKey, appParameters)

---

unmountApplicationComponentAtRootTag()

static unmountApplicationComponentAtRootTag(rootTag)

---

registerHeadlessTask()

static registerHeadlessTask(taskKey, taskProvider)

Register a headless task. A headless task is a bit of code that runs without a UI. @param taskKey the key associated with this task @param taskProvider a promise returning function that takes some data passed from the native side as the only argument; when the promise is resolved or rejected the native side is notified of this event and it may decide to destroy the JS context.

---

registerCancellableHeadlessTask()

static registerCancellableHeadlessTask(taskKey, taskProvider, taskCancelProvider)

Register a headless task which can be cancelled. A headless task is a bit of code that runs without a UI. @param taskKey the key associated with this task @param taskProvider a promise returning function that takes some data passed from the native side as the only argument; when the promise is resolved or rejected the native side is notified of this event and it may decide to destroy the JS context. @param taskCancelProvider a void returning function that takes no arguments; when a cancellation is requested, the function being executed by taskProvider should wrap up and return ASAP.

startHeadlessTask()

static startHeadlessTask(taskId, taskKey, data)

Only called from native code. Starts a headless task.

@param taskId the native id for this task instance to keep track of its execution @param taskKey the key for the task to start @param data the data to pass to the task

---

cancelHeadlessTask()

static cancelHeadlessTask(taskId, taskKey)

Only called from native code. Cancels a headless task.

@param taskId the native id for this task instance that was used when startHeadlessTask was called @param taskKey the key for the task that was used when startHeadlessTask was called