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 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 foi alterado. O Axe DevTools for Web audita uma página fornecida 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, pode usar as cláusulas oferecidas em a documentação do Cucumber ou a documentação do RSpec.
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.