Windows下部署Appium教程（Android App自动化测试框架搭建）

----------------------------------------------appium的一些基本概念----------------------------------------------

        appium的核心其实是一个暴露了一系列REST API的server。

这个server的功能其实很简单：监听一个端口，然后接收由client发送来的command。翻译这些command，把这些command转成移动设备可以理解的形式发送给移动设备，然后移动设备执行完这些command后把执行结果返回给appium server，appium server再把执行结果返回给client。

在这里client其实就是发起command的设备，一般来说就是我们代码执行的机器，执行appium测试代码的机器。狭义点理解，可以把client理解成是代码，这些代码可以是java/ruby/python/js的，只要它实现了webdriver标准协议就可以。

如何部署和使用Appium，一起来看看吧！

---------------------------------------------------安装各种组件----------------------------------------------------

一、安装nodejs0.8版本及以上

        地址：https://nodejs.org/download/

        下载合适自己机型的版本，Windows下安装很简单，一直下一步；

        验证安装是否成功，Win+R>>cmd->>node - v，如出现类似以下提示，证明安装成功！

        

二、安装配置Java的JDK（Java软件开发工具包）

        地址：http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html

        下载合适自己机型的版本，Windows下安装很简单，一直下一步；

        

        安装完成后，在安装目录下可以看到两个文件夹，一个是jdk，一个是jre；

        

        打开jdk的安装目录下的bin目录，里面有许多后缀名为exe的可执行程序，这些都是JDK包含的工具。通过配置JDK的环境变量，我们可以方便地调用这些工具及它们的命令：

        javac：Java编译器，将源代码转成字节码。

        jar：打包工具，将相关的类文件打包成一个文件。

        javadoc：文档生成器，从源码注释中提取文档。

        jdb：debugger，调试查错工具。

        java：运行编译后的java程序。

        

        1、JAVA_HOME

        新建一个名叫“JAVA_HOME”的用户变量，如不会请参考：http://my.oschina.net/u/563250/blog/490614

        变量值为JDK的安装目录，笔者为    C:\Program Files\Java\jdk1.8.0_51

        创建好后则可以利用%JAVA_HOME%作为JDK安装目录的统一引用路径；

        2、PATH

        在已有的环境变量PATH变量值的最后追加     ;%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin

        3、CLASSPATH

         新建一个名叫“CLASSPATH”的用户变量， 变量值为    .;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar

        注意变量值字符串前面有一个"."表示当前目录，设置CLASSPATH 的目的，在于告诉Java执行环境，在哪些目录下可以找到您所要执行的Java程序所需要的类或者包；

        验证安装是否成功，Win+R>>cmd->>java -version，如出现类似以下提示，证明安装成功！

        

三、安装配置Android的SDK（Android软件开发工具包）

        地址：http://developer.android.com/sdk/installing/index.html

        仅下载SDK TOOLS安装工具即可，不必安装ANDROID STUDIO，我们的测试代码写在Eclipse里；

        

        安装完成后，配置环境变量：

        1、ANDROID_HOME

        新建一个名叫“ANDROID_HOME”的用户变量

        变量值为Android SDK的安装目录，笔者为    C:\Program Files (x86)\Android\android-sdk

        2、PATH

         在已有的环境变量PATH变量值的最后追加     ;%ANDROID_HOME%\tools;%ANDROID_HOME%\platform-tools

         在安装目录或开始菜单中找到SDK Manager.exe并打开，工具会自动检测系统当前安了哪些SDK工具，并获取各个版本可安装的SDK，默认情况下只安装了Tools下的Android SDK Tools；

        

        获取可安装的SDK版本时，国内有墙，有时候会出现获取失败的情况，如下图：

        

        可以通过如下设置解决问题，选择Tools->>Options打开Android SDK Manager - Settings

        将HTTP Proxy Server和HTTP Proxy Port，连接服务器使用的代理地址和端口分别修改为“mirrors.opencas.cn”“80”；

        若该地址仍然无法解决问题不正确，请参考该网站获得更多代理地址，或从该网站上直接手动下载：http://www.androiddevtools.cn/

        

        修改代理地址和端口后，选择Packages->>Reload，重新获取，等待Android SDK Tools下方提示Done loading packages，即加载完成。选择需要安装的SDK，Appium官方推荐API 17及以上的版本都支持，可以任意安装一个API 17及以上的版本，选择右侧的Install xx packages；

        

        验证安装是否成功，Win+R>>cmd->>android -h，如出现类似以下提示，证明安装成功！（当然，已经可以正常运行Android SDK Tools，肯定是安装成功了，不妨再检查一下）

        

