转载：Appium 简明教程：http://www.testclass.net/appium

            https://www.cnblogs.com/fnng/p/4540731.html

Appium 官网：http://appium.io/

Github 地址：https://github.com/appium/appium

主要包括以下几部分：

下面这段介绍来自于 appium 的官网。

Appium is an open-source tool you can use to automate mobile native, mobile web, and mobile hybrid applications on iOS and Android platforms. “Mobile native apps” are those written using the iOS or Android SDKs. “Mobile web apps” are web apps accessed using a mobile browser (Appium supports Safari on iOS and Chrome on Android). “Mobile hybrid apps” have a native wrapper around a “webview” – a native control that enables interaction with web content. Projects like Phonegap, for example, make it easy to build apps using web technologies that are then bundled into a native wrapper – these are hybrid apps.

Importantly, Appium is “cross-platform”: it allows you to write tests against multiple platforms (iOS, Android), using the same API. This enables a large or total amount of code reuse between iOS and Android testsuites.

我们可以从上面的介绍里获得这样的一些信息：

Appium was designed to meet mobile automation needs according to a certain philosophy. The key points of this philosophy can be stated as 4 requirements:

You shouldn’t have to recompile your app or modify it in any way in order to automate it. You shouldn’t be locked into a specific language or framework to write and run your tests. A mobile automation framework shouldn’t reinvent the wheel when it comes to automation APIs. A mobile automation framework should be open source, in spirit and practice as well as in name!

appium 的设计哲学是这样的：

We meet requirement #2 by wrapping the vendor-provided frameworks in one API, theWebDriver API. WebDriver (aka “Selenium WebDriver”) specifies a client-server protocol (known as the JSON Wire Protocol). Given this client-server architecture, a client written in any language can be used to send the appropriate HTTP requests to the server. There are already clients written in every popular programming language. This also means that you’re free to use whatever test runner and test framework you want; the client libraries are simply HTTP clients and can be mixed into your code any way you please. In other words, Appium & WebDriver clients are not technically “test frameworks” – they are “automation libraries”. You can manage your test environment any way you like!

We meet requirement #3 in the same way: WebDriver has become the de facto standard for automating web browsers, and is a W3C Working Draft. Why do something totally different for mobile? Instead we have extended the protocol with extra API methods useful for mobile automation.

It should be obvious that requirement #4 is a given – you’re reading this because Appium is open source.

        首先，为了能够实现哲学里描述的第2条，也就是不应该让移动端自动化测试限定在某种语言和某个具体的框架；也就是说任何人都可以使用自己最熟悉最顺手的语言以及框架来做移动端自动化测试；appium选择了client-server的设计模式。只要client能够发送http请求给server，那么的话client用什么语言来实现都是可以的，这就是appium及webdriver如何做到支持多语言的；

        其次，为了能够实现不要为了移动端的自动化测试而重新发明轮子，重新写一套惊天动地的api；也就是说webdriver协议里的api已经够好了，拿来改进一下就可以了；这个思想，appium扩展了webdriver的协议，没有自己重新去实现一套。这样的好处是以前的webdriver api能够直接被继承过来，以前的webdriver各种语言的binding都可以拿来就用，省去了为每种语言开发一个client的工作量；

        最后 appium 当然是开源的，这也实现了哲学思想里的最后一点。

appium 是一个自动化测试开源工具，支持 iOS 平台和 Android 平台上的原生应用，web应用和混合应用。

“移动原生应用”是指那些用iOS或者 Android SDK 写的应用（Application简称app）。

“移动web应用”是指使用移动浏览器访问的应用（appium支持iOS上的Safari和Android上的 Chrome）。

“混合应用”是指原生代码封装网页视图——原生代码和 web 内容交互。比如，像 Phonegap，可以帮助开发者使用网页技术开发应用，然后用原生代码封装，这些就是混合应用。

重要的是，appium是一个跨平台的工具：它允许测试人员在不同的平台（iOS，Android）使用同一套API来写自动化测试脚本，这样大大增加了iOS和Android测试套件间代码的复用性。

