Appium简明教程 on 重定向学院

appium新手入门（1）—— appium介绍

Fri, 08 Sep 2017 12:24:12 +0800

appium介绍

官方网站

1、特点

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

“移动原生应用”是指那些用iOS或者 Android SDK 写的应用（Application简称app）。
“移动web应用”是指使用移动浏览器访问的应用（appium支持iOS上的Safari和Android上的 Chrome）。
“混合应用”是指原生代码封装网页视图——原生代码和 web 内容交互。比如，像 Phonegap，可以帮助开发者使用网页技术开发应用，然后用原生代码封装，这些就是混合应用。

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

2、appium与Selenium

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

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

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

3、支持多平台、多语言

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

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

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

语言/框架	Github地址
Ruby	https://github.com/appium/ruby_lib
Python	https://github.com/appium/python-client
Java	https://github.com/appium/java-client
JavaScript (Node.js)	https://github.com/admc/wd
Objective C	https://github.com/appium/selenium-objective-c
PHP	https://github.com/appium/php-client
C# (.NET)	https://github.com/appium/appium-dotnet-driver
RobotFramework	https://github.com/jollychang/robotframework-appiumlibrary

4、appium工作原理

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

appium简明教程（1）——appium和它的哲学世界

Sun, 20 Aug 2017 06:05:07 +0800

什么是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.

appium新手入门（2）—— 安装 Android SDK

Thu, 07 Sep 2017 12:24:12 +0800

注明： 理论上这一章不是必须的，如果你不想使用 Android 模拟器运行测试的话可以跳过，不过，建议安装；原生 Android 好折腾！关键是它自带的一些工具是你做 appium 测试必须要用的！

安装Android SDK

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

1、下载Android SDK

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

Android Studio & Android SDK 下载地址：https://developer.android.com/studio/index.html?hl=zh-cn

拖到页面底部，你将找到下载链接，根据自己的平台选择对应的链接下载。

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

所以，Android SDK 下载地址（才是我们想要的）：

http://tools.android-studio.org/index.php/sdk

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

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

appium简明教程（2）——appium的基本概念

Sat, 19 Aug 2017 06:14:09 +0800

Client/Server Architecture

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

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

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

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

1，可以带来多语言的支持；
2，可以把server放在任意机器上，哪怕是云服务器都可以；（是的，appium和webdriver天生适合云测试）

Session

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

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新手入门（3）—— 安装 appium Server

Thu, 07 Sep 2017 11:24:12 +0800

我们可以在Appium官方网站上下载操作系统相应的Appium版本。

https://bitbucket.org/appium/appium.app/downloads/

当前最新版本为 AppiumForWindows_1_4_16_1.zip ，注意这是一个 Windows 版本，如果你的电脑为MAC请下载 appium-1.5.3.dmg 。虽然你已经看到了这些下载包，但我不保证你能下载的下来。

所以，再来提供一个百度网盘的下载链接：https://pan.baidu.com/s/1pKMwdfX

我们以 Windows 为例，将下载的 AppiumForWindows.zip 进行解压，点击 appium-installer.exe 进行安装。

根据提示，一步一步进行安装，这里不再啰嗦。最终在会桌面上生成 Appium图标 , 双击启动，appium server 界面如下。

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

最后，打开Windows命令提示符，输入“appium-doctor”命令，如果出现以下提示，说明你Appium所需要的各项环境都已准备完成。

注：如果提示：“appium-doctor”不是内部或外部命令，找到Appium的安装目录，例如：

C:\Program Files\Appium\node_modules\.bin

添加到环境变量path下面（参考Java环境的设置）。

原始封面

appium简明教程（3）——appium的安装windows版

Fri, 18 Aug 2017 07:14:54 +0800

appium的哲学里有一条就是不重新发明轮子。同样，官方已经有明确的安装步骤了，因此在这里纯属搬砖。

原文地址

感谢testerhome的辛勤翻译。

本文版权归乙醇所有，欢迎转载，但请注明作者与出处，严禁用于任何商业用途

限制

如果你在windows上安装appium，你没法使用预编译专用于OS X的.app文件，你也将不能测试IOS apps，因为appium依赖OS X专用的库来支持IOS测试。这意味着你只能通过在mac上来运行IOS的app测试。这点限制挺大。

开始安装

