Migreer Appium-plugin naar 2.0.0
Gids om vroege gebruikers naar de nieuwste wijzigingen van Axe DevTools Mobile voor Appium te migreren.
Opmerking: Als je net begint met Axe DevTools Mobile voor Appium, ga dan naar de installatiegids.
Bedankt voor de feedback! We hebben enkele wijzigingen doorgevoerd in onze Appium-plugin om u beter van dienst te zijn en aan te sluiten bij hoe u tegenwoordig mobiele apps test. Als u versie 1.0.0 van de Appium-plugin heeft geïmplementeerd, volg dan deze gids voor eenvoudige stappen naar 2.0.0.
Update naar versie 2.0.0
Verwijder axeDevToolsMobile:
appium plugin uninstall axeDevToolsMobileEen nieuwe installatie van de plugin zal de nieuwste versie ophalen. Installeer de plugin in uw Appium-instantie via de opdrachtregel:
appium plugin install --source=npm @axe-devtools/appium-pluginUpdate Capabilities
Kopieer vanuit je Appium-automatiseringsscripts de 'key'-mogelijkheid die eerder nodig was voor de API-sleutel van Axe DevTools Mobile, en verwijder deze vervolgens.
De API-sleutel zal worden verplaatst naar een instellingenobject dat moet worden doorgegeven aan de executeScript-methode van Appium.
U kunt overwegen om een hulpfunctie toe te voegen aan uw testscript als centrale plek om een toegankelijkheidsscan te starten.
Update Hoe te scannen op toegankelijkheidsproblemen
Voorheen onderschepte de plugin de page source-methode van Appium om te controleren op toegankelijkheidsproblemen. Dit is vervangen zodat page source nog steeds gebruikt kan worden in tests zoals u dat eerder deed!
Vervang overal waar je een toegankelijkheidstest wilt starten, de aanroepen van de page source API door execute script API.
executeScript("axe:scan", Instellingen)
| Param | Type | Beschrijving |
|---|---|---|
| Instellingen | Object |
Bevat de vereiste configuraties voor Axe DevTools Mobile. (Zie Vereiste Sleutels in Instellingen). |
| PageSource | String |
Optioneel: Als je al de PageSource voor het huidige scherm hebt verkregen, kun je deze aan Axe DevTools Mobile leveren zonder die querykosten opnieuw te maken. Opmerking: Als u merkt dat de schermafbeelding en resultaten niet overeenkomen in het dashboard, kan de PageSource verouderd zijn en mag deze niet worden gebruikt. |
Vereiste Sleutels in Instellingen
| Sleutel | Type | Beschrijving |
|---|---|---|
| apiKey | String |
Vereist door Deque om toegang te bieden aan geautoriseerde gebruikers. Toegang tot je Axe DevTools Mobile API-sleutel in het Axe-account-portaal. |
Voorbeelden
Hier is een voorbeeld van de hierboven genoemde wijzigingen. Volledige voorbeelden zijn beschikbaar in andere clienttalen.
Voorbeeld in Python
def runAccessibilityScan(self):
settings = {}
settings['apiKey'] = "<your-api-key-here>"
return self.driver.execute_script('axe:scan', settings)Voorbeeld met PageSource in Python
def runAccessibilityScan(self):
settings = {}
settings['apiKey'] = "<your-api-key-here>"
pageSource = self.driver.page_source
return self.driver.execute_script('axe:scan', settings, pageSource)