Calabash Calabash Android 简介

恒温 · March 22, 2014 · Last by Monkey replied at March 25, 2014 · 2179 hits
本帖已被设为精华帖!

什么是 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 环境

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:3
3135 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:5

1 scenario (1 passed)
9 steps (9 passed)
0m28.304s

All pass!

大家看到 gif 是 failed,是因为在模拟器上运行的。而上面全部通过的是我在海信手机上运行的。环境不一样,略有差异。

总结

本文是对 calabash-android 的一个简单介绍,做的是抛砖引玉的活。移动测试框架并非 Appium 一家,TesterHome 希望其他框架的话题也能热火起来。watch and learn!

如果觉得我的文章对您有用,请随意打赏。您的支持将鼓励我继续创作!
共收到 6 条回复 时间 点赞

沙发抢了,LICEcap也收了

恒温 #2 · March 22, 2014 作者

LICEcap 是用来录制 gif 的,推荐

大赞!!!

calabash android利用的是robotium自身的远程调用机制吧,还是自己做的远程调用?

恒温 #5 · March 23, 2014 作者

#4楼 @seveniruby 就是 robotium

这句,说出了你的良苦用心阿。。sudo gem install calabash-android # 如果权限不够用这个。
哈哈

7Floor has been deleted
8Floor has been deleted
9Floor has been deleted
10Floor has been deleted
11Floor has been deleted
12Floor has been deleted
13Floor has been deleted
14Floor has been deleted
15Floor has been deleted
16Floor has been deleted
需要 Sign In 后方可回复, 如果你还没有账号请点击这里 Sign Up