Migreer Appium-plugin naar 2.0.0
Gids om vroege adopters over te zetten naar de laatste wijzigingen van axe DevTools Mobile voor Appium.
Opmerking: Als u 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 uw Appium-automatiseringsscripts vervolgens de 'key'-mogelijkheid die eerder vereist was voor de API-sleutel van axe DevTools Mobile en verwijder deze.
De API-sleutel wordt 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!
Waar u ook een toegankelijkheidstest wilt starten, vervang dan gevallen van het aanroepen van de page source API met de 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 u de PageSource voor het huidige scherm al heeft opgehaald, kunt u deze aan axe DevTools Mobile verstrekken 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 verlenen aan geautoriseerde gebruikers. Toegang tot uw axe DevTools Mobile API-sleutel op 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)