# Manual do Accerciser v0.2.0

2006
2007
2008
IBM Corporation
2008.
Enrico Nicoletto (liverig@gmail.com)
2008.
Fabrício Godoy (skarllot@gmail.com)
2008.
Leonardo Ferreira Fontenelle (leonardof@gnome.org)
GNOME Documentation Project
Eitan
Isaacson
Equipe do Accerciser

     eitan@ascender.com

Peter
Parente
Equipe do Accerciser

     pparent@us.ibm.com

Manual do Accerciser v0.2.0
29/06/2007

Eitan Isaacson eitan@ascender.com

Equipe do Accerciser

Este manual descreve a versão 0.1.5 do Accerciser.

Este manual descreve o uso do Accerciser.

## Feedback

Para relatar algum erro ou fazer uma sugestão relacionada ao aplicativo Accerciser ou este manual, visite a página de feedback do GNOME.

## Introdução

O Accerciser é um explorador interativo de acessibilidade para o ambiente GNOME. Escrito em Python, ele utiliza o AT-SPI para inspecionar e controlar widgets, permitindo que você verifique se um aplicativo está fornecendo informações corretas para as tecnologias assistivas e frameworks para testes automatizados. O Accerciser possui um framework simples de plug-ins que você pode utilizar para criar visualizações personalizadas de informações de acessibilidade.

Em essência, o Accerciser é uma nova geração da ferramenta at-poke.

## Iniciando o uso

### Para iniciar o Accerciser

Você pode iniciar o Accerciser das seguintes formas:

Menu Aplicativos

  Vá até o item de menu Desenvolvimento Accerciser.

Linha de comando

  Digite o seguinte comando em uma janela de console e depois pressione Enter:

  `accerciser`

### Iniciando o Accerciser

Quando você iniciar o Accerciser, a seguinte janela será exibida.

#### Janela principal do Accerciser

Shows Accerciser main window. Contains title bar, menu bar, accessible tree , right plugin display area, and bottom plugin display area. The menu bar contains File, Edit, Bookmarks, View, and Help menus.

A janela principal do Accerciser contém os seguintes elementos:

Barra de menu

  A barra de menu contém comandos para gerenciar plug-ins, gerenciar e usar marcadores, atualizar a visão em árvore de acessibilidade e acessar este sistema de ajuda.

Visão em árvore de acessíveis

  A visão em árvore de acessíveis permite visualizar todos os objetos acessíveis iniciando no nível da área de trabalho. Selecionar um objeto acessível torna-o disponível para inspeção adicional com os plug-ins carregados.

Visão direita de plug-ins

  Esta é uma das duas visões padrão de plug-in. Quando o Accerciser for executado pela primeira vez, a maioria dos plug-ins estarão localizados aqui. Você pode arrastar as abas de plug-ins para a visão inferior ou para a área de trabalho para mostrar dois ou mais plug-ins simultaneamente.

Visão inferior de plug-ins

  Você pode arrastar plug-ins para esta área ou a partir dela da mesma forma que na visão direita de plug-ins.

### Gerenciando a visão de plug-ins

O Accerciser tem dois modos de visão de plug-ins. O modo de exibição atual poder ser alternado em Ver Visão unificada de plug-ins ou pressionando Control t. Quando o modo unificado é habilitado, todos os plug-ins serão postos na visão direita de plug-ins e ordenados alfabeticamente. Isso pode ser útil para usuários de leitor de tela, que não podem aproveitar o flexível esquema de disposição espacial de plug-ins do Accerciser. Quando o modo unificado está desabilitado, as abas de plug-ins podem ser arrastadas e soltadas em diferentes visões de plug-in, ou podem ser arrastadas para a área de trabalho para colocar aquele plug-in em uma nova visão. O arranjo de plug-ins também pode ser manipulado com o menu de contexto do plug-in, que pode ser obtido tanto da aba de plug-in quanto do diálogo de preferências de plug-in.

## Uso

Você pode usar o Accerciser para inspecionar qualquer widget acessível mostrado na visão em árvore utilizando os plug-ins disponíveis. O primeiro passo é selecionar um objeto acessível para inspecionar, usando um dos seguintes métodos:

### Selecione um objeto acessível através da visão em árvore.

Use a visão em árvore para navegar pela hierarquia de objetos acessíveis, oriundos da área de trabalho. Expandir um nó da árvore revela seus filhos imediatos, e recolher o nó os esconde. Cada nó mostra um ícone correspondente ao aplicativo associado ou a lista de widget e o seu nome acessível, se disponível. A segunda coluna lista quantos nós serão mostrados se o item for expandido.

### Usando marcadores

O Accerciser permite colocar marcadores selecionando os objetos acessíveis para uma futura verificação. Isto pode ser de grande ajuda se o aplicativo alvo precisar ser reiniciado, por exemplo depois de recompilá-lo. Para colocar um marcador no objeto acessível atual selecionado, vá até Marcadores Adicionar marcador... ou pressione Control d.

Os marcadores para objetos acessíveis no Accerciser estão definidos pelo nome do aplicativo e um "caminho" na hierarquia interna de acessibilidade do aplicativo para o marcador acessível. Quando o aplicativo alvo está em um estado diferente (ex. muitos quadros de níveis superiores) o caminho pode não estar correto.

Marcadores podem ser gerenciados acessando a janela dos editores de marcador em Marcadores Editar marcadores....

## Plug-ins predefinidos

