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