中文Win7下成功安装calabash

zhangpengfei00

　　Calabash-android是支持android的UI自动化测试框架，网上看见很多同学说，安装calabash比较费劲，特别是Windows下安装，也没有一个详细的安装手册可供参考。正好，今天在Windows 7 上安装calabash-android成功，忍不住要分享一下。
　　我为什么要特别在标题中指出中文Win7？
　　因为我第一次在英文Win7下没碰到任何问题，第二次在中文Win7下安装碰到两个大问题，但都被我求助百度解决了。
　　第一个问题：中文Win7下不认识手机设备，第一台英文Win7下已经有人安装了豌豆荚。
　　第二个问题：中文Win7下运行calabash-android，报GBK错误。
　　calabash简介：

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

安装ruby1.9.3
　　calabash-android 的git网址： https://github.com/calabash/calabash-android
　　进入Installation: https://github.com/calabash/calabash-android/blob/master/documentation/installation.md
　　因为要在Windows下安装，所以按照指示进入： http://rubyinstaller.org/
　　点击红色的Download图标，进入： http://rubyinstaller.org/downloads/

　　Ruby2.0据说不兼容旧版本，所以下载稳定版Ruby 1.9.3-p545.7z 解压到D:\下
　　把ruby的执行目录D:\ruby-1.9.3-p545-i386-mingw32\bin，加入到环境变量Path
　　运行命令ruby -v，看到如下结果，表示ruby安装成功
　　

C:\Users\asus>ruby -v　　
ruby 1.9.3p545 (2014-02-24) [i386-mingw32]
　　

安装JDK 7u65
　　安装JDK网上有很多教程，以下简略介绍。
　　http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html
　　jdk-7u65-windows-x64.exe
　　安装，并设置环境变量：
　　

JAVA_HOME=C:\Program Files\Java\jdk1.7.0_65　　
Path添加内容：  ";%JAVA_HOME%\bin;%JAVA_HOME%\..\jre\bin"
　　

　　启动命令行工具cmd.exe，输入:
　　

C:\Users\asus>javac -version　　
javac 1.7.0_65
　　

　　看到上述结果，说明jdk已正确安装。

安装Android SDK
　　到 http://developer.android.com/sdk/index.html 下载适用于Windows的SDK
　　google的网站，国内正常访问不了了。
　　幸好有个中国好码农整理了一个最新版Android SDK下载网站：
　　http://www.androiddevtools.cn/
　　我现在的是 ADT Bundle > 23.0.2 > Windows > 64位
　　因为我的Windows7已经安装了64位的JDK，所以必须安装64位的Android SDK(主要是64位的Eclipse)
　　在目录D:\adt-bundle-windows-x86_64-20140702\eclipse下双击文件eclipse.exe
　　看到Android Develop Kit启动页：


　　设置环境变量：
　　ANDROID_HOME=D:\adt-bundle-windows-x86_64-20140702\sdk

安装Ant-1.9.4
　　网址：http://ant.apache.org/bindownload.cgi
　　下载 apache-ant-1.9.4-bin.zip
　　解压到D:\下，
　　设置环境变量：
　　

ANT_HOME=D:\apache-ant-1.9.4　　
Path添加内容：  ";%ANT_HOME%\bin"
　　

　　启动命令行工具cmd.exe，输入:
　　

C:\Users\asus>ant　　
Buildfile: build.xml does not exist!
　　
Build failed
　　

　　看到上述结果，说明ant已正确安装。

gem命令安装calabash-android
　　设置gem的仓库为taobao
　　

C:\Users\asus>gem sources -l　　
*** CURRENT SOURCES ***
　　

　　
http://rubygems.org/
　　

　　
C:\Users\asus>gem sources --remove http://rubygems.org/
　　
source https://rubygems.org/ not present in cache
　　

　　
C:\Users\asus>gem sources -a http://ruby.taobao.org/
　　
http://ruby.taobao.org/ added to sources
　　

　　
C:\Users\asus>gem sources -l
　　
*** CURRENT SOURCES ***
　　

　　
http://ruby.taobao.org/
　　

　　用gem命令安装calabash-android
　　