三、安装Appium

        地址：http://appium.io/

        点击Download Appium，默认就下载的是AppiumForWindows安装包，下载完成后，解压安装包，运行appium-installer.exe进行安装；

        

        注：还可以使用node.js的模块管理工具npm，输入命令在线安装（Win+R->>cmd->>npm install -g appium），但在线安装失败的几率比较大，貌似是因为网络不稳或权限问题无法解压，还是推荐直接下载Windows安装包；

        安装完成后，配置环境变量：

        1、PATH

        在已有的环境变量PATH变量值的最后追加Appium的安装bin目录，笔者为    C:\Program Files (x86)\Appium\node_modules\.bin

        验证安装是否成功，Win+R>>cmd->>appium，如出现类似以下提示，证明安装成功！

        

四、安装Eclipse

        地址：http://www.eclipse.org/downloads/

        选择Eclipse IDE for Java EE Developers，下载合适自己机型的IDE，Eclipse不需要安装，直接将下载的安装包解压，并打开eclipse.exe，选择一个工作目录即可；

        

---------------------------------------------------测试前的准备----------------------------------------------------

一、启动一个Android模拟器或者连接上一个API 17以上的android真机

        （1）打开Android SDK Tools中的AVD Manager，点击右侧的create，新建一个新的AVD（Android Virtual Device），设置AVD的各个属性，点击OK；

        注：若SDK下载安装完整，但CPU/ABI一栏无法选择，被灰掉或禁用，则可能是SDK安装目录太长，将SDK拷贝到别的目录，再次打开AVD Manager.exe，新建一个AVD，CPU/ABI一栏就可以选择了；

        

        （2）点击右侧的start，选择Launch，启动模拟器；

        

        （3）默认为锁定状态，一定要滑动屏幕解锁，否则Appium无法启动被测试应用程序；

            

二、打开Appium

    双击桌面上Appium图标，点击右上角的Launch the Appium Node Server按钮；

    

    或：Win+R->>cmd->>appium，启动Appium Server服务（和上诉方法二选一即可）；

三、在Eclipse中配置Selenium、Appium类库

（1）下载Selenium类库

    client地址：http://selenium-release.storage.googleapis.com/2.44/selenium-java-2.44.0.zip 

    server地址：http://selenium-release.storage.googleapis.com/2.44/selenium-server-standalone-2.44.0.jar

    （确认2014.11.14有效，如无效请访问http://docs.seleniumhq.org/download/ 进行下载）

（2）下载Appium java版类库

    地址：http://appium.io/downloads.html

    选择java，下载jar包；

    

    

（3）在Eclipse中导入

        打开Eclipse，新建一个java Project

        

   在新项目上，新建一个Folder，命名为“lib”，将下载的三个类库“selenium-java-2.44.0.jar”、“selenium-server-standalone-2.44.0.jar”、“java-client-3.1.0.jar”，从文件夹中直接拖放到“lib”下；

    

    在项目上右键->>Build Path->>Configure Build Path->>Libraries->>Add JARs（添加Java包），将刚刚拖进项目的3个jar包，选择进来；

    

-------------------------------------------------------开始测试--------------------------------------------------------

    （1）在项目的src下，新建一个package，在package下新建一个class（笔者的命名分别为“appiumtest”和“demo2”）；

    

    在类中输入以下代码，代码内容为，启动Android模拟器上自带的Calculator计算器，并分别点击“1+2=”；

package appiumtest;//package名

import io.appium.java_client.android.AndroidDriver;
import org.openqa.selenium.remote.CapabilityType;
import org.openqa.selenium.remote.DesiredCapabilities;
import java.net.URL;
import org.junit.After;
import org.junit.Before;
import org.junit.Test;

public class demo2 {

private AndroidDriver driver;

@Before
public void calc() throws Exception {
    DesiredCapabilities capabilities = new DesiredCapabilities();
    capabilities.setCapability(CapabilityType.BROWSER_NAME, "");// 这句不是必须的
    capabilities.setCapability("deviceName", "Android Emulator");
    capabilities.setCapability("platformVersion", "4.2.2");
    capabilities.setCapability("platformName", "Android");
    capabilities.setCapability("appPackage", "com.android.calculator2");
    capabilities.setCapability("appActivity", ".Calculator");
    driver = new AndroidDriver(new URL("http://127.0.0.1:4723/wd/hub"),capabilities);
}

@After
public void tearDown() throws Exception {
    driver.quit();
}

@Test
public void add() {
    driver.findElementByName("1").click();
    driver.findElementByName("+").click();
    driver.findElementByName("2").click();
    driver.findElementByName("=").click();
    driver.quit();
    }
}

    （2）在项目上右键->>Run As->>JUnit Test；

    

