Новая версия

Для обновления сохраните id плагина и увеличьте version по SemVer. Добавьте понятное описание изменений в changelog.

{
  "id": "dev.example.hello",
  "version": "1.1.0",
  "changelog": "Добавлена настройка приветствия"
}

Это фрагмент существующего манифеста. Соберите пакет заново и отправьте новый документ пользователю.

Совместимые настройки

Сохраняйте ключи, типы и смысл существующих данных. При чтении нового необязательного значения используйте разумный fallback. Не полагайтесь на автоматическую миграцию произвольных внутренних структур.

Возможности

Новые capabilities, scope и origins требуют нового рассмотрения пакета. Хост сравнивает digest конкретной просмотренной версии. Старое подтверждение не включает невидимые возможности нового файла.

Обновление останавливает старое выполнение. После установки новая версия включается выбранным явным действием; пользователь может оставить её выключенной.

Одинаковая версия

Изменённый файл с прежней версией не является корректным обновлением. Build-метаданные SemVer не увеличивают порядок версии. Для исправления 1.1.0 используйте, например, 1.1.1.

Смена профиля

Изменение localPrivate на publicNetwork или наоборот не проходит как обычное обновление. Нужны удаление установки вместе с её данными и новая установка.

Откат

Если хост сохранил предыдущую версию, в дополнительных параметрах доступен нативный откат. Не пытайтесь самостоятельно заменять установленный код или возвращать старые предоставленные возможности.