Test mirato con 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

Configura i test di accessibilità in iOS e Android con Axe DevTools Mobile in Appium.

Not for use with personal data

Dopo che hai installato i driver Appium di Axe DevTools Mobile, puoi configurare i tuoi test per verificare i problemi di accessibilità.

Test automatizzato

Avvia il server Appium come al solito:

appium

Configura i tuoi test

Dai tuoi script di automazione Appium, aggiungi le capacità richieste per Axe DevTools Mobile per la piattaforma in test:

Capacità richiesta per Android:

Nome	Tipo	Descrizione
automationName	`String`	Imposta su 'AxeUiAutomator2' per utilizzare il driver con Axe DevTools Mobile integrato per eseguire scansioni di accessibilità.
appPackage	`String`	Il pacchetto dell'applicazione dell'app in test. Nota che `appPackage` è una parte del driver UiAutomator2; potrebbe essere già impostato.

Capacità richiesta per iOS:

Nome	Tipo	Descrizione
automationName	`String`	Imposta su 'AxeXCUITest' per utilizzare il driver con Axe DevTools Mobile integrato per eseguire scansioni di accessibilità.
bundleId	`String`	L'identificatore del bundle dell'app in test. Nota che `bundleId` è una parte del driver XCUITest; potrebbe essere già impostato.

Inizializza la libreria

Nella classe di test initialization, connettersi al driver con una Deque API Key o una Deque Offline License Key.

Inizia una sessione di test con una chiave API Deque

Genera una chiave API di Axe DevTools Mobile su axe.deque.com. Per inviare i risultati a Axe Developer Hub, avrai anche bisogno di un ID Progetto. Chiama l'Execute Script API, passando axeStartSession insieme alla Chiave API e all'ID Progetto per avviare la sessione di test.

    beforeAll(async () => {
        ...
        const axeSettings = {
            apiKey: "<DEQUE_APIKEY>",
            projectId: "<DEQUE_PROJECT_ID>"
        };
        await driver.execute('mobile: axeStartSession', axeSettings);
        ...
    })

Nota: Anche se sarai ancora in grado di salvare i risultati localmente, omettere il projectId genererà un avviso di deprecazione. Raccomandiamo fortemente di includere questo valore con axeStartSession.

Se la tua intenzione è solo quella di salvare i risultati localmente, imposta axeUploadResults su false. Quando axeUploadResults: false, non è necessario fornire un projectId.

    beforeAll(async () => {
        ...
        const axeSettings = {
            apiKey: "<DEQUE_APIKEY>",
            axeUploadResults: false
        };
        await driver.execute('mobile: axeStartSession', axeSettings);
        ...
    })

Inizia una sessione di test con una chiave di licenza offline

L'automazione offline è disponibile per i driver Appium, ma richiederà una chiave di licenza offline per scopi di autenticazione. Ti preghiamo di contattare il tuo rappresentante Deque o supporto contatti per coordinare la consegna della tua chiave di licenza. Quindi usa lo snippet qui sotto per connetterti al driver Appium. Scopri di più su come utilizzare i nostri driver Appium offline per eseguire scansioni di accessibilità senza effettuare richieste di rete in Domande frequenti.

    beforeAll(async () => {
        ...
        await driver.execute('mobile: axeStartSession', { licenseKey: "<DEQUE_OFFLINE_LICENSE_KEY>" });
        ...
    }

Cosa fare dopo?

Ora che hai configurato i tuoi test Appium, sei pronto per scansionare la tua app mobile. Facoltativamente, puoi personalizzare la tua configurazione prima di eseguire la scansione, utilizzando le nostre API per nominare le tue scansioni, ignorare determinati risultati, etichettare le scansioni e altro ancora.