Calabash Android Testaustyökalun opastusohjelma

⚡ Älykäs yhteenveto

Calabash on avoimen lähdekoodin hyväksymistestauskehys, joka ohjaa todellisia käyttöliittymätoimintoja Android ja iOS-sovelluksissa selkokielellä Cucumber Ruby-vaihemääritelmien ja laitepuolen testipalvelimen tukemat skenaariot.

  • 🔸 Määritelmä: Calabash automatisoi napautukset, tekstinsyötön ja vahvistukset natiiveissa ja hybridi-mobiilisovelluksissa oikeilla laitteilla ja emulaattoreilla.
  • ☑️ Kielipino: Skenaariot kirjoitetaan Gherkin-ominaisuustiedostoihin, ja vastaavat metodit sijaitsevat Ruby-tiedostoissa step_definitions-tiedostojen sisällä.
  • ✅ BDD-säätiö: Käyttäytymislähtöinen kehitys antaa yritysten omistajille, kehittäjille ja testaajille mahdollisuuden sopia käyttäytymisestä ennen kuin yhtäkään skriptiä on olemassa.
  • 🧪 Asennusjärjestys: Java JDK, sitten Ruby ja sitten Android Studio, sitten calabash-android-jalokivi, joka on vahvistettu version-komennolla.
  • 🛠️ Suoritusprosessi: Poista APK käytöstä, rakenna testipalvelin, liitä laite, tee kysely paikantimille ja suorita sitten ominaisuustiedostot.
  • 📊 Nykyinen tila: Calabash on arkistoitu ja ylläpitämätön, joten uudet projektit yleensä valitsevat Appium, Espresso tai XCUITest sen sijaan.

Calabash testaustyökalun opastusohjelma Android näyttää Cucumber mobiilisovellusta ohjaavat ominaisuustiedostot

Mikä on Calabash?

Calabash on avoimen lähdekoodin hyväksyntä Testaus kehys, jonka avulla voit kirjoittaa ja suorittaa testejä iOS:lle ja Android Sovellukset.

Se on automatisoitu käyttöliittymäkehys, jonka avulla testejä voidaan kirjoittaa Rubylla käyttäen Cucumber.

Calabash toimii mahdollistamalla automaattiset käyttöliittymän toiminnot mobiilisovelluksessa, kuten painikkeiden painallukset, tekstin syöttämisen, vastausten validoinnin jne. Se voidaan konfiguroida toimimaan eri laitteilla Android ja iOS-laitteet, jotka tarjoavat reaaliaikaista palautetta ja vahvistuksia.

⚠️ Versiohuomautus: Microsoft lopetti lahjoituksensa Calabash viimeisen iOS 11:n jälkeen ja Android 8 julkaisua ja calabash-android-arkisto kuvailee itseään nyt projektina, joka etsii ylläpitäjää. Alla oleva läpikäynti on säilytetty sellaisenaan, ja nykyaikaiset korvaavat versiot käsitellään viimeisessä osiossa.

Miksi Calabash Automaatio?

Ennen minkään asentamista on hyödyllistä punnita, mitä kehys tarjoaa takaisin suhteessa sen ylläpitokustannuksiin.

edut Haitat
Se auttaa lisäämään suorituskykyä / tuottavuutta. Automaatiotestin skriptien kirjoittaminen edellyttää taitoa.
Parempi laatu tai lisääntynyt laadun ennustettavuus Testiohjelman virheenkorjaus on suuri ongelma.
Prosessien tai tuotteiden parannettu kestävyys (yhtenäisyys). Testin ylläpito on kallista toistomenetelmien tapauksessa.
Lisää johdonmukaisuutta tuotannon ja vähentää työvoimakustannuksia ja kuluja Testitiedostojen ylläpito on vaikeaa, jos testiskripti testaa useampia näyttöjä

