Flutter Access
O Flutter Access é uma extensão para Visual Studio Code desenvolvida para realizar análise estática de acessibilidade em projetos Flutter. Ela integra um analisador escrito em Dart diretamente ao fluxo de trabalho do desenvolvedor, permitindo a identificação de lacunas de acessibilidade no código-fonte através de relatórios técnicos e diagnóstico em tempo real.
Principais Funcionalidades
- Análise Direcionada: Suporte para análise de todo o projeto (workspace) ou de um arquivo específico em foco.
- Relatórios Detalhados: Geração automática de relatórios em formato JSON estruturado na pasta
relatorios do projeto.
- Sugestões Práticas de Correção: Mensagens de erro em português com sugestões técnicas para mitigar as falhas encontradas.
- Resumo Executivo: Apresentação de estatísticas de violação (total de problemas e regras violadas) ao final de cada execução.
Regras de Acessibilidade Suportadas
A ferramenta verifica diversos pilares da acessibilidade móvel, incluindo:
- Elementos de Texto: Validação de conteúdo textual, tamanhos e rotulagem.
- Botões e Acionadores: Verificação de descrições e objetivos de botões.
- Contraste Visual: Análise básica de visibilidade de componentes.
- Alvos de Toque (Tap Targets): Identificação de áreas clicáveis excessivamente pequenas.
- Semântica Avançada: Recomendações sobre o uso de
Semantics e ExcludeSemantics.
- Internacionalização (Intl): Alerta para ausência de traduções em mensagens de interface.
- Formulários e Foco: Consistência em campos de entrada e navegação por teclado/leitor de tela.
Pré-requisitos
Para o funcionamento correto da ferramenta, é necessário ter instalado e configurado:
- Dart SDK: O comando
dart deve estar acessível no PATH do sistema.
- Flutter SDK: Recomendado para projetos Flutter.
Instalação e Configuração
1. Instalação via Marketplace
Pesquise por Flutter Access no painel de extensões do VS Code e clique em instalar.
2. Configurações da Extensão
Acesse File > Preferences > Settings (ou Ctrl+,) e procure por Flutter Access para ajustar as seguintes opções:
- CLI Path: Comando para execução do Dart (Padrão:
dart).
- Reports Directory: Nome da pasta onde os relatórios serão salvos (Padrão:
relatorios).
- Pretty Print JSON: Formata o arquivo JSON para facilitar a leitura manual.
Como Usar
- Abra o seu projeto Flutter no VS Code.
- Abra a Paleta de Comandos (
Ctrl+Shift+P ou Cmd+Shift+P).
- Digite e selecione:
Flutter Access: Run.
- Escolha entre analisar o Projeto Inteiro ou apenas o Arquivo Aberto.
- Acompanhe o progresso na barra de notificações e veja os resultados detalhados na aba Output > Flutter Access.
- Verifique o relatório técnico gerado na pasta
relatorios/ na raiz do seu projeto.
Estrutura do Relatório JSON
Os relatórios gerados seguem uma estrutura padronizada para integração com outras ferramentas:
{
"gerado_em": "timestamp",
"problemas": [
{
"regra": "NomeDaRegra",
"mensagem": "Descrição técnica e sugestão de correção.",
"arquivo": "caminho/do/arquivo.dart",
"linha": 10,
"coluna": 5
}
],
"resumo": {
"quantidade_de_violacoes": 1,
"quantidade_de_regras_violadas": 1
}
}
Créditos e Autoria
Desenvolvedora: Caroline Matilde Lima Vitória
