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

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

Not for use with personal data

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

Resumen

La suite de gemas axe-devtools-* fue rediseñada para reducir las herramientas de integración proporcionadas y ofrecer una mejor experiencia para los desarrolladores.

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

Pasos de la migración

Dada la división de una estructura de gema monolítica a gemas individuales, se requieren algunos pasos de migración. Puede utilizar la siguiente guía de migración.

Configuración del desarrollador

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

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

Instalación de axe DevTools for Web Gems

Asegúrese de tener acceso al [registro de Deque] [configuración del registro npm de attest]. En caso contrario, consulte la guía de configuración.

Después de tener acceso al registro de Deque, puede instalar cualquiera de los siguientes gems incluyéndolas en los archivos Gemfile o gemspec.

gem "axe-devtools-cucumber"

Alternativamente, puedes especificar un repositorio fuente para la gema:

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

Los gems disponibles son:

Consulte la documentación para obtener instrucciones de uso e información detallada sobre las API.

Desinstalación de las integraciones de Ruby

Puede desinstalar las integraciones de Ruby anteriores ejecutando los siguientes comandos:

gem uninstall axe-matchers
gem uninstall attest-ruby

Cambios notables

Otros cambios notables en la integración de Ruby incluyen:

La variable de entorno para configurar reglas personalizadas se ha cambiado de ATTEST_PATH a AXE_RULESET_PATH. Consulte uso avanzado.
El conjunto de reglas predeterminado ha cambiado. Axe DevTools for Web audita una página determinada 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 utilizar las cláusulas respectivas que se ofrecen en la documentación de Cucumber o la documentación de RSpec.
Los be_accessible Matchers en RSpec han cambiado de nombre a be_axe_clean.
La definición de be accessible Paso en RSpec ha sido renombrada a be axe clean.