Nesse guia básico você terá uma noção básica de como criar um Addon para o NVDA.
Para aprofundar seus conhecimentos, sugerimos que adquira nosso curso de Lógica de programação e Introdução ao Python.
1. Como é óbvio, teremos que abrir o chatGPT e, logo no início, escrever uma instrução, que será a "fada madrinha": @nvda (se faltar o sinal de arroba, antes, nada feito!)
2. Agora, pressionando a seta abaixo, deverá aparecer-vos "addons creator for NVDA". Caso não apareça, à primeira, pressionem "enter".
3. a partir deste momento, o GPT orientador do vosso trabalho, que corre sobre o chatGPT, será o "addons creator for NVDA"
4. então, vamos colocar-lhe uma questão, que é essencial:
Dito por mim:
Pode fornecer-me a estrutura geral de um addon para o NVDA?
Respondido pelo GPT.
Para construir um addon para o NVDA, é necessário seguir uma estrutura básica. Aqui está a estrutura geral e os passos para criar um addon:
Estrutura Básica de um Addon NVDA
Um addon é organizado em pastas e arquivos específicos. Aqui está a estrutura comum:
1. Raiz do Addon:
manifest.ini: Contém as informações do addon, como o nome, descrição, versão e autor. Além disso, especifica as versões do NVDA com as quais o addon é compatível.
__init__.py: Arquivo Python que pode ser usado para inicializar o addon e definir variáveis globais ou funções compartilhadas.
2. Pasta addon:
Esta pasta é o núcleo do addon e geralmente possui subpastas para scripts, módulos e outros recursos.
3. Pasta globalPlugins:
Onde os plugins globais do NVDA são colocados. Estes plugins afetam o comportamento do NVDA em todo o sistema, não apenas em uma aplicação específica.
4. Pasta appModules:
Contém módulos de aplicação específicos, ou seja, scripts que otimizam a interação do NVDA com aplicativos específicos, como navegadores ou processadores de texto.
5. Pasta synthDrivers:
Se o addon adicionar suporte para sintetizadores de voz, os drivers personalizados para esses sintetizadores são colocados aqui.
6. Pasta brailleDisplayDrivers:
Contém drivers para dispositivos de exibição em braille.
7. Pasta lib (Opcional):
Aqui você pode colocar bibliotecas externas necessárias para o addon. Para adicionar as bibliotecas desta pasta ao caminho do Python, consulte o trecho abaixo:
dirAddon = os.path.dirname(__file__)
sys.path.append(dirAddon)
sys.path.append(os.path.join(dirAddon, "lib"))
8. Documentação:
Inclua um arquivo de documentação em HTML (documentation.html) que descreve como usar o addon, seus atalhos e funcionalidades.
Exemplo Básico de um Addon
manifest.ini
Exemplo de conteúdo do manifest.ini:
ini
[addon]
name = ExemploAddon
version = 1.0
author = Seu Nome
description = Este é um exemplo de addon para NVDA.
minimumNVDAVersion = 2021.1
lastTestedNVDAVersion = 2023.1
globalPlugins - Exemplo de Script
Crie um arquivo chamado example.py na pasta globalPlugins:
python
import globalPluginHandler
import ui
class GlobalPlugin(globalPluginHandler.GlobalPlugin):
def script_sayHello(self, gesture):
ui.message("Hello, NVDA user!")
__gestures = {
"kb:nvda+h": "sayHello"
}
Este script registra o comando "NVDA+H" para dizer "Hello, NVDA user!".
Empacotando o Addon
Depois de organizar a estrutura e escrever o código, o addon pode ser empacotado em um arquivo .nvda-addon. O NVDA inclui ferramentas para facilitar esse empacotamento:
1. No diretório do addon, abra o terminal e use o seguinte comando para empacotar:
bash
scons
Usando Bibliotecas Externas
Para usar bibliotecas externas no addon, siga as orientações do arquivo que forneci anteriormente:
1. Coloque a biblioteca na pasta lib.
2. Adicione a pasta lib ao sys.path no código Python.
Referências Úteis
Para mais detalhes, consulte as guias completas e os arquivos que você carregou, como este guia e o arquivo sobre bibliotecas externas.
Seguindo estas instruções, conseguirá criar um addon funcional para o NVDA.
