NVDA插件更新器

作者: Joseph Lee, Luke Davis
下载稳定版
NVDA 兼容性：2022.2 及更高版本

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

要在安装NVDA 插件更新器后检查已安装插件的更新，请转到 NVDA 菜单/工具/检查插件更新（如果 NVDA 检测到有更新，菜单项将显示“查看插件更新”，后紧跟可更新数量）。如果有可用更新，将显示可更新插件列表，每个条目由描述、当前版本和新版本组成。选择更新，NVDA 将按顺序下载并安装更新，随后会显示重启 NVDA 的提示。

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

Braille Extender
Tienda NVDA（西班牙 NVDA 社区商店）
WeatherPlus

重要提示:

这是一个概念性证明插件。一旦相关功能包含在 NVDA 中，此插件将停止维护。
此插件不适用于安全屏幕。如果您在安全屏幕中安装了插件，即使您将该插件复制到安全屏幕，插件更新功能也不会起作用。
如果新版插件指定了兼容性范围（NVDA版本最低要求和最近测试的 NVDA 版本）且如果您运行的 NVDA 版本不在此兼容性范围内，则不会执行更新。
并非所有插件都具有开发版。如果您在选择某一插件的开发版通道后没有收到更新，请切换到该插件的稳定版通道。
在某些系统（特别是加入了公司域的计算机）上，插件更新功能可能无法正常工作，因此您必须手动下载更新。
某些功能需要将 NVDA 安装在计算机上，最好是安装在运行 Windows 10 或更高版本的计算机上。
某些插件最新版会包含用于检查插件包完整性的 SHA256 哈希值，如果哈希值不匹配，插件更新将失败。

插件设置

您可以在 NVDA 设置面板（NVDA 菜单，选项，设置）的 NVDA 插件更新器类别下对 NVDA 插件更新器进行设置。插件设置说明如下：

自动检查插件更新：如果选中，NVDA 将每天检查一次更新。自动检查更新在 Windows 客户端系统上启用，在服务器系统上禁用。
插件更新通知（Windows 10 及更高版本）：您可以选择是以对话框方式，还是以 toast 方式接收更新通知。在早于 10 的 Windows 版本和服务器系统上，或运行 NVDA 便携版，更新通知将以对话框方式显示。
在后台更新插件（需在Windows 10 及更高版本上，并且将更新通知方式设置为 toast）：如果选中，NVDA 插件更新程序将在后台运行更新。会以 toast方式通知您正在下载和安装插件更新，然后是另一条消息，通知您更新结果。必须将插件更新通知设置为 toast 方式，以便后台更新能正常工作。
不更新插件：您可以选择不希望更新的插件。
首选开发版本：此列表中选中的任何插件都将接收开发（预发布）的版本更新。
插件更新源：您可以选择从何处获取更新。目前 NVDA 插件更新器支持从社区插件网站和西班牙社区插件目录下载更新。更改更新源后将显示确认对话框。

版本 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

初始发布稳定版（仍标记为概念证明）。