Calabash Android 简介

什么是 Calabash？

Calabash 是一个自动化测试框架，它能够测试 Android 和 iOS 原生应用和混合应用。

它有：

• calabash-android

• calabash-ios

主页： http://calabash.sh

Calabash-android介绍

Calabash-android 是支持 android 的 UI 自动化测试框架，PC 端使用了 cucumber 框架，经过 http 和 json 与模拟器和真机上安装的测试 apk 通讯，测试 apk 调用 Robotium 的方法来进行 UI 自动化测试，支持 webview 操做。

Calabash-android 架构图

• Features —— 这里的 feature 就是 cucumber 的 feature，用来描述 user stories 。

• Step Definitions —— Calabash Android 事先已经定义了一些通用的 step。你能够根据本身的需求，定义更加复杂的步骤。

• Your app —— 测试以前，你没必要对你的应用修改。（这里实际上是有问题，后面咱们会说到。）

• Instrumentation Test Server —— 这是一个应用，在运行测试的时候会被安装到设备中去。 这个应用是基于 Android SDK 里的 ActivityInstrumentationTestCase2。它是 Calabash Android 框架的一部分。Robotium 就集成在这个应用里。

Calabash-android 环境搭建

ruby 环境

• rvm

• rbenv

• RubyInstaller.org for windows

Android 开发环境

• JAVA

• Android SDK

• Ant

指定 JAVA 环境变量， Android SDK 环境变量（ANDROID_HOME）， Ant 加入到 PATH 中去。

安装 Calabash-android

gem install calabash-android
sudo gem install calabash-android # 若是权限不够用这个。

若有疑问，请参考： https://github.com/calabash/calabash-android/blob/master/documentation/installation.md

建立 calabash-android 的骨架

calabash-android gen

会生成以下的目录结构：

➜  calabash  tree
.
features
|_support
| |_app_installation_hooks.rb
| |_app_life_cycle_hooks.rb
| |_env.rb
|_step_definitions
| |_calabash_steps.rb
|_my_first.feature

写测试用例

像通常的 cucumber 测试同样，咱们只要在 feature 文件里添加测试用例便可。好比咱们测试 ContactManager.apk （android sdk sample 里面的， Appium 也用这个 apk）。

咱们想实现，

• 打开这个应用

• 点击 Add Contact 按钮

• 添加 Contact Name 为 hello

• 添加 Contact Phone 为 13817861875

• 添加 Contact Email 为 hengwen@hotmail.com

• 保存

因此咱们的 feature 应该是这样的：

Feature: Login feature  Scenario: As a valid user I can log into my app    When I press "Add Contact"
    Then I see "Target Account"
    Then I enter "hello" into input field number 1    Then I enter "13817861875" into input field number 2    Then I enter "hengwen@hotmail.com" into input field number 3    When I press "Save"
    Then I wait for 1 second    Then I toggle checkbox number 1    Then I see "hello"

这里 input field number 就针对了 ContactAdder Activity 中输入框。我如今这样写其实不太友好，比较好的方式是进行再次封装，对 DSL 撰写者透明。好比：

When I enter "hello" as "Contact Name"

step_definition

When (/^I enter "([^\"]*)" as "([^\"]*)"$/) do | text, target |
    index = case target
    when "Contact Name": 1
    ...
    end
    steps %{
        Then I enter #{text} into input field number #{index}
    }end

这样 feature 可读性会强一点。

运行 feature

在运行以前，咱们对 apk 仍是得处理下，不然会遇到一些问题。

• App did not start (RuntimeError)

由于calabash-android的client和test server须要通讯，因此要在 AndroidManifest.xml 中添加权限：

<uses-permission android:name="android.permission.INTERNET" />

• ContacterManager 代码自己的问题

因为 ContacerManager 运行时候，须要你必定要有一个帐户，若是没有帐户 Save 的时候会出错。为了便于运行，咱们要修改下。

源代码地址在 $ANDROID_HOME/samples/android-19/legacy/ContactManager，你们本身去找。

须要修改 com.example.android.contactmanager.ContactAdder 类里面的 createContactEntry 方法，咱们须要对 mSelectedAccount 进行判断， 修改地方以下：

   // Prepare contact creation request
        //
        // Note: We use RawContacts because this data must be associated with a particular account.
        //       The system will aggregate this with any other data for this contact and create a
        //       coresponding entry in the ContactsContract.Contacts provider for us.
        ArrayList<ContentProviderOperation> ops = new ArrayList<ContentProviderOperation>();
        if(mSelectedAccount != null ) {
        ops.add(ContentProviderOperation.newInsert(ContactsContract.RawContacts.CONTENT_URI)
                .withValue(ContactsContract.RawContacts.ACCOUNT_TYPE, mSelectedAccount.getType())
                .withValue(ContactsContract.RawContacts.ACCOUNT_NAME, mSelectedAccount.getName())
                .build());
        } else {
            ops.add(ContentProviderOperation.newInsert(ContactsContract.RawContacts.CONTENT_URI)
                    .withValue(ContactsContract.RawContacts.ACCOUNT_TYPE, null)
                    .withValue(ContactsContract.RawContacts.ACCOUNT_NAME, null)
                    .build());

        }....


  if (mSelectedAccount != null) {
        // Ask the Contact provider to create a new contact
        Log.i(TAG,"Selected account: " + mSelectedAccount.getName() + " (" +
                mSelectedAccount.getType() + ")");
        } else {
            Log.i(TAG,"No selected account");        
        }

代码修改好以后，导出 apk 文件。

运行很简单：

calabash-android run <apk>

若是遇到签名问题，请用： calabash-android resign apk。

能够看看我运行的状况：

➜  calabash  calabash-android run ContactManager.apk
Feature: Login feature

  Scenario: As a valid user I can log into my app                # features/my_first.feature:33135 KB/s (556639 bytes in 0.173s)3315 KB/s (26234 bytes in 0.007s)
    When I press "Add Contact"                                   # calabash-android-0.4.21/lib/calabash-android/steps/press_button_steps.rb:17
    Then I see "Target Account"                                  # calabash-android-0.4.21/lib/calabash-android/steps/assert_steps.rb:5
    Then I enter "hello" into input field number 1               # calabash-android-0.4.21/lib/calabash-android/steps/enter_text_steps.rb:5
    Then I enter "13817861875" into input field number 2         # calabash-android-0.4.21/lib/calabash-android/steps/enter_text_steps.rb:5
    Then I enter "hengwen@hotmail.com" into input field number 3 # calabash-android-0.4.21/lib/calabash-android/steps/enter_text_steps.rb:5
    When I press "Save"                                          # calabash-android-0.4.21/lib/calabash-android/steps/press_button_steps.rb:17
    Then I wait for 1 second                                     # calabash-android-0.4.21/lib/calabash-android/steps/progress_steps.rb:18
    Then I toggle checkbox number 1                              # calabash-android-0.4.21/lib/calabash-android/steps/check_box_steps.rb:1
    Then I see "hello"                                           # calabash-android-0.4.21/lib/calabash-android/steps/assert_steps.rb:51 scenario (1 passed)9 steps (9 passed)0m28.304s

All pass！

你们看到 gif 是 failed，是由于在模拟器上运行的。而上面所有经过的是我在海信手机上运行的。环境不同，略有差别。

总结

本文是对 calabash-android 的一个简单介绍，作的是抛砖引玉的活。移动测试框架并不是 Appium 一家，TesterHome 但愿其余框架的话题也能热火起来。watch and learn！

 本帖已被设为精华贴！