NVDA插件更新器

  • 作者: Joseph Lee, Luke Davis
  • 下载 稳定版
  • NVDA compatibility: 2023.1-2024.2+
  • This is a would-be legacy add-on: NVDA 2023.2 includes add-on update check functionality through add-on store

此插件主要是NVDA Core issue 3208的概念证明,主要实现了:检查和更新插件的功能。

To check for updates after installing this add-on, go to NVDA menu/Tools/Check for add-on updates (if NVDA did notice updates, the menu item will say "Review add-on updates" followed by update count). If updates are available, a list of add-on updates will be shown, with each entry consisting of add-on name, current version, new version, and update channel. Select Update, and NVDA will download and apply updates in sequence, with a prompt to restart your NVDA shown afterwards.

以下插件提供内置更新功能,因此不会通过此插件检查更新:

  • Braille Extender
  • Tienda NVDA(西班牙 NVDA 社区商店)

重要提示:

  • Once the relevant feature is included in NVDA in the form of an add-on store with automatic updates and update notification, this add-on will be phased out. Currently, while the Add-on Store was introduced in NVDA 2023.2, and basic update notifications will be available in NVDA 2024.3, the full range of capabilities are not yet available.
  • This add-on requires Windows 10 Version 22H2 or later.
  • 此插件不适用于安全屏幕。如果您在安全屏幕中安装了插件,即使您将该插件复制到安全屏幕,插件更新功能也不会起作用。
  • 如果新版插件指定了兼容性范围(NVDA版本最低要求和最近测试的 NVDA 版本)且如果您运行的 NVDA 版本不在此兼容性范围内,则不会执行更新。
  • 并非所有插件都具有开发版。如果您在选择某一插件的开发版通道后没有收到更新,请切换到该插件的稳定版通道。
  • In the NVDA settings window, while editing the settings for Add-on Updater, you may notice that the title indicates that you are editing settings for a particular configuration profile (whatever profile you had active before entering settings). This does not matter. This add-on's settings are always global.
  • 在某些系统(特别是加入了公司域的计算机)上,插件更新功能可能无法正常工作,因此您必须手动下载更新。
  • Some features require NVDA to be installed on the computer.
  • 某些插件的最新版会包含用于检查插件包完整性的 SHA256 哈希值(插件商店上发布的所有插件都包含 SHA256 哈希值),如果哈希值不匹配,插件更新将失败。

插件设置

You can configure Add-on Updater settings from NVDA Settings screen (NVDA menu, Preferences, Settings) under Add-on Updater category. Add-on settings are as follow:

  • Automatically check for add-on updates: if checked, NVDA will check for add-on updates once every 12 hours. Automatic update checks are enabled by default on Windows client systems, and disabled by default on server systems.
  • Add-on update notification: you can choose to receive update notification as a dialog or a toast. On server systems or running a portable copy of NVDA, update notification will be shown as a dialog.
  • Update add-ons in the background (update notification is set to toast): if checked, Add-on Updater will apply updates in the background. A toast will appear informing you that add-on updates are being downloaded and installed, followed by another message announcing update results. Same limitations as add-on update notification setting and toast must be selected from the above option in order for background updates to work.
  • 不更新插件:您可以选择不希望更新的插件。
  • 首选开发版本:此列表中选中的任何插件都将接收开发(预发布)的版本更新。
  • 开发版发布通道(必须在“接收更新到开发板的插件”选项中选中相应插件):允许检查来自 Dev 或 Beta 通道的更新。
  • 插件更新源:您可以选择从何处获取更新。目前 NVDA 插件更新器支持从已下插件更新源获取更新。更改更新源后将显示确认消息。

可用的插件更新源:

  • NV Access 插件商店(默认)
  • NVDA 官方插件社区
  • 西班牙社区
  • NVDA 中文站和台湾社区

