WYMAGANIA<\/h2>\n\n\n\n
Wszystkie opisane czynno\u015bci zosta\u0142y wykonane na systemie Windows 10.<\/p>\n\n\n\n
Aby Appium dzia\u0142a\u0142o poprawnie na komputerze zainstalowane musz\u0105 by\u0107:<\/p>\n\n\n\n
- \n
- Eclipse<\/li>\n\n\n\n
- Android SDK i API dla obecnej wersji Androida<\/li>\n\n\n\n
- Java<\/li>\n\n\n\n
- \u015acie\u017cki do JAVA_HOME i ANDROID_HOME musz\u0105 by\u015b ustawione w zmiennych \u015brodowiskowych<\/li>\n<\/ul>\n\n\n\n
Dodatkowo opcjonalnie zainstalowany mo\u017ce by\u0107 Node.js, ale nie jest to wymagane, poniewa\u017c nowsze wersje Appium maj\u0105 dodane ten program domy\u015blnie. Dodatkowym wymaganiem jest posiadanie biblioteki TestNG <\/a><\/p>\n\n\n\n
KONFIGURACJA<\/h2>\n\n\n\n
- \n
- \u015aci\u0105gamy Selenium i rozpakowujemy pliki w dowolnym miejscu w folderze nazwanym Selenium<\/a><\/li>\n\n\n\n
- \u015aci\u0105gamy Appium dla Windowsa<\/a> i rozpakowujemy w folderze nazwanym Appium<\/li>\n\n\n\n
- \u015aci\u0105gamy jar klienta Javy<\/a> i dodajemy do folderu Appium<\/li>\n<\/ul>\n\n\n\n
Instalujemy z folderu Appium program o ten samej nazwie. Otwieramy Eclipse i tworzymy nowy projekt Maven\u2019owy. Klikamy prawym przyciskiem myszy na projekt, wybieramy Properties -> Java Build Path -> Add External JAR\u2019s<\/em>. Do projektu dodajemy jar klienta Javy z folderu Appium, pobrane biblioteki z folderu Selenium, jar TestNG.<\/p>\n\n\n\n
![\"properties\"](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2017\/02\/ap1.png\")
<\/a><\/figure>\n\n\n\nDobr\u0105 praktyk\u0105 jest dodanie do projektu builda aplikacji, kt\u00f3r\u0105 b\u0119dziemy testowa\u0107. Je\u015bli mamy plik .apk to wystarczy gdy w do projektu dodamy folder o nazwie np. builds i wrzucimy do niego apk\u0119. Co je\u015bli nie mamy zbudowanej aplikacji, a posiadamy j\u0105 tylko zainstalowan\u0105 na urz\u0105dzeniu?<\/p>\n\n\n\n
adb pull CZYLI ZYSKIWANIE BUILDA APLIKACJI<\/h2>\n\n\n\n
Je\u015bli nie mamy zbudowanej aplikacji w postaci pliku apk to mo\u017cemy go uzyska\u0107 bezpo\u015brednio z urz\u0105dzenia lub emulatora. W tym celu telefon musi by\u0107 pod\u0142\u0105czony do komputera a emulator musi by\u0107 uruchomiony. Przechodzimy do folderu w kt\u00f3rym znajduje si\u0119 SDK Androida, wchodzimy do platform-tools<\/em>. Uruchamiamy konsol\u0119 i wpisujemy polecenie adb devices<\/strong><\/em>. Powinna pokaza\u0107 si\u0119 lista dost\u0119pnych urz\u0105dze\u0144. W przypadku kiedy jest wi\u0119cej ni\u017c jedno urz\u0105dzenie podpi\u0119te\/uruchomione na komputerze, nale\u017cy w ka\u017cdej dalej przedstawionej komendzie poda\u0107 numer urz\u0105dzenia na kt\u00f3rym dana komenda ma by\u0107 wykonana.<\/p>\n\n\n\n
![\"ap2\"](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2017\/02\/ap2.png\")
<\/a><\/figure>\n\n\n\nJe\u015bli wiemy jak nazywa si\u0119 nasza aplikacja, kt\u00f3rej builda chcemy uzyska\u0107, to musimy na pocz\u0105tek uzyska\u0107 nazw\u0119 jej package\u2019u. W tym celu wpisujemy komend\u0119 listuj\u0105c\u0105 wszystkie zainstalowane aplikacje, kt\u00f3re w nazwie posiadaj\u0105 zadany przez nas parametr:<\/p>\n\n\n\n
![\"ap3\"](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2017\/02\/ap3.png\")
<\/a><\/figure>\n\n\n\nW wynikach zapytania szukamy interesuj\u0105cej nas aplikacji. Komenda pokazuje nazw\u0119 packagu oraz \u015bcie\u017ck\u0119, w jakiej aplikacja si\u0119 znajduje.<\/p>\n\n\n\n
Kolejnym krokiem b\u0119dzie wykonanie pulla aplikacji z urz\u0105dzenia na komputer. W tym celu pos\u0142u\u017cymy si\u0119 komend\u0105 pull jako parametr podaj\u0105c wylistowan\u0105 wcze\u015bniej \u015bcie\u017ck\u0119:<\/p>\n\n\n\n
![\"ap4\"](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2017\/02\/ap4.png\")
<\/a><\/figure>\n\n\n\nW folderze platform-tools<\/em> zobaczymy nowy plik: base.apk<\/strong>. Jest to nasza zbudowana aplikacja pobrana z urz\u0105dzenia. Kolejnym krokiem jest pobranie z builda informacji o aktywno\u015bci startowej, aby mo\u017cna by\u0142o w pe\u0142ni stworzy\u0107 DesiredCapabilities dla Appium. W tym celu pos\u0142u\u017cymy si\u0119 poleceniem aapt dump<\/strong><\/em>. By uruchomi\u0107 jednak program aapt musimy przej\u015b\u0107 do folderu build-tools<\/em>, wej\u015b\u0107 w folder z numerem SDK ( u mnie 23.0.3).<\/p>\n\n\n\n
![\"ap5\"](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2017\/02\/ap5.png\")
<\/a><\/figure>\n\n\n\n<\/div>\n\n\n\n![\"ap6\"](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2017\/02\/ap6.png\")
<\/a><\/figure>\n\n\n\nPowy\u017cej wida\u0107 wszelkie niezb\u0119dne informacje na temat aplikacji, jak wersja minimalna systemu, permissions, nazwa paczki itd. Nas jednak interesuje informacja zawarta nieco ni\u017cej, mianowicie wynik warto\u015bci launchable-activity<\/em>. Po ostatniej kropce znajduje si\u0119 nazwa aktywno\u015bci startowej, kt\u00f3rej w\u0142a\u015bnie szukali\u015bmy. Maj\u0105c ju\u017c wszystkie niezb\u0119dne informacje mo\u017cemy przej\u015b\u0107 do Eclipse i Appium.<\/p>\n\n\n\n
Oczywi\u015bcie mo\u017cemy skorzysta\u0107 tak\u017ce z gotowych aplikacji umo\u017cliwiaj\u0105cych zczytywanie danych, jak np. APK Info<\/strong><\/em><\/a>, kt\u00f3ra pokazuje szczeg\u00f3\u0142owe informacje na temat wybranej aplikacji:<\/p>\n\n\n\n
\n\n![\"\"](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2023\/06\/Screenshot_2017-02-06-16-12-411-169x300-1.png\")
<\/a><\/figure>\n<\/div>\n\n\n\n\n![\"\"](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2023\/06\/Screenshot_2017-02-06-16-12-551-169x300-1.png\")
<\/a><\/figure>\n<\/div>\n<\/div>\n\n\n\n<\/a><\/p>\n\n\n\n
APPIUM<\/h2>\n\n\n\n
Przechodzimy do Appium. Klikamy na robota androidowego aby przej\u015b\u0107 do ustawie\u0144. W sekcji Capabilities<\/em> podajemy nazw\u0119 urz\u0105dzenia, na kt\u00f3rym uruchamiane b\u0119d\u0105 testy. Je\u015bli nie wiemy jak nasze urz\u0105dzenia identyfikowane jest w systemie to wystarczy, \u017ce komend\u0119 adb devices<\/em><\/strong> uruchomimy z parametrem dodatkowym \u2013l<\/em><\/strong>. Nazwa urz\u0105dzenia podana jest po model=<\/strong><\/em>.<\/p>\n\n\n\n
![\"ap7\"](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2017\/02\/ap7.png\")
<\/a><\/figure>\n\n\n\nW sekcji Application<\/em> podajemy \u015bcie\u017ck\u0119 do pliku base.apk. I to wszystko, mo\u017cemy teraz uruchomi\u0107 serwer appium klikaj\u0105c w strza\u0142k\u0119 Run. Po chwili serwer startuje co wida\u0107 w wy\u015bwietlanych logach:<\/p>\n\n\n\n
![\"ap8\"](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2017\/02\/ap8.png\")
<\/a><\/figure>\n\n\n\nSerwer uruchamia si\u0119 na domy\u015blnym porcie 4723 o adresie IP 127.0.0.1 i dobrze jest tego nie zmienia\u0107. Innymi mo\u017cliwymi opcjami jest adres 0.0.0.0 i port 4725. Serwer nale\u017cy skonfigurowa\u0107 tak, aby podane parametry zgadza\u0142y si\u0119 z minimalnymi wymaganiami aplikacji, kt\u00f3re zczytali\u015bmy z konsoli. Kiedy serwer jest ju\u017c uruchomiony mo\u017cemy przej\u015b\u0107 do Eclipse.<\/p>\n\n\n\n
ECLIPSE<\/h2>\n\n\n\n
W naszym projekcie Mavenowym tworzymy now\u0105 klas\u0119. Na pocz\u0105tek nale\u017cy ustawi\u0107 Desired Capabilities<\/em>, czyli zestaw kluczy i warto\u015bci, kt\u00f3re wysy\u0142amy do serwera Appium aby poinformowa\u0107 go jakim rodzajem sesji jeste\u015bmy zainteresowani i co b\u0119dzie testowane. Wymaganym minimum s\u0105 warto\u015bci dla deviceName, appPackage<\/em> i appActivity<\/em>. Teraz mo\u017cemy zainicjowa\u0107 drivera, dzi\u0119ki kt\u00f3remu b\u0119dziemy testowa\u0107 aplikacj\u0119.<\/p>\n\n\n\n
![\"ap9\"](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2017\/02\/ap9.png\")
<\/a><\/figure>\n\n\n\nKolejne kroki s\u0105 ju\u017c takie jak dla typowych test\u00f3w przy u\u017cyciu Selenium: wyszukujemy elementy, wykonujemy akcje, wstawiamy asercj\u0119 w celu weryfikacji poszczeg\u00f3lnych krok\u00f3w. Ale jak zdoby\u0107 informacje na temat testowanego widoku? W tym celu pos\u0142u\u017cymy si\u0119 ponownie SDK Androida i narz\u0119dziem UIAutomatorViewer.<\/p>\n\n\n\n
UIAutomatorViewer<\/h2>\n\n\n\n
Narz\u0119dzie to znajdziemy w SDK w folderze tools<\/em>. Dzi\u0119ki niemu mo\u017cemy uzyskiwa\u0107 informacje na temat hierarchii element\u00f3w w widoku, idki i inne atrybuty. Aplikacja, kt\u00f3r\u0105 chcemy zbada\u0107 powinna by\u0107 uruchomiona na urz\u0105dzeniu. Wybieramy przycisk Device Screenshot<\/em> i czekamy a\u017c poka\u017ce si\u0119 widok, na kt\u00f3rym mo\u017cemy wskaza\u0107 mysz\u0105 element, kt\u00f3rego warto\u015bci nas interesuj\u0105. Dop\u00f3ki nie wybierzemy go poprzez klikni\u0119cie, warto\u015bci sfocusowanych element\u00f3w b\u0119d\u0105 od\u015bwie\u017ca\u0142y si\u0119 dynamicznie.<\/p>\n\n\n\n
![\"ap10\"](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2017\/02\/ap10.png\")
<\/a><\/figure>\n\n\n\nKiedy mamy ju\u017c wszystkie niezb\u0119dne informacje na temat konfiguracji \u015brodowiska, aplikacji i napisali\u015bmy ju\u017c kod, mo\u017cemy przyst\u0105pi\u0107 do jego uruchomienia. Poniewa\u017c testy powinny by\u0107 jak naj\u0142atwiejsze w utrzymaniu i dobr\u0105 praktyk\u0105 jest niedublowanie kodu, nale\u017cy rozbija\u0107 czynno\u015bci na jak najmniejsze metody. W tym kr\u00f3tkim przyk\u0142adzie nie ma to sensu, ale w przypadku bardziej z\u0142o\u017conych test\u00f3w jest to wskazane. Podczas tworzenia projektu wygenerowa\u0142 si\u0119 folder src\/test\/java<\/em> a w nim plik NazwaKlasyTest.java.<\/em> Zawiera on wygenerowany z automatu kod dziedzicz\u0105cy po junitowym TestCase. W metodzie testApp()<\/em> wywo\u0142uj\u0119 metod\u0119 napisan\u0105 w klasie App. Ca\u0142o\u015b\u0107 uruchamiam poprzez klikni\u0119cie prawego przycisku i Run as -> JUnit test.<\/em> W Appium pojawiaj\u0105 si\u0119 logi \u015bwiadcz\u0105ce o uruchomieniu testu, na urz\u0105dzeniu widzimy akcje, kt\u00f3re zaprogramowali\u015bmy.<\/p>\n\n\n\n
![\"ap11\"](\"https:\/\/sii.pl\/blog\/wp-content\/uploads\/2017\/02\/ap11.png\")
<\/a><\/figure>\n\n\n\nChcesz lepiej zrozumie\u0107 aplikacje i systemy, kt\u00f3re testujesz? Do\u0142\u0105cz do ModernTester, poznaj najpotrzebniejsze narz\u0119dzia, frameworki oraz j\u0119zyki programowania i \u0107wicz na specjalnie przygotowanych \u015brodowiskach testowych: Platforma e-learningowa ModernTester<\/a><\/p>\n\n\n
- \u015aci\u0105gamy Appium dla Windowsa<\/a> i rozpakowujemy w folderze nazwanym Appium<\/li>\n\n\n\n
- \u015aci\u0105gamy Selenium i rozpakowujemy pliki w dowolnym miejscu w folderze nazwanym Selenium<\/a><\/li>\n\n\n\n