Calabash ja BDD

  • Calabash is Behavior Driven Development (BDD)Se on sama kuin Test Driven Development (TDD), mutta APIen muodon kuvaavien testien luomisen sijaan määritetään sovelluksen käyttäytyminen.
  • BDD on prosessi, jossa useat sidosryhmät tekevät yhteistyötä luodakseen yhteisen käsityksen siitä, mitä on rakennettava.
  • BDD auttaa oikean ohjelmiston rakentamisessa ja suunnittelussa yrityksen omistajan näkökulmasta.

Alla oleva kaavio näyttää, miten Calabash Ohjelmistopaketti on kerroksellinen ylhäältä löytyvästä yritysluettavasta ominaisuustiedostosta aina alhaalta löytyvään laitteen vuorovaikutustiedostoon.

Calabash BDD-kerroskaavio, joka näyttää ominaisuustiedostot, vaihemääritelmät ja laitteen automaatiokerroksen

Kuinka asentaa Calabash

Calabash on Windows vaatii neljä edellytystä asennettuna järjestyksessä. Suorita jokainen osa kokonaan ennen seuraavan aloittamista, koska calabash-android-gem tarkistaa Rubyn ja Android SDK asennuksen aikana.

Osa I) Asenna Java JDK – katso tämä opas – /install-java.html

Osa II) Lataa ja asenna Ruby.

Vaihe 1) Lataa Ruby osoitteesta URL https://rubyinstaller.org/downloads

RubyInstallerin lataussivu, jolla luetellaan saatavilla olevat Ruby-versiot Windows

Vaihe 2) Avaa exe-tiedosto ja seuraa näytön ohjeita. Kun asennus on valmis, näet seuraavan näytön. Napsauta Valmis.

Rubyn asennustoiminnon valmistumisnäyttö, jossa Valmis-painike on korostettuna

Käynnistä komentokehote Rubyn ollessa päällä Windows 10 & kirjoita komento alle.

ruby -v

Konsoli tulostaa asennetun tulkin version, kuten alla näkyy.

Komentorivi, jossa Ruby näyttää asennetun Rubyn versionumeron

Osa III) Lataa ja asenna Android

Vaihe 1) Lataa Android Studio at https://developer.android.com/studio

Android Studio asennusohjelma käynnissä Windows asennuksen aikana

Vaihe 2) Avaa exe-tiedosto, seuraa näytön ohjeita ja suorita asennus loppuun. Napsauta Valmis-painiketta, kun olet valmis.

Android Studio asennus valmis -näyttö ja viimeistelypainike

Osa IV) Asenna Calabash Android

Vaihe 1) Kirjoita konsoliin gem install calabash-android. Asennus alkaa ja sen valmistuminen vie jonkin aikaa.

Konsolin tuloste, kun calabash-android gemiä ja sen riippuvuuksia asennetaan

Vaihe 2) Kun asennus on valmis, kirjoita calabash-android-versio

Konsoli vahvistaa asennetun Calabash-Android Gem -version

Työskentely Calabash

Kun gem on asennettu, seuraava tehtävä on paikantaa framework-kansio ja ymmärtää sen mukana tuleva runko.

Avaa kansio "calabash-android-0.9.0". Se sijaitsee polussa C:\Ruby23\lib\ruby\gems\2.3.0\gems\calabash-android-0.9.0. Kansioiden nimet muuttuvat synkronoituna koneellesi asennetun ruby/calabash-version kanssa.

Avaa ominaisuusrunkokansio. Varo tätä peruskehystä.

Calabash ominaisuusrunkokansio, joka sisältää tuki- ja step_definitions-hakemistot

  • *.feature-tiedosto sisältää skenaarioita, jotka aiomme automatisoida.
  • Ominaisuustiedoston käyttämä menetelmä on kirjoitettu *.rb-tiedostoon “step_definitions”-kansiossa.
  • Yleiset menetelmät, ympäristön asetukset, sovellusten asennus ja koukut tulee sijoittaa "tuki"-kansioon.