appium类库封装了标准Selenium客户端类库，为用户提供所有常见的JSON格式selenium命令以及额外的移动设备控制相关的命令，如多点触控手势和屏幕朝向。

appium客户端类库实现了Mobile JSON Wire Protocol（一个标准协议的官方扩展草稿）和W3C WebDriver spec（一个传输不可预知的自动化协议，该协议定义了MultiAction 接口）的元素。

appium服务端定义了官方协议的扩展，为appium 用户提供了方便的接口来执行各种设备动作，例如在测试过程中安装/卸载App。这就是为什么我们需要appium特定的客户端，而不是通用的Selenium 客户端。当然，appium 客户端类库只是增加了一些功能，而实际上这些功能就是简单的扩展了Selenium 客户端，所以他们仍然可以用来运行通用的Selenium会话。

appium 是跨平台的，可以用在OSX，Windows以及Linux桌面系统上运行。

appium选择了Client/Server的设计模式。只要client能够发送http请求给server，那么的话client用什么语言来实现都是可以的，这就是appium及Selenium(WebDriver)如何做到支持多语言的原因；

appium 扩展了 WebDriver 的协议，没有自己重新去实现一套。这样的好处是以前的 WebDriver API 能够直接被继承过来，以前的 Selenium（WebDriver）各种语言的 binding 都可以拿来就用，省去了为每种语言开发一个 client 的工作量；

在安装和介绍 appium 之前，非常有必要介绍一下appium是如何工作的。

通过上面一张图简单展示了 appium 的工具原理。

当我在 MAC 平台上，通过 Python（python-client ）编写了一个appium自动化脚本并执行，请求会首先到 appium.dum （MAC下的 appium-Server），appium-Server 通过解析，驱动 iOS 设备来执行 appium 自动化脚本。

或者，我在 Windows 平台上，通过 Java（ java-client ）编写了一个 appium 自动化脚本并执行，请求会首先到 appiumForWindow.zip（Window下的appium-Server），appium-Server通过解析，驱动Android虚拟机或真机来执行appium脚本。

所以，你会看到 appium 的强大之处就在于此。

这才是你最关心的问题，使用 appium 都需要安装些什么？其实，从 appium 工作原理你就应该知道需要装什么了。

编程语言

appium client

appium Server

测试运行环境

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

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

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

这样的设计思想带来了一些好处：

session就是一个会话，在webdriver/appium，你的所有工作永远都是在session start后才可以进行的。一般来说，通过POST /session这个URL，然后传入Desired Capabilities就可以开启session了。

开启session后，会返回一个全局唯一的session id，以后几乎所有的请求都必须带上这个session id，因为这个seesion id代表了你所打开的浏览器或者是移动设备的模拟器。

进一步思考一下，由于session id是全局唯一，那么在同一台机器上启动多个session就变成了可能，这也就是selenium gird所依赖的具体理论根据。

Desired Capabilities携带了一些配置信息。从本质上讲，这个东东是key-value形式的对象。你可以理解成是java里的map，python里的字典，ruby里的hash以及js里的json对象。实际上Desired Capabilities在传输时就是json对象。

Desired Capabilities最重要的作用是告诉server本次测试的上下文。这次是要进行浏览器测试还是移动端测试？如果是移动端测试的话是测试android还是ios，如果测试android的话那么我们要测试哪个app？ server的这些疑问Desired Capabilities都必须给予解答，否则server不买账，自然就无法完成移动app或者是浏览器的启动。

具体例子如下：

For example, we might set the platformName capability to iOS to tell Appium that we want an iOS session, rather than an Android one. Or we might set the safariAllowPopupscapability to true in order to ensure that, during a Safari automation session, we’re allowed to use JavaScript to open up new windows. See the capabilities doc for the complete list of capabilities available for Appium

这就是每次我们在命令行用 appium 命令打开的东西。