安装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目录。
安装Apache Ant 或者直接使用Android Windows SDK自带的ant，地址在eclipse\plugins目录，你需要把这个目录加到你的系统PATH变量中
安装Apache Maven. 并且设置M2HOME和M2环境变量，把M2环境变量添加到你的系统PATH变量中。
安装Git. 确保你安装了windows下的Git，以便可以运行常用的command命令

现在，你已经下载安装了所有的依赖，开始运行 reset.bat

运行Appium

要在windows上运行测试用例，你需要先启动Android模拟器或者连接上一个API Level17以上的android真机。然后在命令行运行appium node .

备注

你必须带上–no-reset和–full-reset标记，以用于windows上的android
有一个硬件加速模拟器用于android，但是它有自己的一些限制，如果你想了解更多，请参考页面
确保在你的AVD的config.ini中有一个配置项为hw.battery=yes

最简略的安装方式

出于对官方文档的尊重，我按照原文翻译，如下介绍我的安装心得。官方提到的一些工具，其实并不需要安装。下面介绍我已经测试过的安装和使用过程

安装appium

安装nodejs
使用npm安装appium: npm install -g appium

注意：在某些情况下，appium安装的时候并不会把appium的路径放进系统的PATH里，这时候需要手工去加一下。

运行appium

启动appium，直接运行appium 即可。

更新appium

通过npm install -g appium 来更新appium即可

下一节，appium client的安装

本文版权归乙醇所有，欢迎转载，但请注明作者与出处，严禁用于任何商业用途

appium新手入门（4）—— java-client安装与测试

Thu, 07 Sep 2017 10:24:12 +0800

关联阅读：

appium新手入门（1）—— appium介绍

appium新手入门（2）—— 安装 Android SDK

appium新手入门（3）—— 安装 appium Server

#### 前提条件 ----

当你点击这一章时，说明你是打算使用 Java 语言编写 appium 自动化测试脚本的。

1、安装 Java 环境 ,我想这一步你已经搞定了

2、安装 IntelliJ IDEA , 当然，你喜欢用 Eclipse 也可以，不过，我仍然推荐 IDEA。

3、安装 Maven, Java开发必备啊！

Maven 安装 Java-client

首先，启动IntelliJ IDEA，创建Maven项目（参考selenium java教程），然后在maven配置文件中添加Java-client配置。

<dependency>
 <groupId>io.appium</groupId>
 <artifactId>java-client</artifactId>
 <version>5.0.0-BETA9</version>
 <scope>test</scope>
</dependency>

最新版本号可以到 github Java-client开源项目上查看。

#### 运行第一个Appium测试 ---- * __第一步__，启动Android模拟器。

appium简明教程（4）——appium client的安装

Thu, 17 Aug 2017 07:24:12 +0800

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

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

从本节开始，教程的内容将涵盖3个语言，ruby/python/java。

本文版权归乙醇所有，欢迎转载，但请注明作者与出处，严禁用于任何商业用途

安装appium client

ruby篇（一定要在线安装）

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

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

gem update --system ;\
gem update bundler

然后使用gem安装

gem uninstall -aIx appium_lib ;\(这个也不是必须的)
gem install --no-rdoc --no-ri appium_lib

python篇（尽量在线安装）

推荐使用pip安装

pip install Appium-Python-Client

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

tar -xvf Appium-Python-Client-X.X.tar.gz（windows上用7zip可以解压）
cd Appium-Python-Client-X.X
python setup.py install

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

git clone git@github.com:appium/python-client.git
cd python-client
python setup.py install

java篇（在线安装）

java的话用maven安装就可以了

<dependency>
 <groupId>io.appium</groupId>
 <artifactId>java-client</artifactId>
 <version>1.3.0</version>
</dependency>

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

本文版权归乙醇所有，欢迎转载，但请注明作者与出处，严禁用于任何商业用途

原始封面

appium新手入门（5）—— python-client安装与测试

Thu, 07 Sep 2017 10:24:12 +0800

关联阅读：

appium新手入门（1）—— appium介绍

appium新手入门（2）—— 安装 Android SDK

appium新手入门（3）—— 安装 appium Server

#### 前提条件 ----

当你点击这一章时，说明你是打算使用 Python 语言编写 appium 自动化测试脚本的。

1、安装 Python 语言 , Python的安装相对相简单得多。

2、Python 编辑器很多，推荐：PyCharm、Atom、Sublime text3等。这几款都是我常用的。

