Automate acceptance testing for Android applications using Calabash

Calabash

• Gestures
  Touch and gestures (tap, swipe, rotate, etc.).
  
• Checks
  For example: There should be a “Login” button on the screen.
  
• Taking a snapshot of the screen of a mobile device

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 

• Ease of writing tests
• The ability to write cross-platform tests (for Android and iOS)
• Cucumber style scripts
• Great Ruby API
• Ability to run tests in the cloud
• Ability to run tests on the emulator

• Sometimes it is difficult to identify objects
• The prescribed steps are not always enough to write a test script.
• Apk-file of the tested application is required
• Long enough passing tests

Installation

1. JDK7 Standard Edition
   If you do not have JDK7 (or 6) installed, then download and install it: www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html . After you have installed the JDK, you need to create the JAVA_HOME system variable, which will indicate the location of the JDK. Also add the path to java to the PATH environment variable ( if you did not change the JDK installation path, then java is located here: C: \ Program Files \ Java \ jre7 \ bin ).
   
2. Android SDK
   Download and unzip to a convenient place Android SDK (or ADT Bundle): developer.android.com/sdk/index.html?hl=sk . After this, you need to create a ANDROID_HOME variable indicating the location of the Android SDK ( I have: C: \ adt-bundle-windows-x86_64-20131030 \ sdk ), and also add the adb location to the PATH ( for example, C: \ adt-bundle-windows-x86_64 -20131030 \ sdk \ platform-tools )
   
3. Ant
   Download and unpack Ant (http://ant.apache.org/bindownload.cgi), and then create the ANT_HOME variable, in which you set the path to Ant and, as before, add the ant.exe location to the PATH environment variable, namely% ANT_HOME% \ bin
   
4. Ruby 1.9.3. (not 2.0 !!!)
   Download the installation file from the site rubyinstaller.org/downloads and install, during the installation, check the box next to the option “Add ruby ​​executables to your PATH”
   
   
5. Ruby development kit
   The Ruby Development Kit is also required to access Ruby gems (package manager). Download the installation file to the site: rubyinstaller.org/downloads . Install, follow the instructions on the screen.
   

Test case development

1. Check for all the necessary options in the application menu
2. Change the application language to Dutch
3. Verifying the translation of menu options

Application analysis

1. Create a directory where our project will be stored:
   

    > mkdir calabash_habr && cd calabash_habr 

   
   
2. Generate the Cucumber file structure, which includes directories with features (description), step definitions, support:
   

    > calabash-android gen 

   
   
   
3. Put apk in the root directory of the project
   
4. After that, you need to re-sign the application:
   

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

   
   If you failed to re-sign, you must first run the command:
   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. Connect the device
   
6. Install the application under test on the device:
   

    > adb install "Clean Master_3.8.1.apk" 

   
   

1. Launching the calabash-console interactive console environment
   

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

   
   
2. We start the test server:
   

    irb(main):001:0> start_test_server_in_background 

   
   If you failed to start the test server, then run the command:
   

    irb(main):001:0> reinstall_apps 

   
   
3. Click on the button "Menu":
   

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

   
   And we get:
   

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

   
   The menu has opened.
   
4. We need to go to “Settings”, for this we first find out which object has the text “Settings”:
   

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

   
   As a result, we learn that an object with the text “Settings” has the 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. Click on the button with the id “menuSettings”:
   

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

   
   
   After that, the application settings are opened.

   
   
   
6. That's enough, exit the interactive console:
   

    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" 

As a result of passing the script, we get:

not translated into Dutch

Conclusion