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.

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.
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
Vaihe 2) Avaa exe-tiedosto ja seuraa näytön ohjeita. Kun asennus on valmis, näet seuraavan näytön. Napsauta Valmis.
Käynnistä komentokehote Rubyn ollessa päällä Windows 10 & kirjoita komento alle.
ruby -v
Konsoli tulostaa asennetun tulkin version, kuten alla näkyy.
Osa III) Lataa ja asenna Android
Vaihe 1) Lataa Android Studio at https://developer.android.com/studio
Vaihe 2) Avaa exe-tiedosto, seuraa näytön ohjeita ja suorita asennus loppuun. Napsauta Valmis-painiketta, kun olet valmis.
Osa IV) Asenna Calabash Android
Vaihe 1) Kirjoita konsoliin gem install calabash-android. Asennus alkaa ja sen valmistuminen vie jonkin aikaa.
Vaihe 2) Kun asennus on valmis, kirjoita calabash-android-versio
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ä.
- *.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.
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.
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 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
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.
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.
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.
