安装 python-client

其实，python-client 的项目名称叫：Appium-Python-Client。

推荐pip安装：

(venv) λ pip install Appium-Python-Client
Collecting Appium-Python-Client
 Using cached Appium-Python-Client-0.24.tar.gz
Requirement already satisfied: selenium>=2.47.0 in d:\pyflask\venv\lib\site-packages (from Appium-Python-Client)
Building wheels for collected packages: Appium-Python-Client
 Running setup.py bdist_wheel for Appium-Python-Client ... done
 Stored in directory: C:\Users\fnngj\AppData\Local\pip\Cache\wheels\2e\cf\10\0e3f177c9869147b16584d402f79d9007df1139105ea3ecc2c

Successfully built Appium-Python-Client
Installing collected packages: Appium-Python-Client
Successfully installed Appium-Python-Client-0.24

#### 运行第一个Appium测试 ---- * __第一步__，启动Android模拟器。

appium简明教程（5）——appium client方法一览

Wed, 16 Aug 2017 07:30:01 +0800

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

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

resetApp()
getAppString()
sendKeyEvent()
currentActivity()
pullFile()
pushFile()
pullFolder()
hideKeyboard()
runAppInBackground()
performTouchAction()
performMultiTouchAction()
tap()
swipe()
pinch()
zoom()
getNamedTextField()
isAppInstalled()
installApp()
removeApp()
launchApp()
closeApp()
endTestCoverage()
lockScreen()
shake()
complexFind()
scrollTo()
scrollToExact()
openNotifications()
Context Switching: .context(), .getContextHandles(), getContext())

新增的locator

findElementByAccessibilityId()
findElementsByAccessibilityId()
findElementByIosUIAutomation()
findElementsByIosUIAutomation()
findElementByAndroidUIAutomator()
findElementsByAndroidUIAutomator()

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

driver扩展：比如增加了resetApp等操作app的方法
action扩展：增加一些移动端的特有的action（怎么描述呢，相当于是移动端特有的操作），比如swipe，shake(嗯，有了这个方法就可以让代码帮你摇一摇了)等；
locator扩展：增加了一些移动端专属的定位策略

本文版权归乙醇所有，欢迎转载，但请注明作者与出处，严禁用于任何商业用途

原始封面

appium新手入门（6）—— appium-desktop

Thu, 07 Sep 2017 10:24:12 +0800

什么是 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简明教程（6）——启动appium及android模拟器

Tue, 15 Aug 2017 07:33:41 +0800

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

windows下，dos命令窗口输入

appium

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

npm install -g appium

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

淘宝源地址

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

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

ruby篇

require 'appium_lib'

caps = { caps: { platformName: 'Android', appActivity: '.Calculator', appPackage: 'com.android.calculator2' },
 appium_lib: { sauce_username: nil, sauce_access_key: nil } }
driver = Appium::Driver.new(caps).start_driver

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

python篇

from appium import webdriver
desired_caps = {}
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '4.2'
desired_caps['deviceName'] = 'Android Emulator'
desired_caps['appPackage'] = 'com.android.calculator2'
desired_caps['appActivity'] = '.Calculator'

driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)

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

java篇

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

import io.appium.java_client.AppiumDriver;
import org.openqa.selenium.By;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.remote.CapabilityType;
import org.openqa.selenium.remote.DesiredCapabilities;

DesiredCapabilities capabilities = new DesiredCapabilities();
capabilities.setCapability(CapabilityType.BROWSER_NAME, "");//这句不是必须的
capabilities.setCapability("deviceName","Android Emulator");
capabilities.setCapability("platformVersion", "4.4");
capabilities.setCapability("platformName","Android");
capabilities.setCapability("appPackage", "com.android.calculator2");
capabilities.setCapability("appActivity", ".Calculator");
AppiumDriver driver = new AppiumDriver(new URL("http://127.0.0.1:4723/wd/hub"), capabilities);

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

appium新手入门（7）—— Desired Capabilities

Thu, 07 Sep 2017 10:24:12 +0800

从后台统计来看，appium 系列的教程很受欢迎！于是，我继续更新，也希望你把这个教程推荐给更多学习 appium 的小伙伴！

Desired Capabilities

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

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

本次测试是启动浏览器还是启动移动设备。
是启动Andorid还是启动iOS。
启动Android时，app的package是什么。
启动Android时，app的activity是什么。
…