Eroa ja luo sovellus

  • Calabash-android eroaa *.apk
  • Calabash-android-koontiversio *.apk

Eroaminen korvaa kehittäjän allekirjoituksen debug-avaimella, jotta testipalvelin voi instrumentoida sovelluksen ja koontivaihe tuottaa kyseisen testipalvelimen, kuten alla oleva konsolin tuloste osoittaa.

Calabash-androidin resign- ja build-komentojen konsolituloste, joka tuottaa testipalvelimen

Liitä laite järjestelmään / Avaa emulaattori

Tarkista liitetty laite. Kirjoita komento

adb devices

Liitettyjen laitteiden luettelon pitäisi näkyä. Jos laite puuttuu, USB-virheenkorjaus- ja pariliitosvaiheet kohdassa ADB-yhteysopas ratkaisee useimmat tapaukset.

adb-laitteiden komentoluettelo yksi liitteenä Android laite sarjanumeron perusteella

Kuinka löytää elementtipaikannus

  • Avaa konsoli. Kirjoita komento.
    calabash-android console "APK Path"
    start_test_server_in_background
  • Käynnistä sovellus laitteessa yllä olevasta komennosta. Löytääksesi elementtipaikantimen käytä seuraavaa komentoa.
    query "*"

Tämä näyttää kaikkien elementtien paikantimet nykyisellä näytöllä. Visuaalista tarkastajaa suosivat testaajat voivat tarkistaa saman hierarkian ristiin uiautomatorviewer.

Calabash konsoli tulostaa kyselyn kohteena olevan elementtipuun nykyiselle sovellusnäytölle

Calabash Projektin rakenne ja ennalta määritellyt vaiheet

Sen sijaan, että kopioisit gem-kansion käsin, kehys voi luoda toimivan projektin puolestasi. Generaattorin suorittaminen projektihakemistossasi luo standardin Cucumber asettelu, että jokainen Calabash sviitti odottaa.

calabash-android gen

Luotu puu erottaa BDD-paketin kolme osa-aluetta:

  • ominaisuudet/ — Gherkin-skenaariot, yksi .ominaisuus tiedosto käyttäjäpolkua kohden.
  • ominaisuudet/vaiheen_määritelmät/ — Rubyn metodit, jotka vastaavat kutakin Gherkin-riviä, mukaan lukien niputettu calabash_steps.rb.
  • ominaisuudet/tuki/ — ympäristön kokoonpano ja koukut, jotka asentavat, käynnistävät ja sulkevat sovelluksen jokaisessa skenaariossa.

Mukana tuleva calabash_steps.rb on tärkeämpi kuin miltä se ensi silmäyksellä näyttää. Se sisältää laajan joukon valmiita englanninkielisiä vaiheita, joten ensimmäisessä skenaariossa voi painaa painikkeita, syöttää tekstiä ja tehdä näkyviä merkkijonoja ennen kuin yksittäinen mukautettu metodi kirjoitetaan. Mukautettuja vaiheita tarvitaan vasta, kun matka ylittää nämä valmiit lausekkeet.

Kaksi projektitason asetusta on hyvä tietää etukäteen. Kuvakaappaukset sijoittuvat oletusarvoisesti nykyiseen työhakemistoon, ja SCREENSHOT_PATH-ympäristömuuttuja ohjaa ne muualle, mikä pitää koontitiedostot siisteinä jaetulla koneella. Järjestelmäikkunoiden tai toisen sovelluksen kanssa vuorovaikuttaminen vaatii UIAutomator2-taustajärjestelmän, joka käynnistetään komennolla start_test_server_in_background(with_uiautomator: true).

Uusien skriptien luominen

Avaa ominaisuustiedosto ja seuraavat rivit

Kirjautumisominaisuustiedosto avattu editorissa, jossa näkyvät Gherkin-skenaarion vaiheet

Feature: Login feature
  Scenario: As a valid user I can log into my app
    When I press "Login"
    And I enter my username
    And I enter my password
    Then I see "Welcome to coolest app ever"

