Appium Kurulumu ve Cihaz Ayarları

Appium, Mobil Uygulamaları otomatik olarak test edebilen açık kaynaklı bir mobil test aracıdır. Başarılı bir test senaryosu oluşturmadan önce Appium kurulumunun sorunsuz gerçekleştirilmesi gerekir. Kurulum için aşağıdaki adımları takip edebiliriz.

1. JDK’yı (Java Geliştirme Kiti) yükleyelim.

Java’yı (JDK) indirip yükleyelim ardından bir JDK ve bin klasörünün yolunu ayarlayalım.

• “.exe” dosyasını buradan indirelim. (En son sürüm hangisi ise işletim sisteminize göre indiriniz).
• “.exe” dosyasını çalıştıralım.
• JDK bin klasör yolunu sisteminizin ortam değişkeninde aşağıdaki görseldeki gibi ayarlayalım.
• JDK’nın sistemde kurulu olduğu yolu not edelim.

Bu durumda, yol C:\Program Files\Java\jdk1.8.0_321\bin şeklindedir.

Bilgisayarımdan Denetim masasından “Sistem ve ortam değişkenlerine” gidip yeni path belirlenir.Aşağıdaki şekilde kullanıcı değişkenlerinden “Yeni” tıklanır ,değişken adına “ JAVA_HOME ” değişken kısmına da yolu (Path) yazılır.

Ayrıca sistem değişkenlerindeki path kısmına da aşağıdaki yolu eklemeyi unutmayın aksi takdirde hata alma olasılığınız çok yüksek.

Sistemin kurulu Java’yı tanıyabildiğinden emin olmak için Komut İstemine(Cmd)gidin ve ‘java –version’ yazalım. Bu, sistemde kurulu olan JDK’nın en son sürümünü göstermelidir.

2-Android SDK’yı (Yazılım Geliştirme Kiti) yükleyelim

Android SDK’yı buradan indirelim.(İşletim sisteminize uygun olanı.)

Download Android Studio butonuna tıklayalım.

Karşısınıza aşağıdaki gibi bir ekran çıkacaktır buradaki kutucuğu işaretleyip indirelim.

İndirme işlemi tamamlandıktan sonra, dosyayı(exe)indirilenlerden açalım ve çalıştıralım. Kalan kısımları next-next şeklinde geçebilirsiniz.

Daha sonra Android SDK’nın kurulu olduğu yolu not edelim.Tekrar ortam değişkenlerinden bir ayarlama yapmamız gerekecektir.

Bu durumda, yol C:\Users\aaydemir\AppData\Local\Android\Sdk şeklindedir.

Tekrar Denetim masasından Sistem Özellikleri-Ortam Değişkenlerine gidelim ve Android SDK’nın yolunu girelim.

Kurulum ve yolu tamamlandıktan sonra bir emülatör kurmanız gerekecektir.

Bunun için aşağıdaki alandan “Configure” kısmına ve burdan “AVD Manager”a tıklayalım.

Benim kurmuş olduğum emülatörler aşağıdaki görseldeki gibi.

Siz yeni bir emülatör eklemek isterseniz “Create Virtual Device” kısmından yeni bir emülatör oluşturup ekleyebilirsiniz.

3-Node.js’yi yükleyin

Appium, Node.js’de yazıldığı için, Appium’u kullanmak için önce Node.js’yi yüklemeniz gerekir.

https://nodejs.org/en/download/current/ sitesinden işletim sisteminize uygun sürümü indiriniz.

İndirme işlemi tamamlandıktan sonra paketi kurunuz.

Lisans sözleşmesini kabul ettikten sonra bir sonraki ekrana geçiniz.

C:\Program Files\nodejs olan Node.js yolunu seçiniz.

Npm, Node.js için önerilen paket yöneticisidir. Bu nedenle, NPM araçlarını da kuralım.

İleri’ye tıklayıp kurulumu tamamlayınız.

Kurulum yapıldıktan sonra, ortam değişkenine otomatik olarak nodejs yolu(path) kayıtlı olacaktır. Yine de Nodejs yolunu içerip içermediğini kontrol edelim.

Ortam değişkenlerine geliniz ve kontrollerinizi yapınız.

Komut sistemine(Cmd) npm -version yada npm -v yazalım kurulumundan emin olmak için.

4-Appium’u yükleyelim

Başta “Appium Desktop” içerisinde “Appium İnspector” bulunmaktaydı fakat yeni versiyonda Appium Desktop server parçası değildir, ayrı bir uygulamadır.

Bunun için ayrı ayrı kurulumlar yapmanız gerekecektir.