Desired Capabilities 配置

Appium 的 Desired Capabilities 基本配置如下：


DesiredCapabilities capabilities = new DesiredCapabilities();
capabilities.setCapability("deviceName", "Android Emulator");
capabilities.setCapability("automationName", "Appium");
capabilities.setCapability("platformName", "Android");
capabilities.setCapability("platformVersion", "5.1");
capabilities.setCapability("appPackage", "com.android.calculator2");
capabilities.setCapability("appActivity", ".Calculator");

WebDriver driver = new AndroidDriver(new URL("http://127.0.0.1:4723/wd/hub"), capabilities);

deviceName：启动哪种设备，是真机还是模拟器？iPhone Simulator，iPad Simulator，iPhone Retina 4-inch，Android Emulator，Galaxy S4…
automationName：使用哪种自动化引擎。appium（默认）还是Selendroid。
platformName：使用哪种移动平台。iOS, Android, orFirefoxOS。

appium简明教程（7）——Desired Capabilities详解

Mon, 14 Aug 2017 08:01:35 +0800

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

Desired Capabilities本质上是key value的对象，它告诉appium server这样一些事情：

本次测试是启动浏览器还是启动移动设备？
是启动andorid还是启动ios？
启动android时，app的package是什么？
启动android时，app的activity是什么？

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

automationName：使用哪种自动化引擎。appium（默认）还是Selendroid？
platformName：使用哪种移动平台。iOS, Android, orFirefoxOS？
deviceName：启动哪种设备，是真机还是模拟器？iPhone Simulator, iPad Simulator, iPhone Retina 4-inch, Android Emulator, Galaxy S4, etc…
app：应用的绝对路径，注意一定是绝对路径。如果指定了appPackage和appActivity的话，这个属性是可以不设置的。另外这个属性和browserName属性是冲突的。
browserName：移动浏览器的名称。比如Safari’ for iOS and ‘Chrome’, ‘Chromium’, or ‘Browser’ for Android；与app属性互斥。
udid：物理机的id。比如1ae203187fc012g。

下面这些属性是android平台特定的：

appActivity：待测试的app的Activity名字。比如MainActivity, .Settings。注意，原生app的话要在activity前加个"."。
appPackage：待测试的app的java package。比如com.example.android.myApp, com.android.settings。

本文主要讨论android平台的appium测试方法和技巧，因此在这里就不列出ios设备特定的属性了。

更多信息请参考官方文档

在这里我们发现，我们经常要获取app的package和activity名字，那么有什么工具可以让我们方便的获取到这些信息呢？下一节讲回答这个问题。

本文版权归乙醇所有，欢迎转载，但请注明作者与出处，严禁用于任何商业用途

原始封面

appium新手入门（8）—— 定位控件

Thu, 07 Sep 2017 10:24:12 +0800

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

id 定位

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

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

打开uiautomatorviewer.bat工具：

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

使用方法：

driver.findElement(By.id("com.android.calculator2:id/formula"))

name 定位

打开uiautomatorviewer.bat工具：

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

使用方法：

driver.findElement(By.name("9"))

class name 定位

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

WebElement button = driver.findElement(By.className("android.widget.Button"));

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

XPath定位

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

appium简明教程（8）——那些工具

Sun, 13 Aug 2017 08:07:13 +0800

正所谓工欲善其事必先利其器，对于appium实战android来说，下面的这些工具(以windows系统为例)是必须熟练使用的。

monitor.bat（hierarchyviewer.bat已经不赞成继续使用了）

该文件位于your_andriod_sdk_path\tools下面。以乙醇的机器为例，其位于E:\adt-bundle-windows-x86-20131030\sdk\tools下。

该工具可以帮我们找到android控件的content-description，为以后的find_element_by_accessibility_id 定位方法做参数使用。

关于什么是content-description，可以参考官方文档。

好，露个脸。

uiautomatorviewer.bat

该文件位于your_andriod_sdk_path\tools下面。以乙醇的机器为例，其位于E:\adt-bundle-windows-x86-20131030\sdk\tools下。

该工具主要用来查看控件的属性，比如resource id，class name等。

该工具也可查看被测app的appPackage（Desired Capabilities中使用）。

爆照。

好了，是不是感觉还缺了点什么呢？

确实如此，被测app的appActivity怎么获取呢？

下一讲我们详细讲解如何获取被测app的appActivity。

