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 |