（3）测试用例正在运行，查看Appium，输出了很多运行的日志，查看模拟器，Appium控制模拟器打开了自带的计算器，并分别点击“1+2=”，至此部署Appium测试环境已完成并测试成功！接下来就可以开发真正的自动化测试用例啦！

--------------------------------------分割线（Desired Capabilities详解）-------------------------------------

        Desired Capabilities在启动session的时候是必须提供的,它本质上是key value的对象，它告诉appium server这样一些事情：

    1、本次测试是启动浏览器还是启动移动设备？

    2、是启动andorid还是启动ios？

    3、启动android时，app的package是什么？

    4、启动android时，app的activity是什么？

    Appium的Desired Capabilities是扩展了webdriver的Desired Capabilities的，下面的一些通用配置是需要指定的：

Capability名称	描述	可能的值举例
automationName	使用哪种自动化引擎（默认：Appium）	Appium   ，Selendroid
platformName	使用哪种移动平台	iOS，Android，FirefoxOS
platformVersion	移动平台版本	7.1，4.4
deviceName	启动哪种设备？真机还是模拟器	iPhone   Simulator， iPad Simulator，iPhone Retina 4-inch，Android Emulator，Galaxy   S4，etc…. On iOS，this should be one of the valid devices returned by   instruments with instruments -s devices. On Android this capability is   currently ignored.
app	应用（.ipa   .apk .zip）的绝对路径或远程的Http URL	/abs/path/to/my.apk   ， http://myapp.com/app.ipa
browserName	移动浏览器的名称（如果被测应用程序已安装到移动设备，则可设置为空字符串）	‘Safari’   for iOS and ‘Chrome’, ‘Chromium’, or ‘Browser’ for Android
newCommandTimeout	客户端退出和结束会话之前，Appium等待从客户端发来一个新命令的时间，即超时时间（秒）	60
autoLaunch	是否自动安装和启动被测app（默认：true）	true,   false
language	(Sim/Emu-only)   Language to set for the simulator / emulator	fr
locale	(Sim/Emu-only)   Locale to set for the simulator / emulator	fr_CA
udid	物理机的id	1ae203187fc012g
orientation	(Sim/Emu-only)   start in a certain orientation	LANDSCAPE，PORTRAIT
autoWebview	Move   directly into Webview context（默认：false）	true,   false
noReset	在测试前不重置app的状态（默认：false）	true,   false
fullReset	IOS：删除整个模拟器目录；Android：通过卸载app的方式重置app的状态，而不是仅清除app的数据，在Android设备上，当测试结束后，也会彻底移除app（默认：false）	true, false

下面这些属性是android平台特定的（还有很多没有列出来的可以查看：http://appium.io/documentation.html）：

Capability名称	描述	可能的值举例
appActivity	待测试的app的Activity名字，原生app的话要在activity前加个"."	MainActivity，   .Settings
appPackage	待测试的app的java   package	com.example.android.myApp，   com.android.settings

--------------------------------------分割线（工具的使用）-------------------------------------

通过上一节我们发现，要获取app的package和activity名字，要用什么工具呢？

一、monitor.bat

        该文件位于SDK安装目录tools下，如笔者在“C:\Program Files (x86)\Android\android-sdk\tools”下，双击运行monitor.bat即可运行，该工具可以帮我们找到android控件的content-description，为以后的find_element_by_accessibility_id 定位方法做参数使用，也可查看被测app的appPackage，如下图。

    

二、uiautomatorviewer.bat

        该文件位于SDK安装目录tools下，如笔者在“C:\Program Files (x86)\Android\android-sdk\tools”下，双击uiautomatorviewer.bat即可运行，该工具主要用来查看控件的属性，比如resource id，class name等，也可查看被测app的appPackage（Desired Capabilities中使用）。

        使用方法（以计算器为例）：将模拟器的打开，点击左上角绿色的Android小图标（Device ScreenShot），可以为当前界面UI创建一个带有控件信息的截图，将鼠标放在想要的地方，即可看到控件的相关属性：