Публикация плагина

Публичный репозиторий плагинов содержит пакеты маркетплейса и принимает изменения через pull request. При подготовке заявки используйте его текущие инструкции по участию и валидатор.

Соответствие поддерживаемому приложению

Каталог разработки может опережать последнюю выпущенную версию приложения. Проверяйте публичные декларации и целевое приложение вместе. Пакет, которому требуется новая возможность, должен дождаться совместимого релиза хоста или явно нацеливаться на соответствующий сборочный вариант для разработки; изменение только minAppVersion не создает отсутствующий API.

Используйте Обозреватель возможностей, чтобы проверить методы и версии, затем укажите наименьший совместимый набор, который вы действительно протестировали.

Сделайте пакет проверяемым

Зафиксируйте manifest.json, читаемый исходный код, собранный автономный main.js и необходимые ресурсы выполнения. Имя папки должно совпадать с ID в манифесте. Не загружайте удаленный исполняемый код и не зависите от файлов вне пакета.

tree

plugins/my-plugin/
  manifest.json
  main.js
  package.json
  tsconfig.json
  src/main.ts
  assets/

Проверьте поведение и полномочия

Объясните функцию, ее точки входа и почему требуется каждое разрешение.
Укажите точные разрешения Settings и необходимые сетевые источники. Объясните, какие данные отправляются внешним сервисам.
Протестируйте область книги, отсутствующие разрешения, отмену, отключение/повторное включение и фактический пользовательский интерфейс настольного приложения.
Держите активацию декларативной, а миграции — только для хранения.
Проверьте хранение приватных данных, квоты и очистку активных ресурсов.
Для обновлений протестируйте существующую установку с реалистичными данными, включая неудачную миграцию и восстановление.

Предварительный просмотр локального манифеста помогает выявить ошибки совместимости и полномочий. Он не заменяет валидатор репозитория, тестирование на настольном приложении или проверку.

Сборка и отправка

Следуйте скриптам в репозитории. Проверки пакета в публичном репозитории:

bash

bun run build
bun run typecheck
bun test
bun run validate

Добавьте соответствующую запись в реестр в соответствии с текущей схемой и порядком репозитория. Откройте pull request с описанием конечного поведения, протестированных версий приложения и возможностей, приватных данных, внешних сервисов и изменений разрешений. Включите воспроизводимые шаги проверки.

Обновления

Увеличьте версию пакета в манифесте и реестре. Изменяйте schemaVersion только при изменении схемы приватных данных, с миграцией в том же пакете. Запрос на расширение полномочий требует четкого объяснения и рабочего пути отказа.

Подпись, идентичность издателя, целостность пакета, происхождение проверки и отзыв — это отдельные вопросы распространения. Укажите контрольные меры, которые фактически применяются к пакету; изоляция Worker сама по себе не является гарантией от произвольного кода.

Создать плагин · Справочник API