由于原生的 webdriver api 是为 web 端设计的，因此在移动端用起来会有点不伦不类。appium 官方提供了一套 appium client，涵盖多种语言 ruby/java/python，在我看来 ruby client 是实现最好的。在测试的时候，一般要使用这些 client 库去替换原生的webdriver 库。这实际上不是替换，算是 client 对原生 webdriver 进行了一些移动端的扩展，加入了一些方便的方法，比如 swipe之类，appium client 让我们可以更方便的写出可读性更好的测试用例。

appium server 的 GUI 版本，前者用在 osx 上，后者是 windows 上。可视化、不需要装 node，可以看 app 的 UI 结构是这个东东的卖点。

Android SDK（Software Development Kit，软件开发工具包）提供了 Android API 库和开发工具构建，测试和调试应用程序。简单来讲，Android SDK 可以看做用于开发和运行 Android 应用的一个软件。

我在官网上没有找到单独 Android SDK 的下载链接，官方推荐下载包含 Android SDK 的 Android Studio。

Android Studio & Android SDK 下载地址：https://developer.android.google.cn/studio/

一方面是包含 Android SDK 的 Android Studio 的安装包很大。另一方面它们二者也不是强关联的。因为 Appium 也会用到 Android SDK，而 Android Studio 也可以调用真机来运行 Android 程序。

所以，Android SDK 下载地址（才是我们想要的）：http://tools.android-studio.org/index.php/sdk

你可以通过别的网站进行下载，身为IT从业人员，如何利用搜索工具和科学上网工具是你的必备技能。

将下载的 Android SDK 解压，将得到如下目录。

图 Android SDK目录

下面设置 Android 环境变量，方法与Java环境变量类似。我本机的目录结果为：

D:\android\android-sdk-windows

下面设置环境变量：

“我的电脑” 右键菜单 ---> 属性 ---> 高级 ---> 环境变量 ---> 系统变量 ---> 新建...

找到 path 变量名—> “编辑” 添加：

双击 SDK Manage.exe 启动 SDK 管理器。

你需要科学上网，或者查找到国内的 Android 镜像，安装一个版本的 Android 虚拟机。你可以根据自己的喜好选择安装 Android 5.0 /5.1 /6.0 /7.0 版本。

这里推荐一个网站：http://www.androiddevtools.cn/

双击 AVD Manage.exe 启动AVD管理器。

点击 “Create...” 按钮，创建Android虚拟机。

不要选择超过电脑屏幕分辨率的 Device，其它选项参考上图。点击 “OK” 创建完成。在 AVD Manage 工具中选中创建的Android虚拟机，点击 “Start...” 按钮启动。

Android 模拟器已经启动。

windows 依赖：

安装 nodejs 通过官方的安装程序来安装。

