Häufig gestellte Fragen

Android

Mobile Analyzer

Automatisierte Tests

Wir bieten Offline-Builds unserer SDKs und Appium-Treiber für Ihre Automatisierungspipeline an, die keine Netzwerkverbindungen zum Axe DevTools Mobile Service erfordern. Diese Build-Konfigurationen sind daher nur verfügbar über Deque's Artifactoryfinden.

Bitte beachten Sie, dass dieser Build ein Teilset von Funktionen innerhalb von Axe DevTools Mobile für Android ist. Um den vollständigen Funktionsumfang zu nutzen, einschließlich dem Versenden von Ergebnissen an das Dashboard, verwenden Sie bitte unsere Standard-SDKs oder Appium-Treiber. Verweisen Sie auf den Erste-Schritte-Leitfadenfinden.

Setup

Beim Durchsehen der Dokumentation beachten Sie bitte, dass nicht alle Funktionen, die eine Server-Interaktion erfordern, im Offline-Build verfügbar sind.

Einrichtung für Tests

In der applicationDatei build.gradle , fügen Sie hinzu:

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

Stellen Sie sicher, dass in der AndroidManifest.xmlInternetberechtigungen vorhanden sind:

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

Espresso-Testbeispiel

Beachten Sie, dass die axe.loginWithUsername(...) und die axe.loginWithApiKey(...) in dieser Version der Bibliothek nicht verfügbar sind und aus dem Setup-Code entfernt werden sollten, wenn Sie von der authentifizierten Version wechseln.

Layout-unabhängig

@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()   
    }
}

Ergebnisse

iOS

Mobile Analyzer

Schnelle Lösung

1. Öffnen Sie Xcode → Gehen Sie zu Xcode > Settings (oder Preferences bei älteren Versionen)
2. Wählen Sie den Accounts Reiter
3. Wählen Sie Ihr Apple ID
4. Klicken Sie auf Manage Certificates
5. Finden Sie das abgelaufene Zertifikat (es wird ein Warnsymbol haben)
6. Wählen Sie das abgelaufene Zertifikat aus und klicken Sie auf die Minus-Taste (−), um es zu entfernen.
7. Klicken Sie auf die Plus-Taste (+) und wählen Sie Apple Development aus, um ein neues Zertifikat zu erstellen.
8. Schließen Sie die Mobile Analyzer-App
9. Starten Sie die App erneut. Verweisen Sie auf Testen von iOS-Apps auf Barrierefreiheit bei Bedarf.

Erhalten Sie immer noch einen Fehler?

Manchmal cached Xcode das alte Zertifikat. Versuchen Sie Folgendes:

1. Widerrufen Sie das Zertifikat in Ihrem Apple Developer-Konto:
   • Gehen Sie zu developer.apple.com
   • Navigieren Sie zu Certificates, Identifiers & Profiles
   • Finden Sie das abgelaufene Zertifikat und widerrufen Sie es
   • Kehren Sie zu Xcode zurück und wiederholen Sie die obigen Schritte, um ein neues zu erstellen
2. Abgeleitete Daten löschen:
   • In Xcode: Window > Organizer > Projects Reiter
   • Wählen Sie Ihr Projekt und klicken Sie auf Delete neben Derived Data
3. Starten Sie Xcode nach diesen Änderungen neu

1. Erhalten Sie die UDID (Unique Device Identifier) Ihres Geräts:
   • Verbinden Sie Ihr iPhone mit Ihrem Mac
   • Öffnen Sie Finder (macOS Catalina oder neuer) oder iTunes (ältere Versionen)
   • Wählen Sie Ihr Gerät aus und klicken Sie auf die Seriennummer, bis sie die UDID anzeigt
   • Rechtsklicken Sie und kopieren Sie die UDID
   • Alternativ können Sie öffnen Xcode: Window > Devices and Simulators, wählen Sie Ihr Gerät aus und kopieren Sie die Kennung