Version 24.2.4

  • Fix a bug related to the fix in version 24.2.1: that bug was not fully fixed in NVDA 2023.X, because the fix relied on a change made in NVDA 2024.1. This situation is now detected and patched (josephsl/addonUpdater#22).
  • The update interval has been changed to 12 hours.
  • The readme now makes note of the update notifications available natively in NVDA 2024.3.
  • The readme has been updated to comment on an unfixable, but harmless, bug in NVDA's settings panel (josephsl/addonUpdater#8).

Version 24.2.2

  • Lower update interval to six hours.

Version 24.2.1

  • Fixes a problem wherein Updater's updates, which appear in the external channel, were shown as still updatable in the store via the stable (or other) channel. Caused by residual JSON files from old non-external installations. Now they are removed.

Version 24.2.0

  • Release compatible with NVDA 2024.1.

Version 24.01.1

  • Short life-span release which removes the legacy status introduced in late

Version 23.10

  • Changed update notification message to mention NV Access add-on store if running NVDA 2023.2 or later and add-on update source is set to add-on store.

Version 23.09

  • Windows 10 Version 22H2 or later is required.

Version 23.08

This is the final version to support Windows 7, 8, 8.1, and 10 21H2 and earlier.

  • Add-on update results dialog or toast message will be shown once add-on store message is closed.
  • If add-on updates dialog is shown and then closed without installing add-ons, NVDA will no longer report no add-on updates when add-on updates are checked.
  • Add-on Updater will no longer present startup messages and perform update checks if updating a portable copy of NVDA.

版本23.07

  • 如果正在使用包含插件商店的 NVDA 版本,会显示一条信息,通知用户有关新插件商店的信息。这种情况下,不会显示插件更新结果对话框。插件更新器会继续工作。
  • 改进了从 NV Access 插件商店和官方插件社区更新源检查插件更新时的性能,特别是在没有可用插件更新时。

版本 23.06

  • 需要 NVDA 2023.1 或更高版本。
  • 将默认的插件更新源从社区插件网站更改为 NV Access 插件商店。

版本 23.05

  • 查看可用的插件更新时,将会显示插件更新频道。
  • 如果使用包含插件商店的 NVDA 版本,将会显示一条有关插件商店的消息。

版本 23.04

  • 添加了开发版更新通道设置,可以让用户在 Dev 和 Beta 更新通道之间进行选择。如果在“接收更新到开发板的插件”列表中选中相应插件,则会显示此选项。
  • 插件更新器中优先使用 NV Access 插件商店更新源。

版本 23.03

  • 由于某些更新源发生了更改,因此必须手动安装。
  • 添加了 NV Access 插件商店作为实验性插件更新源。

版本 23.02

  • 需要 NVDA 2022.4 或更高版本。
  • 在检查插件更新后,NVDA 不再为大多数插件提供旧版插件更新。这适用于版本号为 number.number 的插件。

版本 23.01

  • 如果更新源设置为“NVDA 官方插件社区”,NVDA 会检查插件的最低 Windows 版本。
  • 提高了批量下载插件的性能。因此,下载进度对话框中显示的插件下载顺序是随机的。
  • 插件的部分流程使用 Python 的 concurrent.futures 模块来提高性能,尤其是更新检查和下载过程。

版本 22.11

  • 需要 NVDA 2022.3 或更高版本。

版本 22.10

  • 添加 NVDA 中文站和台湾社区更新源(by Woody Tseng)。

版本 22.09

  • 需要 NVDA 2022.2 或更高版本。
  • 如果插件更新源包含插件包的哈希值,NVDA 将在下载插件更新时检查 SHA256 哈希值。如果哈希值无效,插件更新将失败。

版本 22.08

  • 重大的内部代码重组和重写。
  • 在 Windows 服务器系统上,默认情况下禁用自动插件更新检查功能(影响新安装)。
  • 增加了选择不同插件更新源的能力。NVDA 插件更新器可以检查托管在社区插件网站(addons.nvda-project.org)或西班牙社区插件目录(nvda.es)上的更新。在插件设置面板中添加了一个新的组合框,用于选择插件更新源。
  • 在 Windows 10 及更高版本上,如果运行安装版 NVDA 并且将插件更新通知方式设置为 toast,则可以让 NVDA 插件更新器在后台检查、下载和安装插件更新。
  • 重新设计了更新多个插件时的下载和安装体验,包括使用单个对话框显示所有插件的下载进度以及在下载所有插件后更新插件。
  • 如果 NVDA 设置为以 toast 方式显示更新通知,则当更新可用时,“检查插件更新”菜单项将变为“查看插件更新”,新名称中会包含可插件更新数。
  • 在 NVDA 2022.1 及更高版本中,NVDA 插件更新器可以处理此插件的命令行开关(目前没有)。
  • 在插件更新对话框中,默认情况下没有选中用户没有启用自动更新的插件,并且将显示一条确认消息,检查没有自动更新的插件并尝试更新它们,因为这样做会将没有自动更新的插件设为自动更新。

版本 22.07

  • 插件使用的 URL 现在是托管在新模块中的常量(由 Luke Davis 提供)。
  • 插件下载进度对话框现在位于屏幕中心。

版本 22.03

  • 当 NVDA 在安全模式下运行时,该插件不会加载以提高安全性。

版本 22.02

  • 需要 NVDA 2021.3 或更高版本。
  • 在 Windows 10 上插件更新 toast 通知已可以被本地化。

版本 22.01

  • 需要 NVDA 2021.2 或更高版本。
  • 在 Windows Server 2016 及更高版本的服务器系统上,插件更新将显示在一个对话框中,而不是使用toast 通知。

版本 21.10

  • 恢复某些环境下的插件检查更新功能,尤其是在新安装的 Windows 系统上。

版本 21.09

  • • 需要 NVDA 2021.1 或更高版本。
  • 在 Windows 10 及更高版本的系统上,插件更新通知可以选择 toast 消息和更新对话框两种方式,您可以在 NVDA 设置面板中的插件更新器类别下进行设置。
  • NVDA 插件更新器将不再检查插件的最低 Windows 版本信息,因为 Windows App Essentials 等插件可以提供更好的 Windows 兼容性信息。

版本 21.07

  • 在 Windows 10 及更高版本上,当有插件更新可用时,将以 toast 方式显示一条通知。请注意,您不能单击此通知——您必须打开 NVDA 菜单/工具/检查附加更新以查看更新。
  • 当启动时显示“旧版插件”对话框时,现在可以像插件更新一样查看旧版插件和原因。
  • 改进了插件更新的内部检查机制,包括使用社区提供的插件元数据收集来验证插件的兼容性。此外,这消除了为更新的插件检查有发行版插件更新的问题。

版本 21.05

  • 如果在使用 NVDA 2021.1 alpha 快照时尝试检查更新,NVDA 将不再播放错误提示音,这是由 wxPython GUI 工具包的更改引起的。

版本 21.03

  • 需要NVDA 2020.4 或更高版本。
  • 如果在检查插件更新时发生错误(例如 Internet 连接丢失),NVDA 将显示一个错误对话框。

版本 20.11

  • 需要 NVDA 2020.3 或更高版本。
  • 使用 Flake8 解决了许多编码样式问题和潜在错误。
  • 当 NVDA 从源代码运行且使用该插件时,NVDA 将不再播放错误提示音或显示为不执行任何操作。有关此事实的消息将改为记录在日志中。

版本20.07

  • 需要NVDA 2020.1或更高版本。
  • 如果安装了一个或多个旧版插件(如Screen Curtain),插件更新器现在会显示一条消息,要求您禁用或卸载列出的过时的插件。
  • 现在您可以分别按Control+NVDA+C、Control+NVDA+R一次或Control+NVDA+R三次来保存、重新加载或重置插件更新器的设置。

版本20.06

  • 使用 Flake8 解决了许多编码样式问题和潜在错误。

版本20.04

  • 在尝试通过插件更新器更新插件时,NVDA 将不再显示操作或播放错误提示。
  • 修复NVDA工具菜单中不存在“检查插件更新”菜单项的问题。

版本20.03

  • 需要NVDA 2019.3或更高版本。
  • 安装插件更新时,插件更新器将不再检查兼容性版本。 检查插件的兼容性现在有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 alpha快照的兼容性,其中包括无法下载插件更新的BUG。

版本18.12.1

  • 新增本地化支持。

版本18.12

  • 现在可以检查已禁用插件的更新。插件将在更新后保持禁用状态。
  • 在更新期间,如果插件需要特定的NVDA和/Windows,则会检查上数版本,如果其中一个不匹配,将显示错误提示并终止更新。
  • 启用自动更新检查并准备好更新后,NVDA将显示更新列表,而不是询问您是否要查看更新。

版本18.10

  • 初始发布稳定版(仍标记为概念证明)。