Domande Frequenti

Android

Mobile Analyzer

Test Automatizzati

Offriamo build offline dei nostri SDK e driver Appium per la tua pipeline di automazione che non richiedono alcuna richiesta di rete al servizio Axe DevTools Mobile. Pertanto, queste configurazioni di build sono disponibili solo attraverso Artifactory di Deque.

Si noti che questa build è un sottoinsieme delle funzionalità di Axe DevTools Mobile per Android. Per utilizzare l'intero set di funzionalità, incluso l'invio dei risultati alla dashboard, si prega di utilizzare i nostri SDK standard o driver Appium. Fai riferimento al guida introduttiva.

Setup

Durante la navigazione nella documentazione, nota che non tutte le funzionalità che richiedono interazione con il server sono disponibili nella build offline.

Configurazione per il Test

Nel applicationdel build.gradle file, aggiungi:

android {
    packagingOptions {
        exclude 'META-INF/DEPENDENCIES'
        exclude 'META-INF/AL2.0' 
        exclude 'META-INF/LGPL2.1'
    }
}

Assicurati che vi sia il permesso di Internet nel AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET" />

Nota che

Nota che il axe.loginWithUsername(...) e axe.loginWithApiKey(...) non sono disponibili in questa versione della libreria e dovrebbero essere rimossi dal codice di configurazione se stai convertendo dall'uso della versione autenticata.

Risultati

@RunWith(AndroidJUnit4::class)
class ExampleInstrumentedTest {
    @Rule    
    @JvmField    
    var rule: ActivityScenarioRule<MainActivity> = ActivityScenarioRule(MainActivity::class.java)

    companion object {
        private val axe = AxeDevTools()
        init {
            axe.setOfflineLicenseKey("deque_provided_license_key_here")
        }
        axe.setInstrumenation(InstrumentationRegistry.getInstrumentation())
    }

    @Test    
    fun exampleTest() {
        onView(withText("Example Button Name")).perform(click())
    }

    @After    
    fun runAccessibilityScan() {
        val scan = axe.scan()
        val result = scan?.getSerializedResult()

        axe.tearDown()   
    }
}

Risultati

iOS

Mobile Analyzer

Soluzione Rapida

