Atualizador de Complementos (Add-on Updater)

Autores: Joseph Lee, Luke Davis
Baixe a versão estável
Compatibilidade com NVDA: 2023.1-2024.2+
Esse é um complemento possivelmente legado: O NVDA 2023.2 inclui a funcionalidade de verificação de atualização de complementos por meio da loja de complementos

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

Para verificar se há atualizações depois de instalar esse complemento, vá para o menu NVDA/Ferramentas/Verifique se há atualizações de complementos (se o NVDA tiver notado atualizações, o item de menu dirá “Revisão add-on updates” seguido da contagem de atualizações). Se houver atualizações disponíveis, será exibida uma lista de atualizações de complementos, com cada entrada consistindo no nome do complemento, na versão atual, na nova versão e no canal de atualização. Selecione (Atualizar) e o NVDA fará o download e aplicará as atualizações em sequência, com uma solicitação para reiniciar o NVDA exibida em seguida.

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 (Loja da comunidade NVDA em espanhol)

NOTAS IMPORTANTES:

Assim que o recurso relevante for incluído no NVDA na forma de uma loja de complementos com atualizações automáticas e notificações de atualização, esse complemento será eliminado gradualmente. Atualmente, embora a Add-on Store tenha sido introduzida no NVDA 2023.2 e as notificações básicas de atualização estejam disponíveis no NVDA 2024.3, a gama completa de recursos ainda não está disponível.
Esse complemento requer o Windows 10 versão 22H2 ou posterior.
Aprimoramento da parte interna da verificação de atualização de complementos, incluindo o uso da coleção de metadados de complementos fornecida pela comunidade para validar a compatibilidade de complementos. Entre outras coisas, isso elimina as versões de add-on para adicionar verificações de atualização para novos add-ons.
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.
Na janela de configurações do NVDA, ao editar as configurações do Add-on Updater, você pode notar que o título indica que você está editando as configurações de um perfil de configuração específico (qualquer perfil que estivesse ativo antes de entrar nas configurações). Isso não é importante. As configurações desse complemento são sempre globais.
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.
Alguns recursos exigem que o NVDA esteja instalado no computador.
Algumas versões de add-on incluem valores de hash SHA256 para verificar a integridade do pacote de add-on (todos os add-ons publicados na loja de add-on incluem valores SHA256) e, se o valor de hash não corresponder, a atualização do add-on falhará.

Configurações do add-on

Você pode definir as configurações do Add-on Updater na tela NVDA Configurações (menu NVDA, Preferências, Configurações) na categoria Atualizador de Complementos. As configurações do complemento são as seguintes:

Verificar automaticamente se há atualizações de complementos: se marcada, o NVDA verificará se há atualizações de complementos uma vez a cada 12 horas. As verificações automáticas de atualização são ativadas por padrão nos sistemas clientes Windows e desativadas por padrão nos sistemas de servidor.
Notificação de atualização do complemento: você pode optar por receber a notificação de atualização como uma caixa de diálogo ou um brinde. Em sistemas de servidor ou na execução de uma cópia portátil do NVDA, a notificação de atualização será mostrada como uma caixa de diálogo.
Atualizar complementos em segundo plano (a notificação de atualização é definida como brinde): se marcada, o Add-on Updater aplicará atualizações em segundo plano. Será exibido um brinde informando que as atualizações de complementos estão sendo baixadas e instaladas, seguido de outra mensagem anunciando os resultados da atualização. As mesmas limitações da configuração de notificação de atualização de complemento e brinde devem ser selecionadas na opção acima para que as atualizações em segundo plano funcionem.
Não atualizar complementos: você pode escolher complementos que não devem ser atualizados.
Preferir versões de desenvolvimento: todos os add-ons marcados nessa lista receberão versões de desenvolvimento (pré-lançamento).
Canal de versão de desenvolvimento (o complemento selecionado deve ser verificado entre as versões de desenvolvimento preferidas): permite selecionar atualizações de desenvolvimento provenientes do canal de desenvolvimento ou beta.
Fonte de atualização do complemento: você pode escolher de onde obter as atualizações. Atualmente, o Add-on Updater suporta o download de atualizações das fontes listadas abaixo. Uma mensagem de confirmação será exibida após a alteração da fonte de atualização.

