Migrando para Axe DevTools for Web v4.x para Ruby

This page is not available in the language you requested. You have been redirected to the English version of the page.

Link to this page copied to clipboard

Passos para migrar para a versão 4.x do Axe DevTools for Web para Ruby

Not for use with personal data

O Axe DevTools for Web Gems v4.x é uma reescrita significativa de todo o projeto. As mudanças mais notáveis estão resumidas abaixo, seguidas por alterações mais específicas para pacotes relevantes.

Resumo

O conjunto de gems axe-devtools-* foi reestruturado para reduzir as ferramentas de integração fornecidas e oferecer uma melhor experiência para o desenvolvedor.

Em comparação com versões anteriores, onde apenas um único gem era fornecido, esta versão oferece uma coleção de gems permitindo que os usuários finais escolham o que é essencial e se adapta melhor ao fluxo de trabalho atual deles.

Passos de Migração

Dado o desmembramento de uma estrutura de gem monolítica para gems individuais, alguns passos de migração são necessários. Você pode usar o seguinte guia de migração.

Configuração do Desenvolvedor

Não há mudanças em relação à configuração anterior do desenvolvedor. Os requisitos necessários são os seguintes:

Ruby (a versão mais recente)
Bundler para dependências de gem
Rake como um executor de tarefas
RSpec ou Cucumber para testes
Node.js e Npm para instalar o pacote axe-core

Instalação dos Axe DevTools for Web Gems

Certifique-se de ter acesso a Deque's registry. Caso contrário, refer to the setup guide.

Após ter acesso ao registro da Deque, você pode instalar qualquer um dos seguintes gems incluindo-os nos arquivos Gemfile ou gemspec.

gem "axe-devtools-cucumber"

Alternativamente, você pode especificar uma fonte para o gem:

gem "attest-devtools-cucumber", :source => 'https://agora.dequecloud.com/artifactory/api/gems/devtools-gems'

Os gems disponíveis são:

Consulte a documentação para instruções de uso e informações detalhadas sobre as APIs.

Desinstalando as Integrações Ruby

Você pode desinstalar as integrações Ruby anteriores executando os comandos abaixo:

gem uninstall axe-matchers
gem uninstall attest-ruby

Alterações Relevantes

Outras mudanças relevantes na integração Ruby incluem:

A variável de ambiente para configurar regras personalizadas foi alterada de ATTEST_PATH para AXE_RULESET_PATH. Consulte advanced usage.
O conjunto de regras padrão mudou. O Axe DevTools for Web audita uma página específica com wcag2 como conjunto de regras padrão. Nenhuma alteração é necessária pelo usuário final. Se você quiser configurar um conjunto de regras diferente, poderá usar as respectivas cláusulas oferecidas em a documentação do Cucumber ou a documentação do RSpec. Note que o padrão mudou novamente desde este lançamento: a partir do Axe DevTools for Web 4.5 (dezembro de 2022), o conjunto de regras padrão foi padronizado em todos os pacotes para WCAG 2.1 Nível AA com as melhores práticas desativadas. Veja Personalização de Regras.
Os Matchers be_accessible no RSpec foram renomeados para be_axe_clean.
A definição de Step be accessible no RSpec foi renomeada para be axe clean.