AddonUpdater (Обновление дополнений)

• Автор: Джозеф Ли, Люк Дэвис
• Скачать стабильную версию
• Совместимость с NVDA: 2023.1-2024.4.2.
• Это потенциально устаревшее дополнение: Начиная с NVDA 2023.2 включена функция проверки обновлений дополнений через магазин дополнений.
• С апреля 2025 года поддержка дополнения официально прекращена.

В этом дополнении реализована проблема 3208 NVDA Core: возможность проверки, загрузки и применения обновлений дополнений.

Чтобы проверить наличие обновлений после установки этого дополнения, перейдите в меню NVDA/Сервис/Проверьте наличие обновлений надстроек (если NVDA заметила обновления, то в пункте меню будет написано "Просмотреть обновление дополнений", после чего будет указано количество обновлений). Если обновления доступны, будет показан список обновлений дополнений, каждая запись которого состоит из названия дополнения, текущей версии, новой версии и канала обновления. Выберите Update, и NVDA загрузит и применит обновления в последовательности, после чего будет показан запрос на перезапуск NVDA.

Следующие дополнения имеют встроенную функцию обновления, поэтому проверка обновлений с помощью этого дополнения не производится:

• Braille Extender
• Tienda NVDA (испанский магазин сообщества NVDA)

ВАЖНЫЕ ЗАМЕЧАНИЯ:

• Как только соответствующая функция будет включена в NVDA в виде магазина дополнений с автоматическим обновлением и уведомлением об обновлениях, это дополнение будет постепенно отменено. В настоящее время магазин дополнений (NVDA 2023.2) и базовые уведомления об обновлениях (NVDA 2024.3) доступны, но полный спектр возможностей, включая автоматическое обновление дополнений и сопутствующие уведомления, стал частью только в NVDA 2025.1.
• Для работы этого дополнения требуется Windows 10 версии 22H2 или более поздней.
• Данное дополнение не предназначено для использования в защищенных экранах. Если в защищенном экране установлены дополнения, то даже если скопировать Add-on Updater в режим защищенного экрана, Add-on Updater работать не будет.
• Если в новых обновлениях дополнений указан диапазон совместимости (минимальная и последняя протестированные версии NVDA), а используемая вами версия NVDA не входит в диапазон совместимости согласно NVDA, обновление дополнений не будет выполнено.
• Не все дополнения поставляются с релизами разработки. Если вы не получаете обновления после установки девелоперских версий дополнений, переключитесь на стабильный канал для соответствующих дополнений.
• В окне настроек NVDA при редактировании настроек для Add-on Updater вы можете заметить, что заголовок указывает на редактирование настроек для определенного профиля конфигурации (профиль, который был активен до ввода настроек). Это не имеет значения. Настройки этого дополнения всегда глобальны.
• На некоторых системах (в частности, на компьютерах, подключенных к корпоративному домену) функция проверки обновлений дополнений может работать некорректно, поэтому обновления дополнений необходимо загружать вручную.
• Некоторые функции требуют установки NVDA на компьютер.
• Некоторые версии дополнений включают хэш-значения SHA256 для проверки целостности пакета дополнений (все дополнения, опубликованные в магазине дополнений, содержат значения SHA256), и если хэш-значение не совпадает, обновление дополнения не произойдет.

Настройки обновления дополнений

Настройки Add-on Updater можно задать в экране настроек NVDA (меню NVDA, Параметры, Настройки) в категории Обновление дополнений. Настройки дополнений выглядят следующим образом:

• Автоматически проверять обновления дополнений: если флажок установлен, NVDA будет проверять обновления дополнений раз в день. Автоматическая проверка обновлений включена на клиентских системах Windows и отключена на серверных системах.
• Уведомление об обновлении дополнений: вы можете выбрать способ получения уведомления об обновлении - в виде диалогового окна или речевоо сообщения. На серверных системах или при использовании портативной копии NVDA уведомление об обновлении будет отображаться в виде диалога.
• Обновление дополнений в фоновом режиме (уведомление об обновлении установлено в виде уведомления ): если флажок установлен, то Add-on Updater будет применять обновления в фоновом режиме. Появится уведомление, информирующие о загрузке и установке обновлений, а затем еще одно сообщение, сообщающее о результатах обновления. Ограничения те же, что и при настройке уведомления об обновлении дополнений, и для работы фоновых обновлений необходимо выбрать речевое сообщение из вышеуказанной опции.
• Не обновлять дополнения: вы можете выбрать дополнения, которые не должны обновляться.
• Предпочитать релизы разработки: все дополнения, отмеченные в этом списке, будут получать релизы разработки (пререлизы).
• Канал релизов разработки (выбранное дополнение должно быть отмечено в списке предпочитаемых релизов разработки): позволяет выбрать обновления разработки, поступающие по каналу dev или beta.
• Источник обновлений дополнения: можно выбрать, откуда получать обновления. В настоящее время Add-on Updater поддерживает загрузку обновлений из перечисленных ниже источников. После смены источника обновления будет показано подтверждающее сообщение.