As fontes de atualização de add-on disponíveis são:

Loja de complementos da NV Access (padrão)
Site de complementos da comunidade
Catálogo de complementos da comunidade espanhola
Catálogos mantidos pelas comunidades NVDA na China e em Taiwan

Versão 24.3/24.08

Quando o NVDA for iniciado, o Add-on Updater não apresentará a caixa de diálogo de atualizações se o NVDA 2024.3 ou posterior estiver em uso e as notificações de atualização estiverem definidas como “notificar” nas configurações da loja de complementos do NVDA.

Versão 24.2.4

Correção de um bug relacionado à correção na versão 24.2.1: esse bug não foi totalmente corrigido no NVDA 2023.X, porque a correção dependia de uma alteração feita no NVDA 2024.1. Essa situação já foi detectada e corrigida (josephsl/addonUpdater#22).
O intervalo de atualização foi alterado para 12 horas.
Agora, o leia-me faz referência às notificações de atualização disponíveis nativamente no NVDA 2024.3.
O leia-me foi atualizado para comentar sobre um erro não corrigível, mas inofensivo, no painel de configurações do NVDA (josephsl/addonUpdater#8).

Versão 24.2.2

Reduza o intervalo de atualização para seis horas.

Versão 24.2.1

Corrige um problema em que as atualizações do Updater, que aparecem no canal externo, eram mostradas como ainda atualizáveis na loja por meio do canal estável (ou outro). Causado por arquivos JSON residuais de instalações antigas não externas. Agora eles foram removidos.

Versão 24.2.0

Versão compatível com o NVDA 2024.1.

Versão 24.01.1

Versão de curta duração que remove o status legado introduzido no final de

Versão 23.10

Mensagem de notificação de atualização alterada para mencionar a loja de complementos do NV Access se estiver executando o NVDA 2023.2 ou posterior e a fonte de atualização de complementos estiver definida como loja de complementos.

Versão 23.09

É necessário o Windows 10 versão 22H2 ou posterior.

Versão 23.08

Esta é a versão final compatível com o Windows 7, 8, 8.1 e 10 21H2 e anteriores.

A caixa de diálogo de resultados da atualização do add-on ou a mensagem de brinde será exibida quando a mensagem da loja de add-on for fechada.
Se a caixa de diálogo de atualizações de complementos for exibida e fechada sem a instalação de complementos, o NVDA não informará mais que não há atualizações de complementos quando as atualizações de complementos forem verificadas.
O Add-on Updater não apresentará mais mensagens de inicialização e realizará verificações de atualização ao atualizar uma cópia portátil do NVDA.

Versão 23.07

Se estiver usando uma versão do NVDA com a loja de complementos incluída, será exibida uma mensagem de inicialização informando os usuários sobre a nova loja de complementos. Se isso ocorrer, a caixa de diálogo de resultados da atualização de complementos não será exibida. O Add-on Updater continuará funcionando.
Melhor desempenho na verificação de atualizações de complementos da loja de complementos do NV Access e das fontes de atualização do site de complementos da comunidade, especialmente quando não há atualizações de complementos disponíveis.

Versão 23.06

É necessário o NVDA 2023.1 ou posterior.
Alterada a fonte padrão de atualização de complementos do site de complementos da comunidade para a loja de complementos da NV Access.

Versão 23.05

O canal de atualização de add-on será exibido ao revisar as atualizações de add-on disponíveis.
O NVDA apresentará uma mensagem sobre a loja de complementos se estiver usando versões do NVDA com a loja de complementos incluída.

Versão 23.04

Adicionada a configuração do canal de atualização de desenvolvimento para permitir que os usuários de add-ons de desenvolvimento escolham entre os canais de atualização de desenvolvimento e beta. Essa opção é exibida se o complemento selecionado na lista de versões de desenvolvimento preferidas estiver marcado.
A loja de complementos do NV Access está amplamente disponível como uma fonte de atualização no Add-on Updater.

Versão 23.03

Devido a alterações feitas no site usado por algumas fontes de atualização, isso deve ser instalado manualmente.
Adicionado o armazenamento de complementos do NV Access como uma fonte experimental de atualização de complementos.

Versão 23.02

É necessário o NVDA 2022.4 ou posterior.
O NVDA não oferecerá mais o que parece ser atualizações de complemento mais antigas para a maioria dos complementos após a verificação de atualizações de complemento. Isso se aplica a complementos com texto de versão no formato número.número.

Versão 23.01

O NVDA verificará a versão mínima do Windows para atualizações de complementos se a fonte de atualização estiver definida como o site de complementos da comunidade NVDA.
Melhor desempenho ao fazer o download de muitas atualizações de complementos de uma só vez. Como resultado, a ordem dos downloads de complementos mostrada na caixa de diálogo de progresso do download será aleatória.
Melhor desempenho ao fazer o download de muitas atualizações de complementos de uma só vez. Como resultado, a ordem dos downloads de complementos mostrada na caixa de diálogo de progresso do download será aleatória.

Versão 22.11

É necessário o NVDA 2022.3 ou posterior.

Versão 22.10

Adicionados catálogos das comunidades NVDA na China e em Taiwan como fontes de atualização de complementos (por Woody Tseng).

Versão 22.09

É necessário o NVDA 2022.2 ou posterior.
O NVDA verificará os valores de hash SHA256 durante o download de atualizações de complementos se a fonte de atualização de complementos incluir valores de hash para pacotes de complementos. Se o valor do hash for inválido, a atualização do complemento falhará.

Versão 22.08

Reorganização e reescrita significativa do código interno.
Nos sistemas Windows Server, o recurso de verificação automática de atualizações de complementos está desativado por padrão (afeta novas instalações).
Foi adicionada a capacidade de selecionar diferentes fontes de atualização de complementos. O Add-on Updater pode verificar se há atualizações hospedadas no site de complementos da comunidade (addons.nvda-project.org) ou no catálogo de complementos da comunidade espanhola (nvda.es). Uma nova caixa de combinação foi adicionada ao painel de configurações do complemento para selecionar a fonte de atualização do complemento.
No Windows 10 e versões posteriores, é possível permitir que o Add-on Updater verifique, baixe e instale atualizações de complementos em segundo plano, desde que o NVDA esteja realmente instalado e a notificação de atualização de complementos esteja definida como brinde.
Experiência reformulada de download e instalação de atualizações de complementos para várias atualizações de complementos, incluindo o uso de uma única caixa de diálogo para mostrar o progresso do download de todos os complementos e a atualização dos complementos após o download de todos eles.
Se o NVDA estiver configurado para anunciar notificações de atualização como brindes, o item de menu “verificar atualizações de complementos” se tornará “revisar atualizações de complementos” quando as atualizações estiverem disponíveis, com o novo nome incluindo a contagem de atualizações de complementos.
No NVDA 2022.1 e posterior, o Add-on Updater pode processar opções de linha de comando para esse complemento (atualmente nenhuma).
Na caixa de diálogo de atualizações de complementos, os complementos desativados pelo usuário são desmarcados por padrão, e uma mensagem de confirmação será exibida verificando os complementos desativados e tentando atualizá-los, pois isso os ativará.

Versão 22.07

Os URLs usados pelo add-on agora são constantes hospedadas em um novo módulo (contribuição de Luke Davis).
A caixa de diálogo de progresso do download do complemento agora está centralizada na tela.

Versão 22.03

Segurança aprimorada ao não carregar o complemento quando o NVDA estiver sendo executado no modo seguro.

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

No Windows 10 e posteriormente, uma notificação do sistema será exibida quando houver atualizações de complementos disponíveis. Observe que você não pode clicar nesta notificação - você deve abrir o menu NVDA/Ferramentas/Verificar atualizações de complementos para revisar as atualizações.
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

O NVDA não reproduzirá mais tons de erro se tentar verificar as atualizações ao usar instantâneos (snapshots) alpha do NVDA 2021.1, causados por alterações no kit de ferramentas wxPython GUI.

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).