Migración a Axe DevTools para 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

Pasos para migrar a la versión 4.x de Axe DevTools para Web para Ruby

Not for use with personal data

Axe DevTools para Web Gems v4.x es una reescritura importante de todo el proyecto. Los cambios más notables se resumen a continuación, seguidos de cambios más específicos en los paquetes relevantes.

Resumen

La suite axe-devtools-* de gems fue reestructurada para reducir las herramientas de integración proporcionadas y ofrecer una mejor experiencia para desarrolladores.

En comparación con versiones anteriores donde solo se proporcionaba un único gem, esta versión ofrece una colección de gems que permite a los usuarios finales elegir lo que es esencial y se adapta mejor a su flujo de trabajo actual.

Pasos de Migración

Dada la separación de una estructura gem monolítica a gems individuales, se requieren algunos pasos de migración. Puede usar la siguiente guía de migración.

Configuración del Desarrollador

No hay cambios con respecto a la configuración de desarrollador anterior. Los requisitos necesarios son los siguientes:

Ruby (la última versión)
Bundler para dependencias de gems
Rake como un gestor de tareas
RSpec o Cucumber para pruebas
Node y Npm para instalar el paquete axe-core

Instalación de Axe DevTools para Web Gems

Asegúrese de tener acceso a Deque's registry. Si no, refer to the setup guide.

Una vez que tenga acceso al registro de Deque, puede instalar cualquiera de los siguientes gems incluyéndolos en los archivos Gemfile o gemspec.

gem "axe-devtools-cucumber"

Alternativamente, puede especificar una fuente para el gem:

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

Los gems disponibles son:

Por favor, consulte la documentación para obtener instrucciones de uso e información detallada sobre las APIs.

Desinstalación de las Integraciones Ruby

Puede desinstalar las integraciones Ruby anteriores ejecutando los siguientes comandos:

gem uninstall axe-matchers
gem uninstall attest-ruby

Cambios Relevantes

Otros cambios relevantes en la integración Ruby incluyen:

La variable de entorno para configurar reglas personalizadas ha cambiado de ATTEST_PATH a AXE_RULESET_PATH. Consulte advanced usage.
El conjunto de reglas predeterminado ha cambiado. Axe DevTools para Web audita una página dada con wcag2 como conjunto de reglas predeterminado. No se requiere ningún cambio por parte del usuario final. Si desea configurar un conjunto de reglas diferente, puede usar las cláusulas respectivas ofrecidas en la documentación de Cucumber o la documentación de RSpec.
Los Matchers be_accessible en RSpec han sido renombrados a be_axe_clean.
La definición de paso be accessible en RSpec ha sido renombrada a be axe clean.