NVDA Community Addons/ addons/ Add-on Updater  (55%)

Add-on Updater

  • 作者: 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のコアの問題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.
  • このアドオンはセキュアスクリーンで使用されることを前提としていません。もしセキュアスクリーンにインストールされたアドオンがある場合、Add-on Updaterをセキュアスクリーンモードにコピーしても、Add-on Updaterは動作しません。
  • もし新しいアドオン更新が互換性の範囲（動作確認を行なった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.
  • Some add-on releases include SHA256 hash values for checking add-on package integrity (all add-ons published on add-on store include SHA256 values), and if the hash value does not match, add-on updating will fail.

アドオン設定

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.
  • アドオンを更新しない: 更新しないアドオンを選択出来ます。
  • 開発版のリリースを好む: このリストでチェックされているアドオンは、開発版（リリース前）のリリースを受け取ります。
  • Development release channel (selected add-on must be checked from prefer development releases): allows selecting development updates coming from either dev or beta channel.
  • Add-on update source: you can choose where to get updates from. Currently Add-on Updater supports downloading updates from the sources listed below. A confirmation message will be shown after changing update source.

The available add-on update sources are:

  • NV Access add-on store (default)
  • Community add-ons website
  • Spanish community add-ons catalog
  • Catalogs maintained by NVDA communities in China and Taiwan

Version 24.3/24.08

  • When NVDA starts, Add-on Updater will not present updates dialog if NVDA 2024.3 or later is in use and update notifications is set to "notify" from NVDA's add-on store settings.

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.

Version 23.07

  • If using an NVDA release with add-on store included, a startup message will be shown informing users about the new add-on store. If this happens, add-on update results dialog will not be shown. Add-on Updater will continue to work.
  • Improved performance when checking for add-on updates from NV Access add-on store and community add-ons website update sources, particularly when no add-on updates are available.

Version 23.06

  • NVDA 2023.1 or later is required.
  • Changed default add-on update source from community add-ons website to NV Access add-on store.

Version 23.05

  • Add-on update channel will be displayed when reviewing available add-on updates.
  • NVDA will present a message about add-on store if using NVDA releases with add-on store included.

Version 23.04

  • Added development update channel setting to let users of development add-ons choose between dev and beta update channels. This option is shown if the selected add-on from prefer development releases list is checked.
  • NV Access add-on store is broadly available as an update source from Add-on Updater.

Version 23.03

  • Due to changes made to the website used by some update sources, this must be installed manually.
  • Added NV Access add-on store as an experimental add-on update source.

Version 23.02

  • NVDA 2022.4 or later is required.
  • NVDA will no longer offer what appears to be older add-on updates for most add-ons after checking for add-on updates. This applies to add-ons with version text of the form number.number.

Version 23.01

  • NVDA will check minimum Windows version for add-on updates if update source is set to NVDA community add-ons website.
  • Improved performance when downloading many ad-on updates at once. As a result, the order of add-on downloads shown in download progress dialog will be random.
  • Parts of the add-on now use Python's concurrent.futures module to improve performance, specifically update check and download processes.

Version 22.11

  • NVDA 2022.3 or later is required.

Version 22.10

  • Added catalogs from NVDA communities in China and Taiwan as add-on update sources (by Woody Tseng).

バージョン 22.09

  • NVDA 2022.2以降が必要です。
  • NVDAは、アドオン更新源がアドオンパッケージのハッシュ値を含んでいる場合、アドオンの更新をダウンロードする間、SHA256ハッシュ値を確認します。 もしハッシュ値が無効の場合、アドオン更新が失敗します。