安装 android 的 sdk 包，(http://developer.android.com/sdk/index.html)，运行依赖sdk中的'android'工具。并确保你安装了Level17或以上的版本api。设置 ANDROID_HOME 系统变量为你的 Android SDK 路径，并把 tools platform-tools 两个目录加入到系统的 Path 路径里。因为这里面包含有一些执行命令

安装 java 的 JDK，并设置 JAVA_HOME 变量为你的 JDK 目录。

appium 官网下载：http://appium.io/downloads.html

下载 Appium-windows-1.18-1.zip 解压即可

可以创建 Appium.exe 的快捷方式放到桌面上，双击启动，appium server 界面如下。

点击 Start Server，

Appium-Server 已经可以打开了。至于 Appium 的使用我们放到后面的章节进行介绍。

appium client 是对 webdriver 原生 api 的一些扩展和封装。它可以帮助我们更容易的写出用例，写出更好懂的用例。

appium client 是配合原生的 webdriver 来使用的，因此二者必须配合使用缺一不可。

内容将涵盖3个语言，ruby/python/java。

ruby 的 appium client 叫做 appium lib，为什么是这样就不解释了，总之是历史原因。

首先 update rubygem 和 bundler (说老实话，真的不需要，但官方文档上这么写)

然后使用gem安装

推荐使用 pip 安装

当然了也可以在 Pipy 上下载源码安装

最后，也可以通过 github 安装（要 git 客户端）

运行第一个 Appium 测试

第一步，启动 Android 模拟器。

第二步，启动 Appium Server。Appium 在启动时默认占用本机的 4723 端口，即：127.0.0.1:4723

第三步，编写 appnium 测试脚本。

运行上面的脚本，你将会看到 Android 模拟器如下运行界面：

java-client 安装与测试：http://www.testclass.net/appium/appium-base-java/

java 的话用 maven 安装就可以了

当然了，也可以自己下载jar包，请自行选择最新版本。

appium client 扩展了原生的 webdriver client 方法

下面以 java 代码为例，简单过一下 appium client 提供的适合移动端使用的新方法

新增的 locator

这些方法主要覆盖了3大类：

appium-desktop 和 appium 这两个只要有一个安装好就可以，区别是：

什么是 Appium-desktop？

项目地址：https://github.com/appium/appium-desktop

项目描述：

Appium Server and Inspector in Desktop GUIs for Mac, Windows, and Linux。

Appium 移动测试中有个很重新的组件 Appium-Server，它主要用来监听我们的移动设备（真机或模拟器），然将不同编程语言编写的 appium 测试脚本进行解析，然后，驱动移动设备来运行测试。

但Appium-Server有一两年没有更新了。Windows版在 2015 年底止步于的 AppiumForWindows_1_4_16_1.zip

于是，新的工具 Appium-desktop 来了！ 它来继续 Appium-Server的使命，当然， Appium-Server当前仍然是可用的。

下载与安装

appium-desktop 下载地址：这里

根据自己的平台选择相关的包进行下载。本文以 Windows 为例，所以选择 appium-desktop-Setup-1.2.4.exe 文件进行下载。

安装过程太简单了，双击 exe 文件，然后，等待安装完就好了，中间都不需要你设置任何选项。所以，这里就不贴图了。

启动运行

安装完成桌面会生成一个紫色的 appium 图标，双击打开。

默认显示监控的 host 和 port ，这和 Appium-Server中是一致的。点击 “Start Server V 1.7.1” 按钮启动服务。

现在启动 启动你的移动设备（真机或模拟器），编写 Appium 自动化测试脚本，可以通过 Appium-desktop 来运行测试了。

至于 Appium-Server , 你可以把它卸载了！

启动 appium 及 android 模拟器

一般情况下，我们都从命令行启动 appium。

windows下，dos 命令窗口输入

如果该命令报错，那么请重装 appium

如果安装出错，请使用淘宝源。

淘宝源地址：http://npm.taobao.org/

然后请打开 android 的模拟器，如果没有请新建一个虚拟设备。请自行解除设备锁定（手动把屏幕解锁了），以防万一。

下面的代码以启动android原生的计算器程序为例

讨论：可以看出ruby lib里面的Appium::Driver类实际上就是原生的webdriver类的子类，当然了，由于ruby语法灵活，也可以使用monkey patch来实现类似功能。

讨论：webdriver.Remote实际上就是原生webdriver的子类，另外Remote()构造函数的第一个参数中需要显示指定appium server监听的端口

新建 java 项目时候，请注意将 selenium-webdriver 以及 appium client 的 jar 包导入

讨论：AppiumDrvier 是原生 webdriver 的子类。

在这里我们可以看到，新建driver的时候必须要指定一个DesiredCapabilities 对象，该对象究竟是何方神圣，下面会仔细讲解。

Desired Capabilities 是在启动 session 的时候是必须提供的。

Desired Capabilities 本质上是以 key value 字典的方式存放，客户端将这些键值对发给服务端，告诉服务端我们想要怎么测试。它告诉 appium Server 这样一些事情：

Desired Capabilities 配置

Appium 的 Desired Capabilities 基本配置如下：

参数说明：

更多的参数配置 ，参考 这里：https://github.com/appium/appium/blob/master/docs/en/writing-running-appium/caps.md

定位控件首先需要使用一些辅助工具，对于appium实战android来说，下面的这些工具(以windows系统为例)是必须熟练使用的。

获取 appPackage 和 appActivity：https://blog.csdn.net/mtbaby/article/details/78676477

控件的特征就是控件的属性，可以通过 uiautomatorviewer 去获取。

在 appium 的定位世界里，下面这些方法是可以为我们使用的。也就是说，我们通过下面几个约定好的方式，按照webdriver和appium的DSL（自行搜索并理解）进行控件特征的描述和定位。

继承自webdriver的方法，也就是通过这3个特征可以定位控件

由Mobile JSON Wire Protocol 协议中定义的方法，更适合移动设备上的控件定位

在 appium 的 client 对 Mobile JSON Wire Protocol 中定义的方法进行了封装，使其调用起来更加方便

当然了，你也可以使用原生的webdriver方法

另外，ruby lib里提供了一些非常好用的简便方法来进行控件的定位，好写，好读。

更多请看 这里

总的来说就是在 driver 里增加了

等方法

前面也讲过了，新增了这些方法

讨论：从上面可以看出来，python 和 java client对移动端控件定位的封装是比较初级的。ruby lib中封装了很多方便和简洁的方法，因此可以看出，使用ruby lib是优于python和java的选择。当然，如果忽略性能的话。

appium 通过 uiautomatorviewer.bat 工具来查看控件的属性。该工具位于 Android SDK 的 /tools/bin/ 目录下。

通过 uiautomatorviewer.bat 工具可以查看对象的 id 属性。

如果目标设备的 API Level 低于18则 UIAutomatorViewer 不能获得对应的 Resource ID，只有等于大于18的时候才能使用。

打开 uiautomatorviewer.bat 工具：

resource-id 就是我们理解的 id 属性了。

使用方法：

打开 uiautomatorviewer.bat 工具：

text 就是我们要查找的 name 了，为什么在命名上毫无关联啊！

使用方法：

计算器界面上的的 class 属性是：android.widget.Button。 使用方法：

使用 Class Name 一般获得的 view 都不止一个，所以应该需要遍历一遍得到的 views，然后缩小搜索条件来获得目标控件。

在 WebDriver 上 XPath 定位是功能强大的一种定位方式。我个人惯用于此方法来定位Web页面上的元素。下面看看在 Android 上 XPath 定位的用法。

用 class 的属性来替代做标签的名字。

使用方法：

当果如果出现 class 相同的情况下可以用控件的属性值进行区分。 

XPath 在 Appium 上的用法依然很强大，有时需要写更臭更长的定位语法，因为APP上元素的class命令本来就长，再加上多层级，结果可想而知。

这个方法属于 Appium 扩展的定位方法。

其实，我们的核心是要找到元素的 contentDescription 属性。它就是元素的 content-desc 。

使用方法：

这个方法也属于 Appium（Android）扩展的定位方法。同样使用 UIAutomatorViewer.bat 工具直接查看。

也就是说一个元素的任意属性都可以通过 android uiautomator 方法来进行定位，但要保证这种定位方式的唯一性。

使用方法：

需要注意的是 description() 方法用的是 content-desc 属性。

罗列的方法主要针对应用的操作，如应用的安装、卸载、关闭、启动等。

方法：installApp()

安装应用到设备中去。需要 apk 包的路径。

方法：removeApp()

从设备中删除一个应用。 

方法：closeApp()

关闭打开的应用，默认关闭当前打开的应用，所以不需要入参。这个方法并非真正的关闭应用，相当于按 home 键将应用置于后台，可以通过 launchApp() 再次启动。

方法：launchApp()

启动应用。你一定很迷惑，不是在初始化的配置信息已经指定了应用，脚本运行的时候就需要启动应用，为什么还要有这个方法去启动应用呢？重新启动应用也是一个测试点，该方法需要配合closeApp()使用的。 

方法：isAppInstalled()

检查应用是否已经安装。需要传参应用包的名字。返回结果为Ture或False。 

方法：runAppInBackground()

将当前活跃的应用程序发送到后台。这个方法需要入参，需要指定应用置于后台的时长。

方法：resetApp()

重置当前被测程序到出始化状态。该方法不需要入参。 

其实上下文的操作主要针对于混合应用。

啥是混合应用，简单来说就是APP用里面嵌入网页。Android上的浏览器就属于混合应用。

方法：getContext()

获取当前所有的可用的上下文。该方法不需要入参。 ```java String ct = driver.getContext(); System.out.println(ct);

-----------计算器应用的打印结果----------------------- NATIVE_APP ```

方法：getContextHandles()

获取当前所有可用的上下文。该方法不需要入参。

方法：context()

切换到特定的上下文中。需要指定上下文的名称。 java driver.context('NATIVE_APP') driver.context('WEBVIEW_1')

模拟键盘输入也是非常重要的操作。这一小节来介绍那些关于键盘的操作。

方法：sendKeys()

用法：

除此之外，appium扩展提供了pressKeyCode()方法。该方法 Android 特有。

方法：pressKeyCode()

发送一个键码的操作。需要一个入参。

如果想点击 Android 的 HOME 键应该怎么实现的呢？如下 java driver.pressKeyCode(AndroidKeyCode.HOME);

下面提供Android keycode参考表：

Appium 的辅助类，主要针对手势操作，比如滑动、长按、拖动等。

方法：press()

开始按压一个元素或坐标点（x,y）。通过手指按压手机屏幕的某个位置。

press(WebElement el, int x, int y)

press 也可以接收屏幕的坐标（x,y）。

例：

除了press()方法之外，本例中还用到了别外两个新方法。

release() 结束的行动取消屏幕上的指针。

Perform() 执行的操作发送到服务器的命令操作。

方法：longPress()

开始按压一个元素或坐标点（x,y）。 相比press()方法，longPress()多了一个入参，既然长按，得有按的时间吧。duration以毫秒为单位。1000表示按一秒钟。其用法与press()方法相同。

longPress(WebElement el, int x, int y, Duration duration)

例： java TouchAction action = new TouchAction(driver); action.longPress(names.get(1),1000).perform().release(); action.longPress(1 ,302,1000).perform().release();

方法：tap()

对一个元素或控件执行点击操作。用法参考press()。

tap(WebElement el, int x, int y)

例： java TouchAction action = new TouchAction(driver); action.tap(names.get(1)).perform().release(); action.tap(1 ,302).perform().release();

方法：moveTo()

将指针（光标）从过去指向指定的元素或点。

movTo(WebElement el, int x, int y)

其用法参考press()方法。

例： Java TouchAction action = new TouchAction(driver); action.moveTo(names.get(1)).perform().release(); action.moveTo(1 ,302).perform().release();

方法：wait()

暂停脚本的执行，单位为毫秒。 Java action.wait(1000);

其它操作针对移动设备上特有的一些操作。

方法： * lockDevice()

点击电源键熄灭屏幕。

在iOS设备可以设置熄屏一段时间。Android上面不带参数，所以熄屏之后就不会再点亮屏幕了。 java driver.lockDevice(1000); // iOS driver.lockDriice(); //Android

方法：currentActivity()

得到当前应用的activity。只适用于Android。 例（通讯录）： Java String ca = driver.currentActivity(); System.out.print(ca); -------------输出结果为------------- .activities.PeopleActivity

方法：hideKeyboard()

收起键盘，这个方法很有用，当我们对一个输入框输入完成后，需要将键盘收起，再切换到一下输入框进行输入。 Java driver.hideKeyboard(); //收起键盘

方法：swipe()

模拟用户滑动。将控件或元素从一个位置（x,y）拖动到另一个位置（x,y）。

swipe(int startx, int starty, int endx, int endy, int duration) * start_x：开始滑动的x坐标。 * start_y：开始滑动的y坐标。 * end_x：结束滑动的x坐标。 * end_y：结束滑动的y坐标。 * duration：持续时间。

例： Java driver.swipe(75, 500, 75, 0, 800);

方法：pullFile()

从设备中拉出文件。

例： Java driver.pullFile('Library/AddressBook/AddressBook.sqlitedb')

方法：pushFile()

推送文件到设备中去。

pushFile(String remotePath, byte[] base64Data)

例： Java String content = "some data for the file"; byte[] data = Base64.encodeBase64(content.getBytes()); driver.pushFile("sdcard/test.txt", data);