O Accerciser vem com diversos plug-ins predefinidos. Estes plug-ins permitem que você veja uma variedade de informações sobre o objeto acessível selecionado atualmente na visão em árvore e seus vizinhos. Os plug-ins predefinidos disponíveis na versão 0.1.5 são os seguintes:

### Visão de interface

Este plug-in exibe informações sobre as interfaces disponíveis para o objeto acessível selecionado na visão em árvore. Interfaces sem suporte estarão acinzentadas. Vários instrumentos para ver e controlar uma interface estão disponíveis abaixo de cada expansor.

#### Visão de interface

As interfaces com suporte do objeto acessível selecionado são mostradas como sensíveis, não acinzentadas.

### Monitor de eventos

Este plug-in monitora os tipos de eventos selecionados da visão em árvore de acessíveis, da visão em árvore do aplicativo selecionado, ou de toda a área de trabalho.

#### Monitor de eventos

A parte inferior da janela do monitor de eventos permite que você selecione o tipo e a fonte de eventos.

Pressionando Control Alt l em qualquer parte da área de trabalho, o último evento registrado será destacado para futura referência. Veja para alterar a combinação de teclas.

### Console IPython

Este plug-in é um console completo em IPython. Pressione Tab para mostrar complementações para o comando atual. Pressione Enter para executar qualquer código Python válido. Os comandos no console possuem acesso ao objeto acessível atualmente selecionado na árvore de acessibilidade de acordo com a variável `acc`. Além disso, todas as funções e constantes do pacote pyatspi estão disponíveis como locais, no console. A mais importante delas são as funções para consultar outras interfaces de acessibilidade. Por exemplo, para consultar a interface de Texto: `t = acc.queryText()` . Também é permitido importar do diretório de trabalho atual ou do caminho Python.

### Navegador de APIs

Este plug-in mostra as interfaces, métodos e atributos com suporte do objeto acessível selecionado na visão em árvore.

#### Navegador de APIs

O navegador API.

### Gravador de script

O gravador de script do Accerciser permite aos usuários gravar a interação do teclado com outras aplicações da área de trabalho com o propósito de criar teste UI. Atualmente o plug-in suporta a geração de scripts de três plataformas: Dogtail, LDTP, e a API integrada do Accerciser. Uma vez pressionado o botão "Gravar", cada interação do teclado será gravada em um script que poderá ser posteriormente executado como um script independente.

#### Gravador de script

O gravador de script.

### Seleção rápida

Este plug-in fornece teclas de atalho globais para permitir a seleção rápida de objetos acessíveis através de aplicações-alvo UI. Pressionando Control Alt a selecionar-se-á o último widget focalizado acessível no Accerciser. Pressionando Control Alt t será selecionado o objeto acessível do widget que encontra-se abaixo do ponteiro.

### Validador

O plug-in verifica aplicativos quanto a problemas de acessibilidade, e gera um relatório incluindo a gravidade e a descrição dos mesmos. O relatório vincula erros para a documentação sobre como remediar problemas comuns. O plug-in é extensível com alguns esquemas de teste que definem regras para validação.

Para rodar o validador, primeiramente selecione um item na árvore de acessibilidade. O plug-in testará o acessível selecionado e todos os seus descendentes. Depois selecione um esquema para usá-lo no teste. Em seguida clique no botão Validar para iniciar o teste. Enquanto o teste é executado, clique no novamente no botão para cancelá-lo.

Quando o teste termina, a tabela de relatório exibe a severidade e descrição de todos os erros. Dê um clique duplo em uma linha na tabela para exibir os acessíveis associados na árvore. Com um item selecionado, clique em Ajuda para obter informações sobre como resolver o problema.

## Preferências

Alguns elementos do Accerciser são configuráveis:

### Layout de plug-ins

Há dois métodos para configurar o layout do plug-in no Accerciser. Primeiramente você deve escolher Editar Preferências para ativar a janela de diálogo Preferências. Esta janela de diálogo contém abas para cada seção, selecione a aba Plug-ins. Abaixo desta seção você encontrará uma visualização em lista de todos os plug-ins disponíveis. Dê um clique direito em qualquer um dos plug-ins listados para configurar a sua respectiva visualização.

Você pode ignorar a janela de diálogo Preferências utilizando-se de arrastar e soltar para mover abas de plug-in. Arrastar uma aba de plug-in, para o inferior ou para a área de plug-in direita na janela principal, moverá o plug-in. Arrastar uma aba para a área de trabalho será criado uma janela de plug-in novo e soltará o plug-in nela.

### Configuração globais das teclas de atalho

Alguns elementos do Accerciser podem ativar certa funcionalidade através das teclas de atalho. A combinação das teclas de atalho pode ser alterada através da janela Preferências, para fazê-lo deve-se selecionar Editar Preferências para ativar o menu Preferências. Esta janela contém abas para cada seção, selecione a aba Teclas de atalho globais. Embaixo dessa seção você encontrará uma lista de todas as teclas de atalho disponíveis. Mude as combinações das teclas ao seu gosto.

## Sobre o Accerciser

O Accerciser foi escrito por Eitan Isaacson (eitan@ascender.com). Para procurar mais informações sobre o Accerciser, por gentileza visite a Accerciserpágina do GNOME Live!.

Para relatar algum erro, ou fazer uma sugestão relacionada a este aplicativo ou este manual, siga as instruções deste documento.

A redistribuição e o uso nas formas binárias e em código, com ou sem modificação, são permitidas sobre os termos da licença BSD.