NVDA Community Addons/ addons/ Atualizador de Complementos (Add-on Updater)  (46%)

Atualizador de Complementos (Add-on Updater)

  • Author: Joseph Lee, Luke Davis
  • Baixe a versão estável
  • NVDA compatibility: 2023.1
  • This is a would-be legacy add-on: NVDA 2023.2 includes add-on update check functionality through add-on store

Este complemento implementa o issue 3208 do NVDA Core: capacidade de verificar, baixar e aplicar atualizações de complementos.

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.

Os seguintes complementos fornecem o recurso interno de atualização e, portanto, as atualizações não serão verificadas através deste complemento:

  • Extensor Braille (Braille Extender)
  • Tienda NVDA (Spanish NVDA Community Store)

NOTAS IMPORTANTES:

  • This is a proof of concept add-on. Once the relevant feature is included in NVDA in the form of an add-on store (introduced in NVDA 2023.2), this add-on will be discontinued.
  • This add-on requires Windows 10 Version 22H2 or later.
  • This add-on is not intended to be used in secure screens. If you have add-ons installed in the secure screen, even if you copy Add-on Updater to secure screen mode, Add-on Updater will not work.
  • Se as novas atualizações de complementos especificarem um intervalo de compatibilidade (mínima e última versão testada do NVDA) e se a versão do NVDA que você está executando não estiver dentro do intervalo de compatibilidade de acordo com o NVDA, a atualização do complemento não continuará.
  • Nem todos os complementos vêm com versões de desenvolvimento. Se você não estiver recebendo atualizações depois de optar por instalar as versões de desenvolvimento de um complemento, mude para o canal estável para os complementos afetados.
  • Em alguns sistemas (particularmente computadores conectados a um domínio corporativo), a funcionalidade de verificação de atualização de complemento pode não funcionar corretamente, portanto, as atualizações de complementos devem ser baixadas manualmente.
  • 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.

Add-on settings

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 follows:

  • Automatically check for add-on updates: if checked, NVDA will check for add-on updates once a day. Automatic update checks is enabled on Windows client systems and disabled 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.
  • Do not update add-ons: you can choose add-ons that should not be updated.
  • Prefer development releases: any add-ons checked in this list will receive development (prerelease) releases.
  • 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 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).

Version 22.09

  • NVDA 2022.2 or later is required.
  • NVDA will check SHA256 hash values while downloading add-on updates if the add-on update source includes hash values for add-on packages. If hash value is invalid, add-on updating will fail.

Version 22.08

  • Significant internal code reorganization and rewrites.
  • On Windows Server systems, automatic add-on update check feature is disabled by default (affects new installations).
  • Added ability to select different add-on update sources. Add-on Updater can check for updates hosted on community add-ons website (addons.nvda-project.org) or Spanish community add-ons catalog (nvda.es). A new combo box was added in add-on settings panel to select add-on update source.
  • On Windows 10 and later, it is possible to let Add-on Updater check for, download, and install add-on updates in the background provided that NVDA is actually installed and ad-on update notification is set to toast.
  • Redesigned add-on update download and install experience for multiple add-on updates, including use of a single dialog to show download progress for all add-ons and updating add-ons after downloading all of them.
  • If NVDA is set to announce update notifications as toasts, "check for add-on updates" menu item will become "review add-on updates" when updates become available, with the new name including add-on update count.
  • In NVDA 2022.1 and later, Add-on Updater can process command-line switches for this add-on (currently none).
  • In add-on updates dialog, add-ons disabled by the user are unchecked by default, and a confirmation message will be shown checking disabled add-ons and attempting to update them as doing so will enable them.

Version 22.07

  • URL's used by the add-on are now constants hosted inside a new module (contributed by Luke Davis).
  • Add-on download progress dialog is now centered on screen.

Version 22.03

  • Improved security by not loading the add-on when NVDA is running in secure mode.

Versão 22.02

  • É necessário o NVDA 2021.3 ou posterior.
  • No Windows 10, as notificações de sistema de atualização de complemento são localizadas.

Versão 22.01

  • É necessário o NVDA 2021.2 ou posterior.
  • Em sistemas de servidor que executam o Windows Server 2016 e posteriores, as atualizações de complementos serão apresentadas num diálogo em vez de usar notificações do sistema.

Versão 21.10

  • É novamente possível verificar se há atualizações de complementos em alguns sistemas, principalmente após uma instalação limpa do Windows.