本文版权归乙醇所有，欢迎转载，但请注明作者与出处，严禁用于任何商业用途

原始封面

appium新手入门（9）—— appium API 之应用操作

Thu, 07 Sep 2017 10:24:12 +0800

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

1、安装应用

方法：

installApp()

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

driver.installApp("path/to/my.apk");
driver.installApp("D:\\android\\apk\\ContactManager.apk");

2、卸载应用

方法：

removeApp()

从设备中删除一个应用。

driver.removeApp("com.example.android.apis");

3、关闭应用

方法：

closeApp()

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

4、启动应用

方法：

launchApp()

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

driver.closeApp();
driver.launchApp();

5、检查应用是否安装

方法：

isAppInstalled()

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

driver.isAppInstalled('com.example.android.apis');

6、将应用置于后台

方法：

runAppInBackground()

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

driver.runAppInBackground(2);

7、应用重置

方法：

resetApp()

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

driver.resetApp();

原始封面

appium简明教程（9）——如何获取android app的Activity

Sat, 12 Aug 2017 08:11:31 +0800

有时候在appium的Desired Capabilities中需要指定被测app的appActivity，下面的方法可能会对你有所帮助。

方法一

如有你有待测项目的源码，那么直接查看源码就好。如果没有，那么请联系有源码的同学，这是推荐方法。

方法二

如果你没有代码，那么可以反编译该app。

这里将用到2个工具，分别是dex2jar和jd-gui。你可以在这里下载目前为止的最新版本以及示例apk。

我们以工具包里的ContactManager.apk为例，简单介绍一下反编译的流程。

1，重命名ContactManager.apk为ContactManager.zip并解压得到文件classes.dex；
2，解压dex2jar-0.0.9.15.zip，并从命令行进入该文件夹；
3，运行命令

d2j-dex2jar.bat path_to\classes.dex
在当前文件夹下得到classes-dex2jar.jar；

4，解压jd-gui-0.3.6.windows.zip得到文件jd-gui.exe；
5，使用jd-gui.exe打开classes-dex2jar.jar；

嗯，好了，可以尽情欣赏了。上图。

上图所示的ContactManager就是待测app的main activity。

方法三

参考testerhome的这个帖子

使用log查看大法(嗯，windows上没grep不幸福，好在有powershell的Select-String，可以拿来勉强一用)，直接搬砖。

a、启动待测apk
b、开启日志输出：adb logcat>D:/log.txt
c、关闭日志输出：ctrl+c
d、查看日志

找寻：

Displayed com.mm.android.hsy/.ui.LoginActivity: +3s859ms
appPackage = com.mm.android.hsy
appActivity = .ui.LoginActivity

好了，准备活动做的差不多了。下一节乙醇带大家进行控件定位之旅。

原始封面

appium新手入门（10）—— appium API 之上下文操作

Thu, 07 Sep 2017 10:22:12 +0800

其实上下文的操作主要针对于混合应用。啥是混合应用，简单来说就是APP用里面嵌入网页。Android上的浏览器就属于混合应用。

1、获取当前上下文

方法：

getContext()

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

String ct = driver.getContext();
System.out.println(ct);

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

2、当前所有上下文句柄

方法：

getContextHandles()

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

3、切换上下文

context()

切换到特定的上下文中。需要指定上下文的名称。

driver.context('NATIVE_APP')
driver.context('WEBVIEW_1')

原始封面

appium简明教程（10）——控件定位基础

Fri, 11 Aug 2017 08:40:32 +0800

狭义上讲，UI级的自动化测试就是让机器代替人去点来点去的过程。

但机器去点什么（点上面还是点左边），怎么点（是长按还是轻触），这些东西是必须由代码的编写者所指示清楚的。

控件定位就是解决机器点什么的问题的。

一般说来，我们可以这样告诉机器：去点登陆按钮。

机器很笨，它并不知道什么是登陆按钮。因为登陆按钮是自然语言的描述。

如果你让一个人去点登陆按钮，那么他其实也是要经过一系列的脑补以后才可以做这件事的。

这个脑补的过程还原如下：

这个一定是个按钮

这个按钮一定在被测的应用上

这个按钮大概上面有登陆这个文字信息

嗯，还真有一个，那么点吧。

这就是人探索性测试的一个简单过程。一般来说，如果你给出的信息不太充分，人类还是可以通过一系列的探索性思维去理解你的描述的。这个属于心理学的问题，不展开解释。