Avaa Step Definition -tiedosto ja määritä menetelmä *.rb-tiedostoksi.

Ruby-vaiheen määritystiedoston karttaping Gherkin-rivi a:han Calabash elementtikysely

Given /^I am on the login windows$/ do
   wait_for(:timeout =>100) { element_exists("* id:'loginInput;")}
   check_element_exists("* id:'loginInput;")
end

Suorita testiprojekti

Suorita testiprojekti käyttämällä alla olevaa komentoa

calabash-android run "APK Path" "feature file Path" --tags "tag name"

Cucumber tulostaa jokaisen vaiheen sen suorituksen yhteydessä, ja läpimenoaika päättyy tässä esitettyihin skenaarioihin ja vaiheiden kokonaismääriin.

Calabash suorita tuloste, joka näyttää jokaisen laitteella suoritettavan Gherkin-vaiheen

Calabash konsolin yhteenvetoraportointi läpäistyistä skenaarioista ja vaiheiden määristä suorituksen jälkeen

Yhteinen Calabash Virheet ja niiden korjaaminen

Useimmat ensimmäisen testikerran virheet johtuvat testipalvelimen käyttämästä pakkaus- ja käyttöoikeussäännöistä, eivät itse skenaariosta. Alla oleva taulukko yhdistää useimmin raportoidut oireet niiden dokumentoituun syyhyn.

Oire Todennäköinen syy ja korjaus
Sovellus kaatuu heti testin alkaessa APK:sta puuttuu android.permission.INTERNET, jota testipalvelin tarvitsee komentojen hyväksymiseen. Määritä käyttöoikeus kohdassa AndroidManifest.xml ja rakenna uudelleen.
Painikkeet ja teksti eivät reagoi napautuksiin TargetSdkVersion-arvoa ei ole määritelty. Lisää uses-sdk-merkintä, joka nimeää SDK-tason, jota vasten sovellus on rakennettu.
Testipalvelin ei voi muodostaa yhteyttä sovellukseen APK:ta ei ole uudelleenrakennettu debug-avaimella. Suorita resign-komento ja rakenna se uudelleen ennen suorittamista.
Laitteita ei ole listattu suorituksen aikana USB-virheenkorjaus on pois päältä tai ajuri puuttuu. Varmista ensin, että sarjanumero näkyy ADB-laitteiden tulosteessa.
Vaiheet epäonnistuvat määrittelemättömän vaihevirheen vuoksi Gherkin-sananmuokkaus ei vastaa yhtäkään säännöllistä lauseketta step_definitions-muuttujassa. Kopioi ehdotettu koodinpätkä. Cucumber tulostaa ja toteuttaa sen.

Kaksi manifest-merkintää korjaavat kaksi ensimmäistä riviä. Lisää ne ennen APK:n uudelleenmäärittämistä.

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

Aikakatkaisuvirheet johtuvat yleensä ympäristöstä, eivätkä toiminnallisista syistä. Hidas emulaattori, sovelluksen kylmäkäynnistys tai taustalla tapahtuva synkronointi voivat kaikki siirtää näytön wait_for-ikkunan yli, joten nosta aikakatkaisuarvoa ennen kuin kirjoitat uudelleen vaiheen, joka oli itse asiassa oikein.

Is Calabash Vieläkö ylläpidetään? Vaihtoehtoja modernille mobiilitestaukselle

Calabash ei ole enää aktiivisesti kehitetty. Microsoft lopetti osallistumisen tuettuaan lopullista iOS 11:tä ja Android 8 julkaisua, ja projekti on nyt arkistoitu avoimen lähdekoodin koodikanta ilman ylläpitäjää. Olemassa olevat ohjelmistopaketit toimivat edelleen vanhemmilla laitteilla, mutta uusi työ tulisi aloittaa tuetulla kehyksellä.

