AppRegistry¶
Требуется проект с нативным кодом
Если вы используете управляемый рабочий процесс Expo, то только один входной компонент, зарегистрированный в AppRegistry
, и он обрабатывается автоматически (или через registerRootComponent). Вам не нужно использовать этот API.
AppRegistry
— это точка входа JS для запуска всех приложений React Native. Корневые компоненты приложения должны зарегистрировать себя с помощью AppRegistry.registerComponent
, после чего нативная система может загрузить пакет для приложения и затем фактически запустить приложение, когда оно будет готово, вызвав AppRegistry.runApplication
.
1 2 3 4 5 6 7 8 9 |
|
Чтобы "остановить" приложение, когда представление должно быть уничтожено, вызовите AppRegistry.unmountApplicationComponentAtRootTag
с тегом, который был передан в runApplication
. Их всегда следует использовать в паре.
AppRegistry
следует требовать в самом начале последовательности require
, чтобы убедиться, что среда выполнения JS настроена до того, как потребуются другие модули.
Методы¶
getAppKeys()¶
1 |
|
Возвращает массив строк.
getRegistry()¶
1 |
|
Возвращает объект Registry.
getRunnable()¶
1 |
|
Возвращает объект Runnable
.
Параметры:
Имя | Тип |
---|---|
appKey (обязательно) | string |
getSectionKeys()¶
1 |
|
Возвращает массив строк.
getSections()¶
1 |
|
Возвращает объект Runnables
.
registerCancellableHeadlessTask()¶
1 2 3 4 5 |
|
Зарегистрируйте безголовую задачу, которую можно отменить. Безголовая задача — это часть кода, которая выполняется без пользовательского интерфейса.
Параметры:
Имя | Тип | Описание |
---|---|---|
taskKey (обязательно) | string | Собственный идентификатор для данного экземпляра задачи, который использовался при вызове startHeadlessTask . |
taskProvider (обязательно) | TaskProvider | Функция возврата обещания, принимающая в качестве единственного аргумента некоторые данные, переданные с нативной стороны. Когда обещание разрешается или отклоняется, родная сторона получает уведомление об этом событии и может принять решение об уничтожении JS-контекста. |
taskCancelProvider (обязательно) | TaskCancelProvider | возвращающая пустоту функция, не принимающая аргументов; когда запрашивается отмена, функция, выполняемая taskProvider , должна сворачиваться и возвращаться как можно скорее. |
registerComponent()¶
1 2 3 4 5 |
|
Параметры:
Имя | Тип |
---|---|
appKey (обязательно) | string |
componentProvider (обязательно) | ComponentProvider |
section | boolean |
registerConfig()¶
1 |
|
Параметры:
Имя | Тип |
---|---|
config (обязательно) | AppConfig [] |
registerHeadlessTask()¶
1 2 3 4 |
|
Зарегистрируйте безголовое задание. Безголовая задача — это часть кода, которая выполняется без пользовательского интерфейса.
Это способ запуска задач на JavaScript, пока ваше приложение находится в фоновом режиме. Его можно использовать, например, для синхронизации свежих данных, обработки push-уведомлений или воспроизведения музыки.
Параметры:
Имя | Тип | Описание |
---|---|---|
taskKey (обязательно) | string | Собственный идентификатор для данного экземпляра задачи, который использовался при вызове startHeadlessTask . |
taskProvider (обязательно) | TaskProvider | Функция возврата обещания, принимающая в качестве единственного аргумента некоторые данные, переданные с нативной стороны. Когда обещание разрешается или отклоняется, родная сторона получает уведомление об этом событии и может принять решение об уничтожении JS-контекста. |
registerRunnable()¶
1 |
|
Параметры:
Имя | Тип |
---|---|
appKey (обязательно) | string |
run (обязательно) | function |
registerSection()¶
1 2 3 4 |
|
Параметры:
Имя | Тип |
---|---|
appKey (обязательно) | string |
component (обязательно) | ComponentProvider |
runApplication()¶
1 |
|
Загружает пакет JavaScript и запускает приложение.
Параметры:
Имя | Тип |
---|---|
appKey (обязательно) | string |
appParameters (обязательно) | any |
setComponentProviderInstrumentationHook()¶
1 2 3 |
|
Параметры:
Имя | Тип |
---|---|
hook (обязательно) | function |
Правильная функция hook
принимает в качестве аргументов следующее:
Имя | Тип |
---|---|
component (обязательно) | ComponentProvider |
scopedPerformanceLogger (обязательно) | IPerfo`rmanceLogger |
Функция также должна возвращать React Component.
setWrapperComponentProvider()¶
1 2 3 |
|
Параметры:
Имя | Тип |
---|---|
provider (обязательно) | ComponentProvider |
startHeadlessTask()¶
1 2 3 4 5 |
|
Вызывается только из нативного кода. Запускает задачу без головы.
Параметры:
Имя | Тип | Описание |
---|---|---|
taskId (обязательно) | number | Нативный идентификатор данного экземпляра задачи для отслеживания его выполнения. |
taskKey (обязательно) | string | Ключ для запуска задачи. |
data (обязательно) | any | Данные для передачи в задачу. |
unmountApplicationComponentAtRootTag()¶
1 |
|
Останавливает приложение, когда представление должно быть уничтожено.
Параметры:
Имя | Тип |
---|---|
rootTag (обязательно) | number |
Определения типов¶
AppConfig¶
Конфигурация приложения для метода registerConfig
.
Тип |
---|
object |
Параметры:
Имя | Тип |
---|---|
appKey (обязательно) | string |
component | ComponentProvider |
run | function |
section | boolean |
Ожидается, что в каждом конфиге будет установлена либо функция component
, либо run
.
Registry¶
Тип |
---|
object |
Параметры:
Имя | Тип |
---|---|
runnables | массив Runnables |
sections | массив строк |
Runnable¶
Тип |
---|
object |
Свойства:
Имя | Тип |
---|---|
component | ComponentProvider |
run | function |
Runnables¶
Объект с ключом appKey
и значением типа Runnable
.
Тип |
---|
object |
Task¶
Task
— это функция, которая принимает любые данные в качестве аргумента и возвращает Promise
, который разрешается в undefined
.
Тип |
---|
function |
TaskCanceller¶
Функция TaskCanceller
— это функция, которая не принимает никаких аргументов и возвращает void
.
Тип |
---|
function |
TaskCancelProvider¶
Правильный TaskCancelProvider
— это функция, которая возвращает TaskCanceller
.
Тип |
---|
function |
TaskProvider¶
Правильный TaskProvider
— это функция, которая возвращает Task
.
Тип |
---|
function |