Appium download ‘ı buradan işletim sisteminize uygun olanı indirip exe dosyamızı çalıştıralım.

Appium İnspector’üde buradan işletim sisteminize uygun olanı indirebilirsiniz.

İndirilen dosyayı İnspector dosyasını zipten çıkaralım ve Appium-Server-GUI.exe dosyasını çalıştıralım.

Çalıştırdıktan sonra aşağıdaki ekran karşınıza gelecektir. Buradan da Start Server diyelim. Kurulumundan emin olmak için Komut İstemine appium -v veya appium -version yazarsanız indirdiğiniz versiyonu görüntülemiş olursunuz.

Appium İnspector’ü kurup çalıştırdıktan sonra aşağıdaki ekran karşınıza gelecektir.

Gelin şimdi Telefon ve Emülatör ayarlarını yapalım ardından apk dosyamızı çalıştıralım.

* Öncelikle kullanacağımız cihazın geliştirici seçeneklerini açmamız lazım.

Android Geliştirici Seçenekleri Açma Nasıl Yapılır?
1-Ayarları açalım.
2-Cihaz Hakkında sekmesine giriniz.
3-Yapım Numarası veya Derleme Numarası seçeneklerini bulalım.
4-Bu seçeneğin üzerine birkaç kez hızlıca dokunalım.
5-İşlem başarılı olduğunda Siz de Artık Bir Geliştiricisiniz! yazısı ile karşılaşacaksınız.

Bu linkten destek alabilirsiniz.

* Appium da gerekli ayarlamaları yapalım.

Appium İnspector’ü açalım.

Burda ilk yapmamız gereken şey Remote Path kısmına /wd/hub yazmak.

5-Appium’da Cihaz Ayarları

Önce gerçek cihaz ayarını yapalım. Desired Capabilities kısmına gelip özelliklerimizi ekleyelim.

Burda Desired Capability de yazdıklarımız nedir?

İstenilen yetenekler, sunucuya ne tür bir otomasyon oturumu başlatmakla ilgilendiğimizi söylemek için Appium sunucusuna gönderilen bir dizi anahtar ve değerdir.

platformName =Hangi mobil işletim sistemi platformunu kullanmalı(Android ,İOS vs)
automationName=Hangi otomasyon motorunu kullanmalı(UiAutomator1,UiAutomator2 vs)
deviceName= Kullanılacak mobil cihazın adı
app=İndirdiğimiz apk’nın yolu(Path)

Bizim Cihaz Ayarlarımız ise şu şekilde:

{
  "platformName": "Android",
  "appium:automationName": "UiAutomator1",
  "appium:deviceName": "HUAWEI P40 lite",
  "appium:app": "C:\\multipay-mtestHms-debug.apk"
}

Bu bilgileri girdikten sonra bu Capability’e bir isim verdikten sonra kaydedelim.(Bu tamamen size bağlı mesela ben Multipay projesi olduğu için Multipay adını verdim ve kaydettim.)

Kayıt işlemini yaptıktan sonra telefonumuzu Usb ile bilgisayara bağlayalım. Ardından Appium da “Start Server” diyelim.

Daha sonra Appium İnspector’de Start Session diyelim.Start Session dedikten sonra uygulamamız gerçek cihazımızda çalışacaktır.

Emülatörde çalıştırmak istiyorsanız değiştireceğiniz tek şey Desired Capabilities alanı olacaktır.

Örnek bir Emülatör Capability :

{
  "platformName": "Android",
  "appium:automationName": "UiAutomator1",
  "appium:deviceName": "Nexus_5X_API_28",
  "appium:avd": "Nexus_5X_API_28",
  "appium:app": "C:\\multipay-mtestHms-debug.apk"
}

Emülatör adını, emülatörün üstüne gelip sağ tıklayıp View Details derseniz bulabilirsiniz.

Appium İnspector’e aşağıdaki gibi Capability girilir.

Ardından Start Session derseniz emülatörünüz çalışacaktır. Start Session dedikten sonra emülatör ekranı aşağıdaki görsel gibi apk’nızı çalıştıracaktır.

Özetle Appium kurulumu için aşağıdaki sıralamayı takip etmiş olduk.

1-JDK’yı (Java Geliştirme Kiti) yükleyelim.

2-Android SDK’yı (Yazılım Geliştirme Kiti) yükleyelim.

3-Node.js’yi yükleyin.

4-Appium’u yükleyelim.

5-Appium’da Cihaz Ayarları.

Destekleri için Funda Buyukdeniz ve Zekeriya Polat ‘a teşekkür ederiz.