Доступными источниками обновлений дополнений являются:

• Магазин дополнений NV Access (по умолчанию)
• Каталог дополнений испанского сообщества
• Каталоги, поддерживаемые сообществами NVDA в Китае и Тайване

Перевод

• Валентин Куприянов: Русский язык
• Продолжил поддержку перевода, а также перевёл справку.

Журнал версий

Версия 25.04

Обновление от 15 апреля 2025 года.

Привет всем, Обновление дополнения Add-on Updater версии 25.04 теперь доступно. Это финальное обновление дополнения — с введением автоматического обновления дополнений в NVDA 2025.1, поддержка Add-on Updater прекращается. Спасибо за вашу поддержку.

Версия 25.1

• Удален сайт comunity add-ons в качестве источника обновления дополнений.

Версия 24.3/24.08

• При запуске NVDA Add-on Updater не будет отображать диалоговое окно обновлений, если используется NVDA 2024.3 или новее, а в настройках магазина дополнений NVDA для уведомлений об обновлениях установлено значение «уведомлять».

Версия 24.2.4

• Исправление ошибки, связанной с исправлением в версии 24.2.1: эта ошибка не была полностью исправлена в NVDA 2023.X, поскольку исправление опиралось на изменение, внесенное в NVDA 2024.1. Теперь эта ситуация обнаружена и исправлена (josephsl/addonUpdater#22).
• Интервал обновления был изменен на 12 часов.
• В readme добавлено уведомление об обновлении, доступное в NVDA 2024.3.
• В readme добавлены комментарии о неисправимой, но безвредной ошибке в панели настроек NVDA (josephsl/addonUpdater#8).

Версия 24.2.2

• Уменьшен интервал обновления до 6 часов.

24.2.1

• Устранена проблема, при которой обновления Updater, появляющиеся во внешнем канале, отображались как все еще обновляемые в магазине через стабильный (или другой) канал. Причиной были остатки JSON-файлов от старых не внешних установок. Теперь они удалены.

Версия 24.2.0

• Релиз, совместимый с NVDA 2024.1.

Версия 24.01.1

• Выпуск с коротким периодом жизни, который удаляет устаревший статус, введенный в конце 2023 года.

Версия 23.12

Всем привет, После более чем пяти лет разработка Add-on Updater завершилась (по крайней мере, со слов Джозефа Ли) с выходом версии 23.12. Несмотря на то, что разработка дополнения завершена (официально), Люк Дэвис будет продолжать поддерживать его до тех пор, пока в NVDA не появятся такие функции, как уведомление об обновлении дополнения. Спасибо за поддержку и пожелания на протяжении последних пяти лет.

Версия 23.10

• Изменено сообщение об обновлении, в котором упоминается магазин дополнений NV Access, если используется NVDA 2023.2 или более поздняя версия, а источником обновления дополнений является магазин дополнений.

Версия 23.09

• Требуется Windows 10 версии 22H2 или более поздней.

Версия 23.08

Это финальная версия для поддержки Windows 7, 8, 8.1 и 10 21H2 и более ранних версий.

• После закрытия магазина дополнений будет показан диалог результатов обновления дополнений или тостовое сообщение.
• Если диалог обновления дополнений был показан, а затем закрыт без установки дополнений, NVDA больше не будет сообщать об отсутствии обновлений дополнений при проверке обновлений дополнений.
• При обновлении портативной копии NVDA программа Add-on Updater больше не будет выдавать сообщения о запуске и выполнять проверку обновлений.

Версия 23.07

• Если используется релиз NVDA с включенным магазином дополнений, то при запуске будет показано сообщение, информирующее пользователей о новом магазине дополнений. В этом случае диалог результатов обновления дополнений не будет показан. Add-on Updater будет продолжать работать.
• Улучшена производительность при проверке обновлений дополнений из магазина дополнений NV Access и источников обновлений сайта сообщества дополнений, особенно в случае отсутствия обновлений.

Версия 23.06

• Требуется NVDA 2023.1 или более поздняя версия.
• Изменен источник обновления дополнений по умолчанию с сайта сообщества дополнений на магазин дополнений NV Access.

Версия 23.05

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

Версия 23.04

• Добавлена настройка канала обновления разработки, позволяющая пользователям разрабатываемых дополнений выбирать между каналами обновления dev и beta. Эта опция отображается, если выбранное дополнение из списка релизов разработки отмечено галочкой.
• Магазин дополнений NV Access широко доступен в качестве источника обновлений из Add-on Updater.

Версия 23.03

• В связи с изменениями, внесенными в веб-сайт, используемый некоторыми источниками обновлений, установка должна производиться вручную.
• Добавлен магазин дополнений NV Access в качестве экспериментального источника обновлений.

Версия 23.02

• Требуется NVDA 2022.4 или более поздняя версия.
• NVDA больше не будет предлагать старые обновления для большинства дополнений после проверки на наличие обновлений. Это относится к дополнениям с текстом версии вида number.number.

Версия 23.01

• NVDA будет проверять минимальную версию Windows для обновлений дополнений, если источником обновлений является сайт NVDA community add-ons.
• Улучшена производительность при одновременной загрузке большого количества обновлений. В результате порядок загрузки дополнений, отображаемый в диалоге прогресса загрузки, будет случайным.
• Части дополнения теперь используют модуль Python concurrent.futures для повышения производительности, в частности, процессы проверки и загрузки обновлений.

Версия 22.11

• Требуется NVDA 2022.3 или более поздняя версия.

Версия 22.10

• Добавлены каталоги сообществ NVDA в Китае и Тайване в качестве источников обновлений дополнения (автор Woody Tseng).

Версия 22.09

• Требуется NVDA 2022.2 или более поздняя версия.
• NVDA будет проверять хэш-значения SHA256 при загрузке обновлений дополнений, если источник обновлений содержит хэш-значения для пакетов дополнений. Если хэш-значение недействительно, обновление дополнений завершится неудачей.

Версия 22.08

• Значительная реорганизация и переписывание внутреннего кода.
• В системах Windows Server функция автоматической проверки обновлений дополнений отключена по умолчанию (влияет на новые установки).
• Добавлена возможность выбора различных источников обновлений дополнений. Add-on Updater может проверять обновления, размещенные на сайте сообщества дополнений (addons.nvda-project.org) или в каталоге испанского сообщества дополнений (nvda.es). В панель настроек дополнений добавлено новое комбинированное поле для выбора источника обновления дополнений.
• В операционной системе Windows 10 и более поздних версиях можно разрешить программе Add-on Updater проверять, загружать и устанавливать обновления в фоновом режиме при условии, что NVDA действительно установлена и уведомление об обновлениях настроено на тост.
• Переработан процесс загрузки и установки обновлений для нескольких дополнений, включая использование единого диалога для отображения прогресса загрузки всех дополнений и обновление дополнений после загрузки всех из них.
• Если в NVDA настроено оповещение об обновлениях в виде тостов, то при появлении обновлений пункт меню "проверить обновления дополнений" превращается в "просмотреть обновления дополнений", причем новое название включает в себя количество обновлений дополнений.
• В NVDA 2022.1 и более поздних версиях Add-on Updater может обрабатывать переключатели командной строки для этого дополнения (в настоящее время их нет).
• В диалоге обновления дополнений отключенные пользователем дополнения по умолчанию не отмечаются, а при проверке отключенных дополнений и попытке их обновления будет показано подтверждающее сообщение, так как это приведет к их включению.

Версия 22.07

• URL, используемые дополнением, теперь являются константами, размещенными в новом модуле (автор - Люк Дэвис).
• Диалог загрузки дополнения теперь располагается по центру экрана.

Версия 22.03

• Улучшена безопасность: дополнение не загружается, если NVDA работает в безопасном режиме.

Версия 22.02

• Требуется NVDA 2021.3 или более поздняя версия.
• В Windows 10 локализованы тостовые уведомления об обновлении дополнения.

Версия 22.01

• Требуется NVDA 2021.2 или более поздняя версия.
• На серверных системах под управлением Windows Server 2016 и более поздних версий обновления дополнений будут отображаться в диалоговом окне вместо тостовых уведомлений.

Версия 21.10

• На некоторых системах, в частности после чистой установки Windows, снова можно проверить наличие обновлений дополнений.

Версия 21.09

• Требуется NVDA 2021.1 или более поздняя версия.
• В Windows 10 и более поздних версиях можно выбирать между уведомлением об обновлении дополнений в виде тоста и диалоговым окном обновления. Это можно настроить в настройках Add-on Updater, расположенных на экране настроек NVDA.
• Add-on Updater больше не будет проверять минимальную информацию о выпуске Windows для дополнений, поскольку такие дополнения, как Windows App Essentials, предоставляют более полную информацию о совместимости с Windows.

Версия 21.07

• В Windows 10 и более поздних версиях при появлении обновлений дополнений будет отображаться уведомление в виде тоста. Обратите внимание, что на это уведомление нельзя нажать - для просмотра обновлений необходимо открыть меню NVDA/Инструменты/Проверить обновления дополнений.
• Когда при запуске отображается диалог старых дополнений, теперь можно просмотреть старые дополнения и причины их появления, как и при обновлении дополнений.
• Улучшена внутренняя проверка обновлений дополнений, включая использование коллекции метаданных дополнений, предоставляемых сообществом, для проверки совместимости дополнений. Кроме всего прочего, это позволяет отказаться от выпуска дополнений для добавления проверок обновлений для новых дополнений.

Версия 21.05

• NVDA больше не будет воспроизводить звуки ошибок при попытке проверки обновлений при использовании альфа-снимков NVDA 2021.1, что связано с изменениями в инструментарии графического интерфейса wxPython.

Версия 21.03

• Требуется NVDA 2020.4 или более поздняя версия.
• При возникновении ошибок при проверке обновлений дополнений, таких как потеря соединения с Интернетом, NVDA выдает диалог об ошибке.

Версия 20.11

• Требуется NVDA 2020.3 или более поздняя версия.
• Решено больше проблем со стилем кодирования и потенциальных ошибок с Flake8.
• NVDA больше не будет воспроизводить звуковые сигналы ошибок или казаться бездействующей при использовании дополнения, когда NVDA запущена из исходного кода. Вместо этого в журнал будет записываться сообщение об этом факте.

Версия 20.07

• Требуется NVDA 2020.1 или более поздняя версия.
• Если установлено одно или несколько устаревших дополнений (например, Screen Curtain), то Add-on Updater выдаст сообщение с предложением отключить или удалить перечисленные дополнения.
• Сохранить, перезагрузить или сбросить настройки Add-on Updater теперь можно, нажав Control+NVDA+C, Control+NVDA+R один раз или Control+NVDA+R три раза соответственно.

Версия 20.06

• Решено множество проблем со стилем кодирования и потенциальных ошибок с Flake8.

Версия 20.04

• При попытке обновить дополнения через Add-on Updater NVDA больше не будет показывать, что ничего не делает, или воспроизводить звуки ошибок.
• Решена проблема, при которой пункт "Проверить наличие обновлений дополнений" отсутствовал в меню NVDA Tools.

Версия 20.03

• Требуется NVDA 2019.3 или более поздняя версия.
• При установке обновлений дополнений программа Add-on Updater больше не будет проверять диапазон совместимости. NVDA сама будет проверять совместимость дополнений.

Версия 19.11

• Когда доступны обновления дополнений, NVDA сообщает, сколько обновлений доступно.

Версия 19.09

• Требуется NVDA 2019.2 или более поздняя версия.
• Устранена ошибка таймаута при попытке загрузить некоторые обновления дополнений (в частности, файлы дополнений, размещенные на GitHub).

Версия 19.04

• Требуется NVDA 2019.1 или более поздняя версия.
• При установке обновлений дополнений проверяются минимальная и последняя проверенные версии.

Версия 19.01

• Требуется NVDA 2018.4 или более поздняя версия.
• Улучшена отзывчивость при проверке обновлений дополнения.
• Повышена совместимость дополнения с Python 3.

Версия 18.12.2

• Готовность к Python 3.
• Исправлена совместимость с последними альфа-снимками NVDA, когда обновления дополнения не загружались.

Версия 18.12.1

• Добавлены локализации.

Версия 18.12

• Обновления для отключенных дополнений могут быть проверены. После обновления они останутся отключенными.
• Во время обновления, если дополнение требует определенной версии NVDA и/или релиза Windows, они будут проверяться, и если одна из них не совпадает, то будет выдано сообщение об ошибке и обновление будет прервано, в результате чего версия уже установленного дополнения не изменится.
• Когда включена автоматическая проверка обновлений и когда обновления готовы, NVDA будет показывать список обновлений, а не спрашивать, хотите ли вы просмотреть обновления.

Версия 18.10

• Первоначальный стабильный релиз (все еще помеченный как proof of concept).