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版本及以上

        地址：http://nodejs.cn/download/

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

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

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

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

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

      打开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/studio/installing/index.html

        仅下载SDK TOOLS安装工具即可，不必安装ANDROID STUDIO，我们的测试代码写在Eclipse里；打开页面后首先看到的是Android studio，拉到页面底部，可以看到Android SDK。

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

        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；图中Android SDK Platform-tools是我自行安装的。

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

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

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

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

        或者遇到这种错误：

        Failed to fetch URL https://dl-ssl.google.com/android/repository/addons_list-2.xml, reason: peer not authenticated

        Failed to fetch URL https://dl-ssl.google.com/android/repository/repository-7.xml, reason: SSLPeerUnverified peer not authenticated

        遇到这种错误一般是因为在公司内网，公司内网设置了代理，需要在Android SDK Manager中设置代理为公司代理。

       修改代理地址和端口后，选择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的，下面的一些通用配置是需要指定的：

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

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

通过上一节我们发现，要获取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创建一个带有控件信息的截图，将鼠标放在想要的地方，即可看到控件的相关属性：