C:\Users\asus>gem install calabash-android　　
...
　　
Installing RDoc documentation for escape-0.0.4...
　　
Installing RDoc documentation for calabash-android-0.5.1...
　　

　　
C:\Users\asus>calabash-android version
　　
0.5.1
　　

下载calabash-android-demoapp
　　https://github.com/calabash/calabash-android-demoapp
　　点击 Download ZIP下载calabash-android-demoapp-master.zip，并解压到D:\

ADT中导入并运行calabash-android-demoapp


　　选择： D:\calabash-android-demoapp-master


安装手机驱动
　　把手机通过USB线接到电脑上，手机上确保打开“USB调试”
　　如果电脑屏幕右下角提示，设备驱动已正确安装，请看下一步。
　　如果电脑屏幕右下角提示，设备驱动安装失败：

　　需要到网站 http://www.drivergenius.com/ 下载并安装驱动精灵标准版，只要打开驱动精灵，就会引导你安装手机驱动。

　　驱动安装成功后：

　　接下去在ADT中运行Run > Run As > Android Application：

　　点击"OK"按钮，ADT就会上传AndroidDemoProject.apk到手机，并启动应用，看到“Hello World, AndroidDemoProject!”


使用calabash-android运行AndroidDemoProject.apk
　　打开cmd，进入D:\calabash-android-demoapp-master\calabash目录，运行：
　　

calabash-android run D:\calabash-android-demoapp-master\bin\AndroidDemoProject.apk　　


　　主要错误信息：helpers.rb:105:in `scan': invalid byte sequence in GBK
　　可是我在英文Windows上运行正确啊，一定是英文系统和中文系统的缺省编码问题：
　　cmd > 属性 > 选项 > 当前代码页：936 简体中文 GBK

　　照着 http://blog.sina.com.cn/s/blog_628e2ab30101ajcg.html 的解决方案，把cmd的中文编码设置成UTF-8
　　cmd中输入：chcp 65001

　　cmd > 属性 > 选项 > 当前代码页：65001 UTF-8

　　再次运行calabash-android：


calabash-android打印彩色结果
　　上面的测试结果提醒：WARNING: You must use ANSICON 1.31 or higher
　　从 https://github.com/adoxa/ansicon/ 下载ansicon并启动，
　　同样要输入 chcp 65001
　　再次运行calabash-android：

　　大功告成！

建立ansicon快捷链接
　　接下去好人做到底，在桌面上建一个cmd快捷链接，点击后直接进入UTF-8编码的ansicon控制台
　　确保ansicon.exe放置在Path能找到的目录下，比如，我放在ruby的bin目录下：

　　桌面上建一个cmd快捷链接：


　　注意，快捷链接的目标：
　　

%windir%\system32\cmd.exe /k chcp 65001&&ansicon　　

　　打开该快捷链接后：


calabash-android输出html报告文件
　　

calabash-android run ../bin/AndroidDemoProject.apk  --format html --out=report.html　　




关于GBK编码问题的后续补充

• 我回去看了英文Win7和的cmd.exe的编码，也是GBK，但是没有出现过“invalid byte sequence in GBK ”的问题　　
  
  
• 我在中文Win7上用chcp 65001设置成UTF-8，并测试成功后，再尝试直接cmd.exe/ansicon.exe/powershell.exe保持GBK编码的情况下，直接运行calabash，再也没有报过“invalid byte sequence in GBK ”的问题，难道第一次正确运行后，自动修改了什么配置吗？　　
  
  
• 在中文Win7上用chcp 65001设置成UTF-8后，如果calabash的脚本中包含中文，运行calabash时不能打印出中文内容。　　
  
  
• 在中文Win7的GBK编码的命令行下，如果calabash的脚本中包含中文，运行calabash时能打印出中文内容。　　
  
  
• 在英文Win7的GBK编码的命令行下，如果calabash的脚本中包含中文，运行calabash时能打印出中文内容。　　
  
  
• 在Ubuntu Linux的控制台下，如果calabash的脚本中包含中文，运行calabash时能打印出中文内容。
  

　　算了，不去找原因了，记住就是了。
　　所以，建立calabash测试环境的容易程度：
　　Linux > 英文Windows > 中文Windows