UIAutomatorViewer-opetusohjelma: Inspector for Android Testaus
Thomas Hamilton
⚡ Älykäs yhteenveto
UIAutomatorViewer on graafinen tarkastaja, joka sisältyy Android SDK, joka tallentaa laitteen kuvakaappauksen, renderöi näkymähierarkian ja paljastaa attribuutit Appium täytyy paikantaa painikkeet, kentät ja otsikot luotettavasti.
Mikä on UIAutomatorViewer?
UIAutomatorViewer on graafinen käyttöliittymätyökalu, jolla voidaan skannata ja analysoida käyttöliittymän komponentteja. Android sovelluksen. Voit automatisoida minkä tahansa Android sovellus käyttäen Appium, käyttäjän on tunnistettava testattavan sovelluksen (AUT) objektit. UIAutomatorViewerilla voit tarkastella testattavan sovelluksen käyttöliittymää. Android sovellus elementin hierarkian selvittämiseksi ja eri ominaisuuksien (id, teksti…) tarkastelemiseksi.
Kun suoritat automaatiokoodeja, Appium käyttää UIAutomatorVieweria objektin eri ominaisuuksien tunnistamiseen ja käyttää ominaisuuksia tarvittavan objektin tunnistamiseen. Tätä yhtä ideaa – lukea attribuutti tarkastajassa ja käyttää sitä sitten uudelleen paikantimena komentosarjassa – käydään läpi loppuosa tästä sivusta.
Alla olevassa kuvakaappauksessa työkalu näkyy normaalissa toimintatilassa: kaapattu laitteen näyttö vasemmalla, solmupuu oikeassa yläkulmassa ja valitun solmun ominaisuussivu sen alla.
UIAutomatorViewerin käytön edellytykset
Tarkastaja lukee oikean laitteen tai emulaattorin reaaliaikaista näyttöä, joten pieni määrä asetuksia on tehtävä ennen kuin ikkunassa näkyy yhtään mitään.
- A Java Kehityspaketti: uiautomatorviewer on Java työpöytäsovellus käynnistetään komentosarjalla, joten JDK:n on oltava asennettuna ja saavutettavissa järjestelmäpolussa.
- Android SDK: katseluohjelma toimitetaan SDK:n sisällä työkalut kansio, joten SDK on asennettava ennen kuin käynnistysohjelma on levyllä.
- Alustatyökalut ja adb: katsoja puhuu laitteelle sen kautta Android Debug Bridge, joten ADB on oltava asennettuna ja sen on nähtävä luuri.
- Kehittäjäasetukset ja USB-virheenkorjaus: Molempien on oltava päällä laiteasetuksissa, muuten ADB ei koskaan listaa laitetta.
- Tiedonsiirtokykyinen USB-kaapeli ja ajuri: vain latausta varten tarkoitettu kaapeli tai puuttuva valmistajan ajuri Windows, tuottaa tyhjän laiteluettelon.
- Testattava sovellus: Sovelluksen on oltava asennettuna ja auki laitteella, koska tarkastaja tallentaa kaiken, mitä näytöllä on kulloinkin.
Kun nämä kuusi kohtaa ovat paikoillaan, latausvaihe on lyhyt.
UIAutomatorViewerin lataaminen ja asentaminen
UIAutomatorViewer on osa Android SDK-hallinta ja se on käytettävissä, kun olet asentanut SDK-hallinnan. Lataa ja asenna Android SDK-tiedosto virallinen Android Studio ladata sivu.
Kun Android SDK on asennettu, siirry tähän polkuun:
c:\users\<username>\AppData\Local\Android\sdk\tools
Huomaat erätiedoston, jolla on tämä nimi:
uiautomatorviewer.bat
Double napsauta sitä käynnistääksesi UIAutomatorViewer-käyttöliittymän. Kansioluettelo näyttää alla olevan kaltaiselta, ja eräajotiedosto sijaitsee muiden SDK-työkalujen rinnalla.
⚠️ Versiohuomautus: Androidoma UI Automatorin vanha dokumentaatio kuvaa edelleen työkalun käynnistämisen osoitteesta /työkalut/, mutta vanhentunut erillinen Android SDK-työkalut SDK Manager ei enää tarjoa pakettia nykyisessä Android Studio julkaisut. Pitkäaikaiset asennukset ja vanhemmat SDK-arkistot sisältävät edelleen käynnistysohjelman; uudessa asennuksessa tiedosto yleensä puuttuu, ja Appium Inspector on käytännöllinen korvaaja. Yllä olevat alkuperäiset vaiheet säilytetään, koska ne pysyvät oikein kaikissa koneissa, joissa on edelleen työkalukansio.
Kuinka käyttää UIAutomatorVieweria objektien löytämiseen sovelluksestasi
Kuvausjärjestys on aina sama: valmistele laite, aseta haluamasi näyttö kameran eteen ja ota sitten tilannekuva.
- Enable kehittäjävaihtoehtoja laitteellasi. Lue Androidopas laitteen kehittäjäasetusten määrittämiseen nähdäksesi, miten kehittäjäasetukset otetaan käyttöön Android laitteita.
- Liitä Android laite tietokoneeseen USB-kaapelilla.
- Valitse "Guru99”-sovellus sovellusluettelosta, kuten alla on esitetty.
- Valitse Laitteen kuvakaappaus -painiketta UIAutomatorViewerin päivittämiseksi ja tiedoston lataamiseksi. Guru99 sovelluksen graafinen käyttöliittymä työkaluun. Painike sijaitsee alla korostetussa työkalupalkissa.
- Kun päivitys on valmis, näyttökuva Guru99-sovellus avautuu vasemmassa ruudussa.
- Kuten yllä olevassa kuvassa näkyy, ikkunan oikealla puolella on 2 paneelia.
Yläpaneeli sisältää solmuhierarkian – tavan, jolla käyttöliittymäkomponentit on järjestetty ja sisällytetty. Kunkin solmun napsauttaminen näyttää kyseisen käyttöliittymäelementin ominaisuudet alapaneelissa.
- Valitse yllä olevasta kuvasta 'Testi'-painike nähdäksesi sen eri ominaisuudet (teksti, resurssin tunnus…).
Näiden ominaisuuksien käyttäminen automaation elementtien tunnistamiseen
Et voi käyttää ominaisuuksia suoraan – jokaisella ominaisuudella on eri nimi automaatio-API:ssa. Katsotaanpa, miten nämä ominaisuusarvot saadaan toimimaan. Seuraavia attribuutteja voidaan käyttää 'Quiz'-painikkeen tunnistamiseen Guru99 sovellusta.
| UIAutomatorViewer-ominaisuuden ominaisuus | Paikannin nimi komentosarjassa | Tyypillinen käyttö |
|---|---|---|
| teksti | nimi | Näkyvä otsikko painikkeessa tai staattisessa kentässä |
| resurssitunnus | id | Vakain valinta, kun kehittäjä asettaa sellaisen |
| luokka | luokan nimi | Saman tyyppisten widgetien ryhmän valitseminen |
| content-desc | esteettömyystunnus | Eri alustojen paikannin, joka auttaa myös näytönlukijoita |
Jokainen karttaping näkyy suoraan solmun tietopaneelissa. teksti attribuuttia voidaan käyttää ”nimenä”, kuten alla oleva ominaisuusrivi osoittaa.
resurssitunnus attribuuttia voidaan käyttää ”id”-attribuuttina.
luokka attribuuttia voidaan käyttää muodossa ”className”.
content-desc attribuuttia voidaan käyttää muodossa ”AccessibilityId”.
Yllä mainittujen attribuuttien lisäksi voimme kirjoittaa XPath-lausekkeita objektien tunnistamista varten. Näiden attribuuttien nimet ovat myös se, minkä läpi välität halutut ominaisuudet ja paikannusstrategioita, kun skripti on käynnissä.
XPath-paikantimien rakentaminen UIAutomatorViewer-attribuuteista
XPath on varamenetelmä, kun mikään yksittäinen attribuutti ei ole yksinään ainutlaatuinen. Solmun tietopaneeli näyttää kaikki lausekkeen tarvitsemat arvot, joten XPath on oikeastaan vain jo lukemasi attribuutti predikaattimuodossa.
Käy paneeli läpi tässä järjestyksessä:
- Valitse solmu yläpaneelista ja lue sen luokka, teksti, resurssitunnus ja content-desc arvot alemmassa paneelissa.
- Käytä mieluiten yhtä vakaata attribuuttia. Jos resurssin tunnus on täytetty, käytä sitä ja lopeta — XPath-lauseketta ei tarvita.
- Jos mikään ei ole ainutlaatuista, yhdistä kaksi attribuuttia yhteen predikaattiin.
- Jos otsikko muuttuu suorituksen aikana, vaihda yhtäläisyystesti osittaiseen osumaan.
Alla olevat mallit käyttävät attribuuttien nimiä täsmälleen sellaisina kuin UIAutomatorViewer ne raportoi.
<!-- match on the visible label --> //*[@text='Quiz'] <!-- match on the resource-id reported by the viewer --> //*[@resource-id='com.example.app:id/quiz_button'] <!-- match on the widget class --> //android.widget.Button[@text='Quiz'] <!-- partial match when the label is dynamic --> //*[contains(@text,'Qui')] <!-- two attributes combined for a unique match --> //*[@class='android.widget.Button' and @content-desc='Quiz']
Muutamat säännöt estävät näitä lausekkeita haurastumasta. Koko puun läpi kulkevat absoluuttiset polut katkeavat heti, kun kehittäjä käärii asettelun yhteen uuteen säiliöön, joten aloita jokainen lauseke kaksoisvinoviivalla ja etsi vastaavuus attribuutin perusteella. Indeksipohjaiset predikaatit toimivat samalla tavalla – ne säilyvät, kunnes näyttöön tulee rivi. Ja puhelimen näytöllä ainutlaatuinen lauseke voi vastata useita solmuja tablettiasettelussa, joten tarkista sama näyttö uudelleen molemmilla kokotekijöillä ennen paikantimen siirtämistä sarjaan. Sama kurinalaisuus koskee XPath sisään Selenium, jossa puu on DOM pikemminkin kuin näkymähierarkia.
UIAutomatorViewerin käytössä mahdollisesti ilmenevät virheet
Useimmat viat tapahtuvat ennen kuin yksikään solmu on piirretty, ja lähes kaikki niistä palautuvat työaseman ja luurin väliseen yhteyteen.
- Näen virheen — ”Ei Android adb havaitsi laitteet” — kuten alla olevassa kuvakaappauksessa näkyy. Miten voin ratkaista tämän?
Ratkaisu: Varmista, että laitteesi on kytketty tietokoneeseen.
Alla oleva taulukko laajentaa vastauksen koskemaan muita useimmin testaajien kohtaamia viestejä.
| Oire | Todennäköinen syy | Korjata |
|---|---|---|
| Ei Android adb havaitsi laitteita | Laite ei ole kytkettynä, USB-virheenkorjaus pois päältä tai käytössä on vain latausta varten tarkoitettu kaapeli. | Yhdistä uudelleen datakaapelilla, ota käyttöön USB-virheenkorjaus ja varmista, että laite näkyy ADB-laiteluettelossa. |
| Laite merkitty luvattomaksi | RSA-sormenjälkikehottetta ei koskaan hyväksytty puhelimessa | Lukitse näyttö, avaa se uudelleen ja napauta Salli USB-virheenkorjaus. |
| uiautomatorviewer.bat puuttuu | Vanhentunutta SDK-työkalupakettia ei ole asennettu | Käytä olemassa olevaa SDK-asennusta, joka sisältää sen edelleen, tai vaihda Appium Tarkastaja |
| Hierarkia on tyhjä tai tallennus epäonnistuu | Näyttö muuttui vedoksen aikana tai sovellus estää näyttökuvan kaappauksen | Pidä näyttö paikallaan ja ota kuva uudelleen; suojattuja näyttökuvia ei voida tallentaa. |
| WebView-sisältö näkyy yhtenä solmuna | Katseluohjelma lukee vain natiivinäkymät | Tarkasta verkkosisältöä selainkehitystyökaluilla tai verkkokontekstia tukevalla tarkastajalla |
UIAutomatorViewer vs. Appium Tarkastaja vs. asettelun tarkastaja
Kolmea tarkastajaa käytetään yleisesti vastaan Android näytöt, ja ne ratkaisevat hieman erilaisia ongelmia.
| Kriteeri | UIAutomatorViewer | Appium Tarkastaja | Android Studio Asettelun tarkastaja |
|---|---|---|---|
| Laivat | Perintö Android SDK-työkalupaketti | Erillinen työpöytäsovellus | Android Studio |
| Tarkastetut laiturit | Android vain | Android ja iOS | Android vain |
| Tarvitsee toimivan palvelimen | Ei, se kommunikoi suoraan ADB:n kanssa | Kyllä, se yhdistyy johonkin Appium palvelinistunto | Ei, se liittyy debuggable-prosessiin |
| Luo paikannuskoodin | Ei, arvot kopioidaan käsin | Kyllä, se ehdottaa paikantimia ja voi tallentaa toimintoja | Ei, se on virheenkorjausnäkymä |
| Soveltuu parhaiten | Nopea ominaisuushaku vanhemmassa asetuksessa | Paikanninten rakentaminen ja validointi sarjalle | Asettelu- ja renderöintiongelmien diagnosointi |
Sviitille, joka jo kulkee läpi Appium, Inspector on luonnollinen seuraaja: se lukee samat attribuutit, suorittaa samaa UiAutomator2-ajuria alla ja toimii myös iOS:ää vastaan. Appium Tarkastajaprojekti julkaistaan aktiivisesti, joten se on turvallisempi valinta uusille töille, kun taas Layout Inspector on hyödyllinen, kun kysymys on siitä, miksi näkymä renderöityy oudosti, eikä siitä, miten se ratkaistaan. Jos valitset edelleen pinoa, laajempi vertailu oppaassamme mobiilisovellusten testaustyökalut on hyvä seuraava askel, ja esimerkkimobiilitestitapaukset näytä, mihin nämä paikantimet lopulta vaikuttavat.
