Questions fréquentes

Android

Analyseur Mobile

Tests automatisés

Nous proposons des builds hors ligne de nos SDK et pilotes Appium pour votre pipeline d'automatisation, qui ne nécessitent aucune requête réseau vers le service Axe DevTools Mobile. En tant que tel, ces configurations de build ne sont disponibles que via l'Artifactory de Deque.

Veuillez noter que ce build est un sous-ensemble des fonctionnalités d'Axe DevTools Mobile pour Android. Pour utiliser l'ensemble complet des fonctionnalités, y compris l'envoi des résultats au tableau de bord, veuillez utiliser nos SDK ou pilotes Appium standards. Référez-vous à la guide de démarrage.

Setup

Lors de la navigation dans la documentation, veuillez noter que toutes les fonctionnalités nécessitant une interaction avec le serveur ne sont pas disponibles dans la version hors ligne.

Configuration pour les tests

Dans le applicationfichier, ajoutez : build.gradle fichier, ajoutez :

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

Assurez-vous qu'il y a l'autorisation Internet dans le AndroidManifest.xml:

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

Exemple de test Espresso

Notez que le axe.loginWithUsername(...) et le axe.loginWithApiKey(...) ne sont pas disponibles dans cette version de la bibliothèque et doivent être retirés du code de configuration si vous passez de l'utilisation de la version authentifiée.

Agnostique en matière de mise en page

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

Résultats

iOS

Analyseur Mobile

Solution rapide

1. Ouvrez Xcode → Allez à Xcode > Settings (ou Preferences sur les versions plus anciennes)
2. Sélectionnez l'onglet Accounts Sélectionnez l'onglet
3. Sélectionnez votre Apple ID
4. Cliquez sur Manage Certificates
5. Trouvez le certificat expiré (il aura une icône d'avertissement)
6. Sélectionnez le certificat expiré et cliquez sur le bouton moins (−) pour le supprimer
7. Cliquez sur le bouton plus (+) et sélectionnez Apple Development pour créer un nouveau certificat
8. Fermez l'application Mobile Analyzer
9. Lancez à nouveau l'application. Référez-vous à Tester les applications iOS pour l'accessibilité si nécessaire

Vous recevez toujours une erreur ?

Xcode met parfois en cache l'ancien certificat. Essayez ce qui suit :

1. Révoquez le certificat dans votre compte Apple Developer :
   • Allez sur developer.apple.com
   • Naviguez vers Certificates, Identifiers & Profiles
   • Trouvez le certificat expiré et révoquez-le
   • Retournez à Xcode et répétez les étapes ci-dessus pour en créer un nouveau
2. Effacer les données dérivées :
   • Dans Xcode: Window > Organizer > Projects onglet
   • Sélectionnez votre projet et cliquez sur Delete à côté de Derived Data
3. Redémarrez Xcode après avoir effectué ces changements

1. Obtenez l'UDID (Identifiant Unique de l'Appareil) de votre appareil :
   • Connectez votre iPhone à votre Mac
   • Ouvrir Finder (macOS Catalina ou plus récent) ou iTunes (versions plus anciennes)
   • Sélectionnez votre appareil et cliquez sur le numéro de série jusqu'à ce qu'il affiche l'UDID
   • Cliquez avec le bouton droit et copiez l'UDID
   • Alternativement, vous pouvez ouvrir Xcode: Window > Devices and Simulators, sélectionnez votre appareil et copiez l'identifiant
2. Ajoutez l'appareil à votre compte Developer :
   • Allez sur developer.apple.com et connectez-vous
   • Accédez à Certificates, Identifiers & Profiles
   • Sélectionnez Devices dans la barre latérale
   • Cliquez sur le plus (+) pour enregistrer un nouvel appareil
   • Entrez un nom pour votre appareil et collez l'UDID
   • Cliquez sur Continue puis Register
3. Relancer le Mobile Analyzer :
   • Fermez l'application Mobile Analyzer
   • Relancez l'application. Référez-vous à Tester les applications iOS pour l'accessibilité si nécessaire

Gardez à l'esprit que les comptes Apple Developer gratuits peuvent enregistrer jusqu'à 3 appareils, tandis que les comptes payants peuvent enregistrer jusqu'à 100 appareils par type d'appareil (100 iPhones, 100 iPads, etc.).

Tests automatisés

Nous proposons des compilations hors ligne de nos SDKs et pilotes Appium pour votre pipeline d'automatisation qui ne nécessitent aucune requête réseau vers le service Axe DevTools Mobile. Ainsi, ces configurations de compilation sont uniquement disponibles via l'Artifactory de Deque.

Veuillez noter que cette version est un sous-ensemble des capacités de axeDevToolsXCUI. Pour utiliser l'ensemble complet des capacités, y compris l'envoi des résultats au tableau de bord, veuillez utiliser notre framework axeDevToolsXCUI. Référez-vous à guide de configuration.

Configuration

1. Importez le framework dans n'importe quel fichier utilisé pour les tests d'accessibilité.

import axeDevToolsXCUI_noauth

2. Créez un objet au sein de votre classe de test pour conserver l'instance de Axe DevTools :

var axeDevTools: AxeDevTools?

3. Initialisez le framework dans les méthodes setUp ou setUpWithError.

axeDevTools = AxeDevTools.startScanSession()

Exemple de configuration complète

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

Tests UI

Pour commencer le test, passez un XCUIElement au framework pour effectuer des tests d'accessibilité sur celui-ci et ses enfants.

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

Exemple complet

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

Quelle est la suite ?

Nous vous fournissons les données et outils pour créer un flux de travail CI/CD qui aide votre équipe. Voici quelques suggestions pour ce que vous pouvez faire avec cet objet de résultat :

1. Échouez la construction si des échecs ont été trouvés. Si vous avez un écran qui a déjà été nettoyé des problèmes d'accessibilité, vous pouvez vouloir vous assurer qu'aucun nouveau ne s'y glisse au cours du cycle de développement en vérifiant que le compte est de 0, et échouez la vérification de l'état de la demande de tirage s'il ne l'est pas.

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

2. Sauvegardez les résultats localement pour créer un rapport cible des problèmes trouvés dans la branche. Consultez la création d'un rapport avec notre CLI Reporter pour les pipelines CICD. Cela peut être très utile pour les branches candidates à la version ou bêta afin de sensibiliser aux obstacles potentiels pour les clients utilisant des technologies d'assistance.

Résultats

Vous cherchez votre ID de projet ? Vous pouvez y accéder depuis la page principale des projets dans Axe Developer Hub.

• Allez dans 'Paramètres' de votre projet et sélectionnez 'Configurer le projet'.
• Dans les 'Détails du projet', vous pouvez trouver et copier l'ID de projet.
• Assurez-vous d'avoir fourni cet ID de projet à la startScanSession méthode.