Система плагинов
Плагины ReadAware компонуют возможности, которые предоставляет настольный хост. Они могут работать с книгами, состоянием чтения, аннотациями, разговорами и памятью; добавлять действия и провайдеров; и использовать ограниченные хост-сервисы.
Эта документация соответствует исходному коду разработки. Сопоставляйте требования к возможностям с установленным приложением перед сборкой или публикацией.
Выберите семейство возможностей
| Семейство | Используйте для | Примеры |
|---|---|---|
| Домены | Данные и поведение, принадлежащие ReadAware | Библиотека, чтение, аннотации, разговоры, настройки, память |
| Вклады | Новые действия, варианты выбора или реализации провайдеров | Команды, контекстные действия, голоса, источники контента, инструменты ассистента, темы |
| Сервисы | Операции хоста и частные механизмы плагина | Ресурсы, сеть, инференс, хранилище, расписания, задания, транзакции |
| Схемы | Данные, которые хост отображает или интерпретирует | Представления, формы настроек, темы |
Используйте Проводник возможностей для поиска фактических методов, понимания границ и создания манифеста. Справочник API объясняет, как семейства компонуются.
Начните с задачи читателя
- Поиск и навигация: используйте поиск по источникам библиотеки и чтение диапазонов, затем навигацию по чтению с защитой текущей сессии.
- Сбор и просмотр заметок: запрашивайте или наблюдайте за аннотациями; условные изменения сохраняют более новые правки.
- Работа с памятью чтения: используйте запросы памяти и авторизованные команды для воспоминаний, классификации, профилей, сущностей, графов и контекстных пакетов.
- Помощь в разговоре: читайте авторизованные стенограммы и резюме, предлагайте ход разговора для одобрения хостом или регистрируйте инструмент ассистента.
- Автоматизация рабочего процесса: комбинируйте расписания, ограниченные курсоры изменений, поддерживаемые долговечные задания и локальные транзакции.
- Привлечение внешнего контента: используйте сетевой доступ с ограничением по источнику, провайдеров контента и защищенные ресурсы вместо обходных путей через файловую систему или браузер.
Разрешения, версии и гранты на объекты
Это отдельные проверки:
requiresобъявляет совместимые версии возможностей.permissions,settingsAccessиnetworkAccessобъявляют полномочия.- Грант на книгу пользователя ограничивает исполнителя всеми книгами, текущей книгой или указанной книгой.
- Жизненный цикл и текущие условия выполнения определяют, доступна ли конкретная операция сейчас.
Сервис, свободный от разрешений, все равно может требовать другой доменный грант для конкретного метода. Успешный запрос доступности — это подсказка, а не разрешение обойти проверку выполнения.
Интерфейсы, отображаемые хостом
Плагины возвращают структурированные представления и обратные вызовы. ReadAware владеет отрисовкой, фокусом, навигацией, состояниями загрузки и ошибок, темами и очисткой. Представления могут включать списки, формы, макеты деталей и ограниченные блоки, с живыми обновлениями через публичный контракт представлений.
Плагины не монтируют React, произвольный HTML, CSS, iframes или DOM. Используйте поддерживаемую точку вклада для нового поведения интерфейса.
Изоляция и жизненный цикл
Каждый плагин работает в модульном воркере. Он не получает прямого доступа к Tauri, SQLite, файловой системе, процессу или DOM. Сеть и хранилище используют контекст, опосредованный хостом.
Этапы активации регистрируют и разрешают поддерживаемые чтения; бизнес-записи и внешние побочные эффекты начинаются с активных обработчиков. Миграция частных данных выполняется с полномочиями только на хранилище. Неудачная активация или миграция откатывается до того, как кандидат заменит текущую среду выполнения.
Плагины из каталога плагинов обновляются автоматически, если новый выпуск не запрашивает больше прав, чем одобрил пользователь, — разрешения, доступ к настройкам и сетевые источники; всё остальное ждёт согласия. Плагины, установленные из папки или zip, никогда не заменяются версией из каталога плагинов.
Установка по-прежнему является решением о доверии к программному обеспечению. Проверьте исходный код пакета, запрошенные полномочия, сетевые назначения и обработку данных.
Учитесь на примере плагинов первой стороны
Дерево исходного кода содержит рабочие примеры, такие как Dictionary, RSS Reader и Sentence Reader, наряду с встроенными плагинами. Примеры из исходников не являются обещанием, что каждый пакет поставляется в каждом релизе.