2. Fügen Sie das Gerät zu Ihrem Entwicklerkonto hinzu:
   • Gehen Sie zu developer.apple.com und melden Sie sich an
   • Navigieren Sie zu Certificates, Identifiers & Profiles
   • Wählen Sie Devices in der Seitenleiste aus
   • Klicken Sie auf das Pluszeichen (+) um ein neues Gerät zu registrieren
   • Geben Sie einen Namen für Ihr Gerät ein und fügen Sie die UDID ein
   • Klicken Sie auf Continue und dann auf Register
3. Starten Sie den Mobile Analyzer neu:
   • Schließen Sie die Mobile Analyzer-App
   • Starten Sie die App erneut. Sehen Sie nach unter Testen von iOS-Apps auf Barrierefreiheit , falls notwendig

Beachten Sie, dass kostenlose Apple-Entwicklerkonten bis zu 3 Geräte registrieren können, während kostenpflichtige Konten bis zu 100 Geräte pro Gerätetyp registrieren können (100 iPhones, 100 iPads usw.).

Automatisierte Tests

Wir bieten Offline-Builds unserer SDKs und Appium-Treiber für Ihre Automatisierungspipeline an, die keine Netzwerkanfragen an den Axe DevTools Mobile-Dienst erfordern. Diese Build-Konfigurationen sind daher nur über Deque's Artifactoryfinden.

Bitte beachten Sie, dass dieser Build ein Teil der Funktionalitäten innerhalb von axeDevToolsXCUI ist. Um die vollständigen Funktionen, einschließlich des Übertragens von Ergebnissen an das Dashboard, zu nutzen, verwenden Sie bitte unser axeDevToolsXCUI-Framework. Weitere Informationen finden Sie im Einrichtungsanleitungfinden.

Einrichtung

1. Importieren Sie das Framework in jede Datei, die für Barrierefreiheitstests verwendet wird.

import axeDevToolsXCUI_noauth

2. Erstellen Sie ein Objekt innerhalb Ihrer Testklasse, um die Axe DevTools-Instanz zu speichern:

var axeDevTools: AxeDevTools?

3. Initialisieren Sie das Framework in den Methoden setUp oder setUpWithError.

axeDevTools = AxeDevTools.startScanSession()

Vollständiges Einrichtungbeispiel

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??
    }
    ...
}

UI-Testen

Um mit dem Testen zu beginnen, übergeben Sie dem Framework beliebige XCUIElement, um Barrierefreiheitstests dagegen und seine Kinder durchzuführen.

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

Vollständiges Beispiel

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
    }
}

Was kommt als Nächstes?

Wir geben Ihnen die Daten und Werkzeuge, um einen CI/CD-Workflow zu erstellen, der Ihrem Team hilft. Hier sind einige Vorschläge, was Sie mit diesem Ergebnissobjekt tun können:

1. Schlagen Sie den Build fehl, wenn Fehler gefunden wurden. Wenn Sie einen Bildschirm haben, der bereits frei von Barrierefreiheitsproblemen ist, möchten Sie möglicherweise sicherstellen, dass keine neuen im Entwicklungszyklus auftreten, indem Sie sicherstellen, dass die Anzahl 0 beträgt und den Pull-Request-Status-Check fehlschlagen lassen, wenn dies nicht der Fall ist.

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

2. Speichern Sie die Ergebnisse lokal, um einen eingeschränkten Bericht über die im Branch gefundenen Probleme zu erstellen. Sehen Sie sich die Erstellung eines Berichts mit unserem Reporter-CLI für CICD-Pipelines an. Dies kann wirklich nützlich für Release-Kandidaten oder Beta-Branches sein, um ein Bewusstsein dafür zu schaffen, welche potenziellen Hürden für Kunden, die assistive Technologie verwenden, auftreten könnten.

Ergebnisse

Suchen Sie Ihre Projekt-ID? Sie können diese auf der Hauptprojektseite im Axe Developer Hubfinden.

• Gehen Sie zu „Einstellungen“ für Ihr Projekt und wählen Sie „Projekt konfigurieren“.
• In den „Projektdetails“ können Sie die Projekt-ID finden und kopieren.
• Stellen Sie sicher, dass Sie diese Projekt-ID an die startScanSession -Methode übergeben haben.