笔者为了搭这个环境,呕心沥血花了3/4天,calabash android在Windows下安装算是比较复杂,在MAC上比较简单
一、环境搭建
首先,先说我们需要的环境
1、JDK
2、Android SDK
这两个环境不多说,不清楚的可以参照“UI Automator环境配置”,里面描述的很详细
3、安装Ant,网址:http://ant.apache.org/bindownload.cgi 设置环境变量:ANT_HOME=D:\apache-ant-1.10.5 Path添加内容: ";%ANT_HOME%\bin"
选择apche-ant-1.10.5-bin.zip下载
4、ruby:http://rubyinstaller.org/downloads/(笔者下载了比较稳定的2.3.3,为什么下这个,我尝试了无数遍,几乎每个版本都尝试安装,若ruby<2.0.0,会出现版本过低,无法签名的诡异事件,若版本过高,和之后我们需要安装的calabash-android会存在冲突),安装ruby时,勾选自动创建环境变量,若ruby版本较高,会有转换UFT-8的弹框,也需要勾选上,防止后面运行时要转换格式
!!!!下载ruby2.3.3之后自带的ruby zip是1.2.2,注意这里有一个大坑,再后面build test server时一直提示ruby zip 1.2.2不是自定义的压缩包之类的,所以ruby安装成功之后我们需要把ruby zip 1.2.2替换成1.2.2。替换方法:https://rubygems.org/gems/rubyzip/versions/1.2.0中点击获取1.2.1的地址,在cmd中输入gem install rubyzip -v 1.2.1运行即可
5、Dev-Kit:4.7.2 x64(重要:需要根据ruby安装版本选择),因为我的电脑是64bit,所以ruby和Dev-Kit都选择64bit下载安装
以上动作都执行完毕后,我们需要安装calabash-android,安装路径可以选择在cd /d devkit下(之前很多安装教程都介绍获取taobao镜像安装,但现在这个网址已经不维护了,我们使用一个简单的方法来替代它,直接在devkit下输入gem install calabash-android来安装,注意,使用这个方法安装的是calabash-android的最新版本,如果你直接使用最新版本,后面又有一个大坑等你,那就是你的签名与创建的test server不一致,导致你的脚本永远run不起来,为了解决这个问题我们安装较低版本calabash-android 0.9.5,网址:https://rubygems.org/gems/calabash-android)
关于ruby zip 1.2.2与calabash-android 0.9.8导致的错误请参考:https://github.com/calabash/calabash-android/issues/802
Ok,到这里,我们所有的环境都安装好了,现在我们检查一下,分别输入:javac version,android,ruby -v,calabash-android version,返回版本及正确信息即可,代表我们的环境已经没有问题
二、实际运行
1、我们到calabash官网下载测试demo来检验我们的环境是否可以成功跑通:下载测试用例:https://github.com/bootstraponline/calabash_android_example,直接点download即可。
我们自己建立一个类似于“android test”的文件夹
命令符cd到这个路径下,输入calabash-androi gen来键我们的骨架,features目录下有个my_first.feature文件,这个就是用例文件,另外生成了两个文件夹,一个step_definitions用来存放一些自定义step文件,一个support存放初始化文件
2、对测试apk重签名,签名方法:calabash-android resign 测试apk,注意在这里你可能会遇到错误,提示你找不到keystore,这是你需要输入calabash-android setup进行签名设置
keytool -genkey -v -keystore C:\Users\Administrator\.android\debug.keystore -alias androiddebugkey -storepass android -keypass android -keyalg RSA -keysize 2048 -validity 10000 -dname "CN=Android Debug,O=Android,C=US"
根据提示依次输入
1)keystore路径:C:\Users\Administrator\.android\debug.keystore
2)password:android
3)依赖alias:androiddebugkey
设置完后再次重签即可成功
3、你需要创建一个test server来支持apk跑通,calabash-android build 测试APK,此时你可能会遇到GBK错误。我们需要修改cmd控制台编码,输入chcp 65001进行编码切换,然后继续运行,你可以看到服务已经被建立了,这就是用于安装到测试机上面的测试服务apk。
4、最后我们可以开始run我们的apk了,如果你的脚本中有中文,可能不会被识别,你需要执行chcp 936切换GBK,再次run一下,成功!!
三、calabash-android遇到的坑总结
1)第一大坑,自动安装calabash-android最新版,导致签名文件永远不成功,遂将版本降至0.9.5,gem install calabash-android -v 0.9.5
2)第二大坑,ruby zip 1.2.2,永远提示1.2.2不是标准的ruby zip文件,遂安装1.2.1版本,gem install rubyzip -v 1.2.1
3)第三大坑,将calabash-android降下来后,又提示ruby有过时的依赖性,(因为我之前一直都安装最新ruby版本),遂将ruby降至2.3.3