Puitteet foorumi Soveltuu parhaiten
Appium Android ja iOS Eri alustojen väliset sviitit Java, Python, Rubiini tai JavaScript ja lähin korvaaja a:lle Calabash joukkue.
Espresso Android vain Nopeat prosessinaikaiset testit, jotka on kirjoitettu Kotlinilla tai Java sovelluskehittäjien itsensä toimesta.
XCUITest vain iOS Syntyperäinen Xcode sviitit, eläkkeelle jääneen tuettu seuraaja UIAutomation-kehys.
Maestro ja Detox Android ja iOS Uudemmat avoimen lähdekoodin projektit, jotka tähtäävät hiutaleidenkestävyyteen ja React Native -sovelluksiin.

BDD-tapa itsessään siirtyy siististi. Gherkin-ominaisuustiedostot pysyvät täsmälleen sellaisinaan, ja vain vaiheiden määrittelyrungot muuttuvat, koska Cucumber sijaitsee ajurin yläpuolella eikä sen sisällä. Siirtymätiimit yleensä säilyttävät ominaisuustiedostot ja kirjoittavat Ruby-vaiheet uudelleen Appiumja käytä samaa uudelleen mobiilitestaus laitematriisi ja automaatiotestaus putkilinjaa, jota ne jo käyttävät.

UKK

Kyllä. Erillinen calabash-ios-gemi ajoi iOS-sovelluksia saman Rubyn ja Cucumber kerros. Se jakaa vanhentumistilan Android gem, joten nykyistä iOS-työtä palvelee paremmin XCUITest tai Appium.

Koneoppimismallit korjaavat nyt rikkinäiset paikantimet automaattisesti, merkitsevät epävakaat skenaariot vertaamalla suoritushistorioita ja klusteroivat kaatumisraportteja, jotta vahingollisimmat viat nousevat esiin ensin. Päätös siitä, mitä väittää, kuuluu edelleen testaajalle.

Copilot luonnostelee toistuvat osat hyvin, kuten wait_for-lohkon rivityksenping elementtikysely. Se ei voi tietää sovelluksesi elementtitunnisteita, joten käsittele jokaista luotua vaihetta luonnoksena, joka tarkistetaan reaaliaikaista kyselytulosta vasten.

Cucumber on geneerinen BDD-suoritin, joka lukee Gherkiniä ja kutsuu Ruby-metodeja. Calabash on mobiiliautomaatiokirjasto, jota nuo metodit kutsuvat. Cucumber päättää, mikä toimii; Calabash suorittaa napautuksen, tekstinsyötön ja väitteen.

Kuvakaappaukset kirjoitetaan oletusarvoisesti nykyiseen työhakemistoon ja nimetään peräkkäin suoritusajoa kohden. SCREENSHOT_PATH-ympäristömuuttujan asettaminen ennen suoritusta ohjaa ne valittuun kansioon, mikä pitää jatkuvan integroinnin artefaktit erillään lähdekoodista.

Ei. Calabash instrumentoi käännetyn APK:n, minkä vuoksi resign-vaihe on olemassa. Lähdekoodin käyttöoikeus auttaa sinua lisäämään vakaita elementtitunnisteita, mutta itse kehys tarvitsee vain buildin, se voi resignoida ja instrumentoida.

Kyllä. Koska suoritus on yksi komentorivikutsu, mikä tahansa koontipalvelin voi kutsua sitä APK:n luomisen jälkeen. Jenkins työ tyypillisesti poistaa APK:n käytöstä, käynnistää emulaattorin, suorittaa merkityt ominaisuudet ja arkistoi raportit.

Pidä Gherkin-ominaisuustiedostot muuttumattomina ja kirjoita uudelleen vain vaiheiden määritysrungot Appium asiakas. Elementtikyselyistä tulee paikannusstrategioita, ja sovelluksen asentaneista koukuista tulee haluttuja ominaisuuksia ajuriasetuksissa.

Tiivistä tämä viesti seuraavasti: