Migrar el Plug-in de Appium a la Solución de Controlador de Appium

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

Guía para migrar a los primeros adoptantes a los últimos cambios de Axe DevTools Mobile para Appium.

Not for use with personal data

Nota: Si recién estás comenzando con Axe DevTools Mobile para Appium, dirígete a la guía de configuración.

Estamos emocionados de anunciar dos nuevos controladores de Appium para una solución líder en la industria de pruebas de accesibilidad con Appium. Nuestros controladores están impulsados por nuestros SDK comprobados, brindándote los mismos resultados robustos y altamente precisos que obtienes con todos nuestros componentes de Axe DevTools Mobile. Nuestros controladores de Appium cubren todas las reglas móviles disponibles de Deque y la configuración solo toma unos minutos.

Si implementaste la versión 2.0.0+ del plug-in de Axe DevTools Mobile para Appium, sigue esta guía para cambiar fácilmente a la solución de controlador.

Desinstalar el Plug-in

appium plugin uninstall axeDevToolsMobile

Instalar los Controladores

Instala los controladores requeridos en tu instancia de Appium a través de la línea de comandos:

Controlador Axe XCUITest para Pruebas en iOS

appium driver install --source=npm @axe-devtools/axe-appium-xcuitest-driver

Si necesitas desinstalar en cualquier momento, puedes desinstalar a través de la línea de comandos:

appium driver uninstall axexcuitest

Controlador Axe UIAutomator2 para Pruebas en Android

appium driver install --source=npm @axe-devtools/axe-appium-uiautomator2-driver

Si necesitas desinstalar en cualquier momento, puedes desinstalar a través de la línea de comandos:

appium driver uninstall axeuiautomator2

Inicia las Pruebas de Accesibilidad a través de Appium

Inicia el servidor de Appium como de costumbre:

appium

Configura tus Pruebas

Gran parte del código de configuración del plug-in de Appium se puede reutilizar para los controladores Axe de Appium.

Actualizaciones

  1. Nuevo con la solución de controlador es actualizar tu capacidad para automationName a AxeXCUITest para pruebas en iOS o AxeUiAutomator2 para pruebas en Android.

  2. Para evitar conflictos, el código driver.execute debe actualizarse a await driver.execute('mobile: axeScan', axeSettings), donde el objeto axeSettings sigue siendo el mismo objeto que contiene el apiKey y otras personalizaciones.

Ejemplos Completos

Ejemplo de Controlador Axe UiAutomator2 con Pruebas en Python

Aunque el ejemplo a continuación está escrito en Python, la lógica es transferible a otras bibliotecas cliente de Appium.


from appium import webdriver
from appium.options.android import UiAutomator2Options
from appium.webdriver.appium_connection import AppiumConnection

class DemoWithAxeDevToolsMobile:

    def setup(self):
        success = True
        desired_caps = {}
        # Add your required capabilities for testing:
        desired_caps['platformName'] = 'Android'
        desired_caps['appActivity'] = "com.app.package.MainActivity"

        # Add axe DevTools Mobile required capabilities for testing:
        desired_caps['appPackage'] = "com.app.package"
        desired_caps['automationName'] = 'AxeUiAutomator2'

        # Initialize Appium Server Connection
        options = UiAutomator2Options().load_capabilities(desired_caps)
        self.driver = webdriver.Remote('http://localhost:4723', options=options)

    def runAccessibilityScan(self):
        settings = {}
        settings['apiKey'] = "<your-api-key-here>"
        return self.driver.execute_script('mobile: axeScan', settings)


demo = DemoWithAxeDevToolsMobile()
demo.setup()

# <Navigate To Screen>
demo.runAccessibilityScan()

# <Navigate To Another Screen>
demo.runAccessibilityScan()

Ejemplo de Controlador Axe XCUITest con Pruebas en Python

Aunque el ejemplo a continuación está escrito en Python, la lógica es transferible a otras bibliotecas cliente de Appium.


from appium import webdriver
from appium.options.ios import XCUITestOptions
from appium.webdriver.appium_connection import AppiumConnection

class DemoWithAxeDevToolsMobile:

    def setup(self):
        success = True
        desired_caps = {}
        # Add your required capabilities for testing:
        desired_caps['platformName'] = 'iOS'

        # Add axe DevTools Mobile required capabilities for testing:
        desired_caps['bundleId'] = "com.bundle.identifier"
        desired_caps['automationName'] = 'AxeXCUITest'

        # Initialize Appium Server Connection
        options = XCUITestOptions().load_capabilities(desired_caps)
        self.driver = webdriver.Remote('http://localhost:4723', options=options)

    def runAccessibilityScan(self):
        settings = {}
        settings['apiKey'] = "<your-api-key-here>"
        return self.driver.execute_script('mobile: axeScan', settings)

demo = DemoWithAxeDevToolsMobile()
demo.setup()

# Navigate To Screen
demo.runAccessibilityScan()

# Navigate To Another Screen
demo.runAccessibilityScan()