但是机器并不是人，如果你给出的描述不精确的话，机器是不会自发性的进行探索和脑补的。

因此控件定位就是精确的描述控件特征并告诉机器的过程。

本文版权归乙醇所有，欢迎转载，但请注明作者与出处，严禁用于任何商业用途

控件的特征就是控件的属性，我们可以通过上一讲中的uiautomatorviewer去获取。

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

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

find by “class” (i.e., ui component type，andorid上可以是android.widget.TextView)
find by “xpath” (i.e., an abstract representation of a path to an element, with certain constraints，由于appium的xpath库不完备的原因，这个不太推荐)
find by “id”(android上是控件的resource id)

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

-ios uiautomation: a string corresponding to a recursive element search using the UIAutomation library (iOS-only)
-android uiautomator: a string corresponding to a recursive element search using the UiAutomator Api (Android-only)
accessibility id: a string corresponding to a recursive element search using the Id/Name that the native Accessibility options utilize.

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

appium新手入门（11）—— appium API 之键盘操作

Thu, 07 Sep 2017 10:20:12 +0800

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

1、sendKeys()方法

方法：

sendKeys()

用法：

driver.findElements(By.name("Name")).sendKeys("jack");

2、pressKeyCode()方法

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

方法：

pressKeyCode()

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

driver.pressKeyCode(29); // 字母“a”

如果想点击Android的HOME键应该怎么实现的呢？如下

driver.pressKeyCode(AndroidKeyCode.HOME);

下面提供Android keycode参考表：

电话键

KEYCODE_CALL 拨号键 5

KEYCODE_ENDCALL 挂机键 6

KEYCODE_HOME 按键Home 3

KEYCODE_MENU 菜单键 82

KEYCODE_BACK 返回键 4

KEYCODE_SEARCH 搜索键 84

KEYCODE_CAMERA 拍照键 27

KEYCODE_FOCUS 拍照对焦键 80

KEYCODE_POWER 电源键 26

KEYCODE_NOTIFICATION 通知键 83

KEYCODE_MUTE 话筒静音键 91

KEYCODE_VOLUME_MUTE 扬声器静音键 164

KEYCODE_VOLUME_UP 音量增加键 24

KEYCODE_VOLUME_DOWN 音量减小键 25

控制键

KEYCODE_ENTER 回车键 66

KEYCODE_ESCAPE ESC键 111

KEYCODE_DPAD_CENTER 导航键确定键 23

KEYCODE_DPAD_UP 导航键向上 19

appium新手入门（12）—— appium API 之 TouchAction 操作

Thu, 07 Sep 2017 10:10:12 +0800

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

1、按压控件

方法：

press()

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

press(WebElement el, int x, int y)

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

例：

TouchAction(driver).press(x=0,y=308).release().perform()

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

release() 结束的行动取消屏幕上的指针。
Perform() 执行的操作发送到服务器的命令操作。

2、长按控件

方法：

longPress()

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

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

例：

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

3、点击控件

方法：

tap()

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

tap(WebElement el, int x, int y)

例：

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

4、移动

方法：

moveTo()

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

movTo(WebElement el, int x, int y)

appium新手入门（13）—— appium API 之其他操作

Thu, 07 Sep 2017 10:01:12 +0800

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

1、熄屏

方法：

lockDevice()

点击电源键熄灭屏幕。

在iOS设备可以设置熄屏一段时间。Android上面不带参数，所以熄屏之后就不会再点亮屏幕了。

driver.lockDevice(1000); // iOS
driver.lockDriice(); //Android

2、当前Activity（Android only）

方法：

currentActivity()

得到当前应用的activity。只适用于Android。例（通讯录）：

String ca = driver.currentActivity();
System.out.print(ca);
-------------输出结果为-------------
.activities.PeopleActivity

3、收起键盘

方法：

hideKeyboard()

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

driver.hideKeyboard(); //收起键盘

4、滑动

方法：

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：持续时间。

例：

driver.swipe(75, 500, 75, 0, 800);

5、拉出文件

方法：

pullFile()

从设备中拉出文件。

例：

driver.pullFile('Library/AddressBook/AddressBook.sqlitedb')

6、推送文件

方法：

pushFile()

推送文件到设备中去。

pushFile(String remotePath, byte[] base64Data)