Автоматизация приемочного тестирования Android приложений с помощью Calabash

Calabash

• Жесты
  Касания и жесты (tap, swipe, rotate и т.п.).
  
• Проверки
  Например: Должна присутствовать кпопка «Login» на экране.
  
• Получения снимка с экрана мобильного устройства

Feature: Rating a stand
  Scenario: Find and rate a stand from the list
    Given I am on the foodstand list
    Then I should see a "rating" button
    And I should not see "Dixie Burger & Gumbo Soup"

    When I touch the "rating" button
    Then I should see "Dixie Burger & Gumbo Soup"

    When I touch "Dixie Burger & Gumbo Soup"
    Then I should see details for "Dixie Burger & Gumbo Soup"

    When I touch the "rate_it" button
    Then I should see the rating panel

    When I touch "star5"
    And I touch "rate"
    Then "Dixie Burger & Gumbo Soup" should be rated 5 stars

• Простота написания тестов
• Возможность написания кроссплатформенных тестов (для Android и iOS)
• Написания сценариев в стиле Cucumber
• Отличный Ruby API
• Возможность запускать тесты в облаке
• Возможность запускать тесты на эмуляторе

• Порой, трудно идентифицировать объекты
• Не всегда хватает предписанных шагов для написания тестового сценария
• Необходим apk-файл тестируемого приложения
• Достаточно долгое прохождение тестов

Установка

1. JDK7 Standard Edition
   Если у Вас не установлен JDK7 (или 6), то скачайте и установите его: www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html. После того как установили JDK необходимо создать системную переменную JAVA_HOME, которая будет указывать расположение JDK. Также добавте в переменную окружения PATH путь к java (если Вы не меняли путь установки JDK, то java находится тут: C:\Program Files\Java\jre7\bin).
   
2. Android SDK
   Скачайте и распакуйте в удобное место Android SDK (или ADT Bundle): developer.android.com/sdk/index.html?hl=sk. После этого необходимо создать переменную ANDROID_HOME указываящая раположение Android SDK (у меня: C:\adt-bundle-windows-x86_64-20131030\sdk), а также добавьте в PATH расположение adb (например, C:\adt-bundle-windows-x86_64-20131030\sdk\platform-tools)
   
3. Ant
   Скачайте и распакуйте Ant (http://ant.apache.org/bindownload.cgi), а затем создайте переменную ANT_HOME, в которой прописывайте путь к Ant и, как прежде, добавляйте разположение ant.exe в переменную окружения PATH, а именно %ANT_HOME%\bin
   
4. Ruby 1.9.3. (не 2.0 !!!)
   Скачайте установочный файл с сайта rubyinstaller.org/downloads и устанавливайте, во время установки поставте галочку напротив опции «Add ruby executables to your PATH»
   
   
5. Ruby Development Kit
   Также необходим Ruby Development Kit для доступа к Ruby gems (пакетный менеджер). Скачать установочный файл нужно на сайте: rubyinstaller.org/downloads. Установите, следую инструкции на экране.
   

Разработка тестового сценария

1. Проверка наличия всех необходимых опций в меню приложения
2. Изменения языка приложения на голландский
3. Проверка корректности перевода опций меню

Анализ приложения

1. Создать директорию, где будет храниться наш проект:
   

   > mkdir calabash_habr && cd calabash_habr

   
   
2. Сгенерировать файловую структуру Cucumber, которая включает в себя директории с описанием фич(features), описанием шагов(step definitions), support:
   

   > calabash-android gen

   
   
   
3. Поместим apk в корень директории с проект
   
4. После этого необходимо переподписать приложение:
   

   > calabash-android resign "Clean Master_3.8.1.apk"

   
   Если Вам не удалось переподписать, то сначала необходимо выполнить команду:
   keytool -genkey -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android -keyalg RSA -keysize 2048 -validity 10000 -dname "CN=Android Debug,O=Android,C=US"
   
5. Подключите устройство
   
6. Установим тестируемое приложение на устройство:
   

   > adb install "Clean Master_3.8.1.apk"

   
   

1. Запуск интерактивной консольной среды calabash-console
   

   > calabash-android console "Clean Master_3.8.1.apk"

   
   
2. Запускаем тестовый сервер:
   

   irb(main):001:0> start_test_server_in_background

   
   Если у Вас не удалось запустить тестовый сервер, то выполните команду:
   

   irb(main):001:0> reinstall_apps

   
   
3. Жмем на кнопку «Меню»:
   

   irb(main):007:0> performAction('press_menu')

   
   И получаем:
   

   {
       "bonusInformation" => [],
                "message" => "",
                "success" => true
   }
   

   
   Меню открылось.
   
4. Нам нужно зайти в «Settings», для этого сперва выясняем какой объект имеет текст «Settings»:
   

   irb(main):008:0> query("* text:'Settings'")

   
   В результате узнаем, что объект с текстом «Settings» имеет id “menuSettings”:
   

   [
       [0] {
                           "id" => "menuSettings",
                      "enabled" => true,
           "contentDescription" => nil,
                        "class" => "android.widget.Button",
                         "text" => "Settings",
                         "rect" => {
               "center_y" => 67.0,
               "center_x" => 720.0,
                 "height" => 40,
                      "y" => 47,
                  "width" => 160,
                      "x" => 640
           },
                  "description" => "android.widget.Button@4280e6f8"
       }
   ]
   

   
   
5. Жмем на кнопку с id “menuSettings”:
   

   irb(main):011:0> tap('menuSettings')

   
   
   После этого открылись настройки приложения

   
   
   
6. Этого достаточно, выходим из интерактивной консоли:
   

   irb(main):003:0> exit

   
   

Feature: Menu localization
# Заголовок сценария
Scenario: As a user I can open a menu and verify options
# Нажимаем на кнопку "Меню"
	When I press the menu key
# Проверяем, если текст "Settings", "Update" и т.д.
	Then I see "Settings"
	Then I see "Update"
	Then I see "Like us"
	Then I see "Rate us"
	Then I see "Feedback"
	Then I see "FAQ"
	Then I see "Fast Clean"
	Then I see "About"

Scenario: As a user I can change language app to Nedelrands
	When I press the menu key
	When I press "Settings"
	Then I press "Language"
	When I press "Nederlands"
	Then I see "Taal"
	When I go back
	When I press the menu key
	Then I see "Instellingen"
	Then I see "Moderniseren"
	Then I see "Net als wij"
	Then I see "Beoordeel ons"
	Then I see "Terugcontact"
	Then I see "FAQ"
	Then I see "Snel schoonmaken"
	Then I see "Over ons"

> calabash-android run "Clean Master_3.8.1.apk"

В результате прохождения сценария получаем:

не переведено на голландский

Вывод