Versão 21.09

  • É necessário o NVDA 2021.1 ou posterior.
  • no Windows 10 e posterior, é possível selecionar a notificação de atualização de complemento entre uma mensagem de notificação de sistema e uma caixa de diálogo de atualização. Isso pode ser definido nas configurações do atualizador de complementos encontradas na tela de configurações do NVDA.
  • O Atualizador de Complementos não verificará mais as informações mínimas de versão do Windows para complementos, pois complementos como o Windows App Essentials fornecem melhores informações de compatibilidade do Windows.

Versão 21.07

  • On Windows 10 and later, a toast notification will be shown when add-on updates are available. Note that you cannot click this notification - you must open NVDA menu/Tools/Check for add-on updates to review updates.
  • Quando o diálogo de complementos legados é exibido na inicialização, agora você pode revisar os complementos legados e os motivos, exatamente como as atualizações de complementos.
  • Melhorias internas na verificação de atualização de complementos, incluindo o uso da coleção de metadados de complemento fornecida pela comunidade para validar a compatibilidade de complemento. Entre outras coisas, isso elimina lançamentos do complemento para adicionar verificações de atualização para novos complementos.

Versão 21.05

  • NVDA will no longer play error tones if trying to check updates while using NVDA 2021.1 alpha snapshots, caused by changes to wxPython GUI toolkit.

Versão 21.03

  • É necessário o NVDA 2020.4 ou posterior.
  • O NVDA apresentará um diálogo de erro se ocorrerem erros durante a verificação de atualizações de complementos, como perda de conexão com a Internet.

Versão 20.11

  • É necessário o NVDA 2020.3 ou posterior.
  • Resolvido mais problemas de estilo de codificação e possíveis falhas com Flake8.
  • O NVDA não reproduzirá mais tons de erro ou parecerá não fazer nada ao usar o complemento enquanto o NVDA está sendo executado a partir do código-fonte. Em vez disso, uma mensagem sobre esse fato será gravada no log.

Versão 20.07

  • É necessário o NVDA 2020.1 ou posterior.
  • Se um ou mais complementos legados (como Cortina de Tela — Screen Curtain) estiverem instalados, o Atualizador de Complementos apresentará uma mensagem solicitando que você desative ou desinstale os complementos listados.
  • Agora você pode salvar, recarregar ou redefinir as configurações do Atualizador de Complemento pressionando Control+NVDA+C, Control+NVDA+R uma vez ou Control+NVDA+R três vezes, respectivamente.

Versão 20.06

  • Foram resolvidos muitos problemas de estilo de codificação e possíveis erros com o Flake8.

Versão 20.04

  • O NVDA não parece mais fazer nada ou reproduzir tons de erro ao tentar atualizar os complementos através do Atualizador de Complementos.
  • Foi resolvido um problema em que o item "verifique se há atualizações de complementos" não estava presente no menu Ferramentas do NVDA.

Versão 20.03

  • É necessário o NVDA 2019.3 ou posterior.
  • Ao instalar atualizações de complemento, o Atualizador de Complemento não verificará mais o alcance da compatibilidade. O próprio NVDA verificará a compatibilidade do complemento.

Versão 19.11

  • Quando as atualizações de complementos estiverem disponíveis, o NVDA anunciará quantas atualizações estão disponíveis.

Versão 19.09

  • Requer NVDA 2019.2 ou posterior.
  • Os erros de tempo limite (timeout) vistos ao tentar fazer o download de algumas atualizações de complementos (principalmente arquivos hospedados no GitHub) foram resolvidos.

Versão 19.04

  • Requer NVDA 2019.1 ou posterior.
  • Ao instalar as atualizações de complemento, as versões mínima e máxima testada serão verificadas.

Versão 19.01

  • Requer NVDA 2018.4 ou posterior.
  • Melhor capacidade de resposta ao verificar as atualizações de complemento.
  • Torna o complemento mais compatível com o Python 3.

Versão 18.12.2

  • Pronto para Python 3.
  • Corrigida a compatibilidade com as versões recentes do NVDA alpha, nas quais as atualizações de complementos não eram baixadas.

Versão 18.12.1

  • Adicionado localizações (traduções).

Versão 18.12

  • Atualizações para complementos desativados podem ser verificadas. Eles permanecerão desativados após atualizá-los.
  • Durante as atualizações, se um complemento exigir uma versão específica do NVDA e/ou uma versão do Windows, elas serão verificadas e, se uma delas não corresponder, uma mensagem de erro será mostrada e a atualização será cancelada, Não havendo alteração na versão do complemento instalado.
  • Quando a verificação automática de atualizações estiver habilitada e as atualizações estiverem prontas, o NVDA apresentará a lista de atualizações, em vez de perguntar se deseja verificar as atualizações.

Versão 18.10

  • Versão estável inicial (ainda marcada como prova de conceito).