Каталог стандартных плагинов
Зоны ответственности официальных плагинов и приоритет их появления. Справочник API MVP: README.md (методы, типы, коды ошибок).
Стандартные плагины — официальные, поддерживаемые core-командой. Они задают эталон качества (манифест, типы, документация, conformance-тесты) для сторонних плагинов.
1. Приоритеты по этапам
| Приоритет | Плагины | Этап |
|---|---|---|
| MVP (MUST) | Device, Storage, FileSystem, Clipboard, Network | MVP ✅ |
| Расширение (SHOULD) | Camera, Geolocation, Notifications (local), Share, Sensors | Alpha ✅ |
| Дополнительно (COULD) | Contacts, Biometric, Secure Storage, Push, Background Tasks, Haptics, App/Browser | пост-1.0 |
2. Плагины MVP
Device
- Назначение: информация об устройстве/приложении.
- Reference: device.md
Storage (key-value)
- Назначение: простое постоянное хранилище ключ-значение.
- Reference: storage.md
FileSystem
- Назначение: работа с файлами в области данных приложения (scope
appData). - Reference: filesystem.md
Clipboard
- Назначение: буфер обмена (текст).
- Reference: clipboard.md
Network
- Назначение: состояние сети, событие
network:change. - Разрешения:
Internet - Reference: network.md
Echo (conformance)
- Назначение: stub для тестирования моста (invoke, ошибки, стрим).
- Reference: echo.md
3. Плагины расширения (Alpha)
Реализованы и доступны в npm; на части сценариев sign-off на физическом устройстве ещё в процессе (см. заметки в reference и examples/*-demo).
Camera
- Съёмка фото/видео, выбор из галереи. Возвращает URL ресурса через Asset Loader (не байты в JSON).
- Разрешения:
Camera - Reference: camera.md
Geolocation
- Текущая позиция и стрим наблюдения (
watch), остановка. - Разрешения:
Location - Reference: geolocation.md
Notifications (local)
- Локальные уведомления: создать/отменить/расписание; события нажатия.
- Разрешения:
Notifications - Reference: notifications.md
Share
- Системный шаринг текста/файлов/URL.
- Reference: share.md
Sensors
- Акселерометр/гироскоп и пр. как стримы с backpressure/прореживанием.
- Reference: sensors.md
4. Дополнительные плагины (COULD)
Contacts, Biometric, Secure Storage, Push Notifications, Background Tasks, Haptics (вибро), App (события/состояние приложения), Browser (внешний браузер/in-app). Появляются по мере спроса сообщества; сторонние реализации поощряются.
5. Общие требования к стандартному плагину
- Полный манифест (методы/события/типы/errors/разрешения/совместимость/nativeDeps).
- Сгенерированные JS-обёртка и типы.
- Документация и хотя бы один пример.
- Прохождение conformance suite (FR-T1).
- Корректная обработка недоступности на устройстве/версии (
*_UNAVAILABLE) и отказа разрешений.
6. Связи
- README.md — справочник API стандартных плагинов.
- plugin-api.md — контракт плагина.
- requirements.md — приоритеты FR-P5/P6/P8.
- roadmap.md — когда какой плагин появляется.