バージョン22.08

  • 内部コードの大幅な再編成と書き直し。
  • Windowsサーバーシステムでは、自動アドオン更新機能が初期状態で無効化されます(新しいインストールに影響します)。
  • 異なるアドオン更新源を選択する機能を追加しました。Add-on Updaterはコミュニティアドオンウェブサイト(addons.nvda-project.org)またはスペインコミュニティアドオンカタログ(nvda.es)にホストされた更新を確認出来ます。アドオン更新源を選択する新しいコンボボックスがアドオン設定パネルに追加されました。
  • Windows 10以降では、NVDAが実際にインストールされていて、アドオン更新通知がトーストに設定されている場合、Add-on Updaterが、バックグラウンドでのアドオンの更新のダウンロードとインストールを確認することが可能です。
  • 複数のアドオンの更新について、アドオン更新のダウンロードとインストールの経験の再設計をしました。全部をダウンロードした後に、全てのアドオンと更新されているアドオンのダウンロードの進行を示す単一のダイアログの使用を含みます。
  • もしNVDAがトーストで更新の通知をするように設定されていると、更新が可能になった時、「アドオンの更新を確認」メニュー項目が、アドオンの更新回数を含む新しい名前での「アドオンの更新をレビュー」になります。
  • NVDA 2022.1以降では、Add-on Updaterはこのアドオンのコマンドラインスイッチを実行出来るようになります(現時点はありません)。
  • アドオン更新ダイアログで、ユーザーにより無効化されているアドオンは初期状態でチェックされていません。そして、無効化されているアドオンを更新しようとする場合、アドオンが有効化されることを確認するための確認メッセージが表示されます。

バージョン22.07

  • このアドオンにより使用されるURLは新しいモジュールの内部にホストされる定数になりました(Luke Davisの貢献)。
  • アドオンダウンロード進行ダイアログが画面の中央に配置されました。

バージョン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以降では、トーストメッセージと更新ダイアログの間で、アドオン更新通知の選択が可能です。これはNVDA設定画面の中のAdd-on Updater設定で設定出来ます。
  • Windows App Essentialsのようなアドオンはより良いWindows互換性情報を提供しているので、Add-on Updaterはアドオンの最小Windowsリリース情報をチェックしません。

バージョン 21.07

  • Windows 10以降では、アドオン更新が利用可能な時、トースト通知が表示されます。この通知をクリック出来ないことに注意して下さい。 - 更新をレビューするには、NVDAメニュー/ツール/アドオン更新の確認を開かなくてはなりません。
  • レガシーなアドオンダイアログが起動時に表示される時、アドオン更新と同じような形式で、レガシーなアドオンと、その理由をレビューできます。
  • アドオンの互換性を評価するためにコミュニティから提供されるアドオンのメタデータ収集の使用を含む、アドオン更新確認の内部の改善。とりわけ、これは新しいアドオンに更新確認を追加するためのアドオンのリリースを省けます。

バージョン21.05

  • NVDA 2021.1アルファスナップショットを利用して更新しようとしている時に、wxPython GUIツールキットへの変更が原因でのエラー音を、NVDAが鳴らさなくなりました。

バージョン21.03

  • NVDA 2020.4以降が必要です。
  • アドオンの更新を確認している間にインターネット接続を失うなどのエラーが起こると、NVDAがエラーダイアログを出します。

バージョン20.11

  • NVDA 2020.3以降が必要です。
  • コード形式の問題とFlake8について可能性のあるバグを解決しました。
  • NVDAをソースコードから実行している間にこのアドオンを使用している時、NVDAがエラー音を鳴らさなくなり、何もしていないように見えることがなくなりました。その代わり、そのことについてのメッセージがログに記録されるようになりました。

バージョン20.07

  • NVDA 2020.1以降が必要です。
  • もし一以上のレガシーアドオン(Screen Curtainのような)がインストールされている場合、Add-on Updaterはリストされたそれらのアドオンを無効化するかアンインストールするか尋ねるメッセージを表示します。
  • Control+NVDA+C, Control+NVDA+Rを一回、または Control+NVDA+R を三回押すことで、それぞれ、Add-on Updaterの設定を保存、再読み込み、またはリセットすることが出来るようになりました。

バージョン20.06

  • 多くのコード形式の問題とFlake8について可能性のあるバグを解決しました。

バージョン20.04

  • Add-on Updaterを介してアドオンを更新しようとする時に、NVDAが何もしていないように見えることがなくなり、エラー音を鳴らすことがなくなりました。
  • 「アドオン更新を確認」の項目がNVDAのツールメニューに出ていなかった問題を解決しました。

バージョン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

  • 最初の安定版リリース(まだ概念実証の印が付けられています)