Calabash Calabash Android 使用教程 (一)

詹金辉 · 2015年07月19日 · 最后由 Magicchn 回复于 2018年05月04日 · 3774 次阅读

初次来到 TesterHome,闲着无聊,写一下 Calabash Android 的使用教程,顺便帮助了解自己不熟悉的地方
Calabash Android 是一个开源的 UI 自动化测试框架,基于 robotium 开发,使用了 cucumber 框架,通过 http 和 json 与模拟器和真机上安装的测试 apk 通信,测试 apk 调用 Robotium 的方法来进行 UI 自动化测试,支持行为驱动开发(BDD)的自动化测试工具
优点:
1、封装了常用的 step 操作,如滑动、点击、拖拽、输入、截图等
2、支持 WebView 的识别和用例编写
3、适应于 Android 各版本
缺点:
不支持跨进程的应用测试,目前的解决办法是通过 ruby 调用控制台 adb 命令来完成跨进程的操作

Calabash Android 的安装过程相对其他工具比较复杂,下面列出需要准备的安装包和下载地址

  1. JDK:Java SE 8u51 x64(目前最新),根据自身需要选择版本,建议 1.6 以上版本
    官方下载地址:http://www.oracle.com/technetwork/java/javase/downloads/index-jsp-138363.html(可以根据自己需要的版本下载)

  2. Android SDK:android-sdk_r24.3.3(目前最新),根据自身需要选择版本
    官方下载地址:http://dl.google.com/android/android-sdk_r24.3.3-windows.zip

  3. ant: apache-ant-1.9.6(目前最新)
    官方下载地址:http://mirrors.hust.edu.cn/apache//ant/binaries/apache-ant-1.9.6-bin.zip

  4. ruby:Ruby 2.0.0-p645 (x64),建议用 2.0 或 1.9 版本,其他版本可能和 Calabash 存在兼容问题
    官方下载地址:http://dl.bintray.com/oneclick/rubyinstaller/rubyinstaller-2.0.0-p645-x64.exe (推荐,Windows 安装版,不需要配置环境变量)
    官方下载地址:http://dl.bintray.com/oneclick/rubyinstaller/ruby-2.0.0-p645-x64-mingw32.7z(绿色解压缩版本,需要配置环境变量)

  5. Dev-Kit:4.7.2 x64(重要:需要根据 ruby 安装版本选择)
    官方下载地址:http://dl.bintray.com/oneclick/rubyinstaller/DevKit-mingw64-64-4.7.2-20130224-1432-sfx.exe

安装环境:

Windows 7 旗舰版 64bit

开始安装:

一、安装 JDK



1、下载完安装包后,进入到 Windows 的傻瓜式安装,一路点击下一步,完成安装
2、配置环境变量
右击桌面计算机 - 属性 - 高级系统设置,点击环境变量按钮,进入环境变量编辑界面,看图

在用户变量区域,点击添加,添加环境变量,如果以前有新建,则直接编辑,JAVA_HOME,CLASSPATH,PATH
JAVA_HOME 值(根据自身 JDK 安装目录而定):C:\Program Files\Java\jdk1.8.0_51
CLASSPATH 值:%JAVA_HOME%\lib\tools.jar;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\jre\lib\rt.jar;
PATH 值:%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin

二、安装 Android SDK



注:Android 官网访问可能需要,可以使用一些软件或代理 IP 访问

下载完压缩包后,直接解压即可,下面配置环境变量 ANDROID_HOME,PATH
ANDROID_HOME(根据自身解压目录而定):D:\Dev\Android\sdk
PATH(添加):%ANDROID_HOME%\platform-tools;%ANDROID_HOME%\tools

三、安装 Ant


下载完 Ant,直接解压,然后配置环境变量 CLASSPATH,PATH,ANT_HOME
ANT_HOME(根据解压目录):D:\Dev\apache-ant-1.9.6
CLASSPATH(添加):%ANT_HOME%\lib
PATH(添加):%ANT_HOME%\bin

四、安装 Ruby



下载完后,直接双击安装,勾选上图的两个选项(一个是关联.rb 文件,一个是自动添加环境变量到 PATH),一路下一步,完成
注:安装目录不要有中文或者空格等字符,如果下载的是压缩包,需要配置环境变量

五、安装 Dev-Kit



下载完后双击打开,选择解压目录,点击 Extract 按钮进行解压


Ctrl+R 输入 cmd 回车,cd /d C:\devkit,进入 Dev-Kit 解压目录,再输入 ruby dk.rb init,生成 config.yml 文件,不用关闭 cmd


进入 C:\devkit 目录,找到 config.yml,右键文件用编辑器打开


添加第四部中的 ruby 安装目录: - C:/Ruby200-x64
注:盘符 C 前面有字符 “空格 - 空格”,将该配置复制两行,如图


继续进入前面的 cmd,输入 ruby dk.rb install,如图提示 ruby 目录,就说明安装成功了

六、安装 Calabash-android


首先,我们要修改 gem 的 sources 地址
查询当前 sources:gem sources -l
移除 sources:gem sources --remove https://rubygems.org/
添加新 sources:gem sources -a http://ruby.taobao.org/


然后,输入 gem install calabash-android,安装 calabash-android
注:安装过程需要联网下载安装内容,所以需要正常访问 taobao.org,否则会安装失败

到这,Calabash-android 的安装过程就结束了,下一节将说一下测试 demo 的用例编写和执行

Ubuntu 下面的安装方法相对简单,省略了一些环境变量的配置,下面举例从 ruby 到 calabash-android 的安装过程
sudo apt-get install ruby1.9.1
sudo apt-get install ruby1.9.1-dev
gem install calabash-android

版权所有,转载请注明出处!!O(∩_∩) O~

共收到 6 条回复 时间 点赞

1、麻烦使用 md 语法排版
2、麻烦添加头像

赞!写得很详细!

@chenhengjie123
多谢支持!这是我第一次整理技术帖子,希望能一起发现问题,解决问题,总结自己_^

楼主好,按照文章执行下来 最后执行"gem install calabash-android" 的时候出现错误, 错误内容为 “Failed to build gem native extension.” 请看截图 请问楼主知道怎么解决不? 自己搜了一圈 没有找到解决办法
# 解决(Linux)今天又搜了下,碰到一个人遇到类似的问题,报的错是一样的,按照他的解决办法在 linux 上试了下,发现可以解决这个问题,即通过 rvm 安装 ruby 后再用

gem install calabash-android

命令安装即可。截图:
对于 Windows,这种解决办法的前提是安装 rvm,有人说利用 cygwin 可以安装 rvm,目测可行,试了下,结果折腾 cygwin 就折腾了半天,放弃,在 linux 上用就好了

## 最终解决:是我自己眼拙没看清==!,devkit 选项应该选第一项,因为 ruby 装的是 1.9.3 的,而之前我下载的是第二项

4 楼的那个错误,我也是被坑了好久,最后把 ruby 安装在 C 盘就好了。

詹金辉 [该话题已被删除] 中提及了此贴 08月01日 15:13
詹金辉 Calabash Android 使用教程 (二) 中提及了此贴 12月15日 17:28

gem 的 sources 地址已修改为:
http://gems.ruby-china.org/ added to sources

需要 登录 后方可回复, 如果你还没有账号请点击这里 注册