1. Apri Xcode → Vai a Xcode > Settings (o Preferences nelle versioni precedenti)
2. Seleziona la scheda Accounts Seleziona il tuo
3. Fai clic su Apple ID
4. Click Manage Certificates
5. Trova il certificato scaduto (avrà un'icona di avvertimento)
6. Seleziona il certificato scaduto e fai clic sul pulsante meno (−) per rimuoverlo
7. Fai clic sul pulsante più (+) e seleziona Apple Development per creare un nuovo certificato
8. Chiudi l'app Analizzatore Mobile
9. Avvia di nuovo l'app. Fai riferimento a Testare le App iOS per l'Accessibilità se necessario

Ricevi ancora un errore?

A volte Xcode memorizza nella cache il vecchio certificato. Prova il seguente:

1. Revoca il certificato nel tuo account Apple Developer:
   • Vai a developer.apple.com
   • Naviga a Certificates, Identifiers & Profiles
   • Trova il certificato scaduto e revocalo
   • Torna a Xcode e ripeti i passaggi sopra per crearne uno nuovo
2. Cancella i dati derivati:
   • In Xcode: Window > Organizer > Projects scheda
   • Seleziona il tuo progetto e fai clic su Delete accanto a Derived Data
3. Riavvia Xcode dopo aver effettuato queste modifiche

1. Ottieni l'UDID (Identificatore Unico del Dispositivo) del tuo dispositivo:
   • Collega il tuo iPhone al tuo Mac
   • Apri Finder (macOS Catalina o successivo) o iTunes (versioni precedenti)
   • Seleziona il tuo dispositivo e fai clic sul numero di serie fino a quando viene visualizzato l'UDID
   • Fai clic destro e copia l'UDID
   • In alternativa, puoi aprire Xcode: Window > Devices and Simulators, seleziona il tuo dispositivo e copia l'identificatore
2. Aggiungi il dispositivo al tuo account Developer:
   • Vai su developer.apple.com e accedi
   • Vai a Certificates, Identifiers & Profiles
   • Seleziona Devices dalla barra laterale
   • Fai clic sul pulsante più (+) per registrare un nuovo dispositivo
   • Inserisci un nome per il tuo dispositivo e incolla l'UDID
   • Fai clic su Continue e poi su Register
3. Rilancia l'Analizzatore Mobile:
   • Chiudi l'app Analizzatore Mobile
   • Avvia nuovamente l'app. Consulta Testare le App iOS per l'Accessibilità se necessario

Tieni presente che gli account gratuiti Apple Developer possono registrare fino a 3 dispositivi, mentre gli account a pagamento possono registrare fino a 100 dispositivi per tipo di dispositivo (100 iPhone, 100 iPad, ecc.).

Test Automatizzati

Offriamo build offline dei nostri SDK e driver Appium per il tuo pipeline di automazione che non richiedono richieste di rete al servizio Axe DevTools Mobile. Come tale, queste configurazioni di build sono disponibili solo attraverso Artifactory di Deque.

Si prega di notare che questa build è un sottoinsieme delle funzionalità all'interno di axeDevToolsXCUI. Per utilizzare il set completo di funzionalità, incluso l'invio dei risultati al cruscotto, si prega di utilizzare il nostro framework axeDevToolsXCUI. Fare riferimento a guida alla configurazione.

Configurazione

1. Importa il framework in ogni file utilizzato per i test di accessibilità.

import axeDevToolsXCUI_noauth

2. Crea un oggetto all'interno della tua classe di test per conservare l'istanza di Axe DevTools:

var axeDevTools: AxeDevTools?

3. Inizializza il framework all'interno dei metodi setUp o setUpWithError.

axeDevTools = AxeDevTools.startScanSession()

Esempio Completo di Configurazione

import axeDevToolsXCUI_noauth
import XCTest

class MyUITests: XCTestCase {

    var axeDevTools: AxeDevTools?

    override func setUpWithError() throws {
        axeDevTools = AxeDevTools.loginWithLicenseKey("deque_provided_license_key_here") // does this change??
    }
    ...
}

Test UI

Per iniziare i test, inserisci qualsiasi XCUIElement nel framework per eseguire test di accessibilità su di esso e sui suoi figli.

let result = try axeDevTools.run(onElement: XCUIApplication())

Esempio Completo

import XCTest
import axeDevToolsXCUI_noauth

final class XCUI_noAuthUITest: XCTestCase {
    var axeDevTools: AxeDevTools = AxeDevTools.startScanSession()

    override func setUpWithError() throws {
        continueAfterFailure = false
    }

    func testExample() throws {
        let app = XCUIApplication()
        app.launch()

        let result = try axeDevTools.run(onElement: app)
        // Do something with the result
    }
}

Cosa succede dopo?

Ti forniamo i dati e gli strumenti per creare un flusso di lavoro CI/CD che aiuti il tuo team. Ecco alcuni suggerimenti su cosa fare con quell'oggetto risultato:

1. Blocca il build se sono stati trovati errori. Se hai uno schermo che è già stato liberato da problemi di accessibilità, potresti voler assicurarti che non ne appaiano di nuovi nel ciclo di sviluppo, affermando che il conteggio è 0, e fallendo il controllo dello stato della pull-request se non lo è.

// Add an assertion to fail the build if issues were found
XCTAssertTrue(result.failures.count > 0)

2. Salva i risultati localmente per creare un report limitato dei problemi trovati nel branch. Controlla la creazione di un report con il nostro CLI Reporter per pipeline CICD. Questo può essere davvero utile per i branch candidati al rilascio o beta per portare consapevolezza su quali potenziali ostacoli potrebbero affrontare i clienti che utilizzano tecnologie assistive.

Risultati

Cerchi il tuo ID Progetto? Puoi accedervi dalla pagina principale dei Progetti in Axe Developer Hub.

• Vai su 'Impostazioni' del tuo progetto e seleziona 'Configura Progetto'.
• Nella sezione 'Dettagli del Progetto' puoi trovare e copiare l'ID Progetto.
• Assicurati di aver fornito questo ID Progetto al startScanSession metodo.