软件测试教程 自动化测试appium篇
本课程主要讲解自动化测试工具appium。
下面以android app测试为例,讲解appium的基本使用方法
appium概念
appium安装配置
一个测试样例
Appium 概念
Appium是一个移动端的自动化框架,可用于测试原生应用,移动网页应用和混合型应用,且是跨平台的。可用于IOS和Android以及firefox的操作系统。
Appium使用WebDriver的json wire协议,来驱动Apple系统的UIAutomation库、Android系统的UIAutomator框架。
原生的应用是指用android或ios的sdk编写的应用。原生应用程序看起来(外观)和运行起来(性能)是最佳的。
移动网页应用是指网页应用,HTML5应用程序使用标准的Web技术,通常是HTML5、JavaScript和CSS。
混合应用程序让开发人员可以把HTML5应用程序嵌入到一个细薄的原生容器里面,集原生应用程序和HTML5应用程序的优点(及缺点)于一体。
appium选择了client-server的设计模式。
通过上面一张图简单展示了appium的工具原理。
客户端/服务器架构
Appium 的核心是暴露 REST API 的网络服务器。它接受来自客户端的连接,监听命令并在移动设备上执行,答复表示执行结果的 HTTP 响应。客户端/服务器架构实际给予了许多可能性:我们可以使用任何有 http 客户端 API 的语言编写我们的测试代码,不过选一个Appium 客户端程序库 使用更容易。我们可以把服务器放在另一台机器上,而不是执行测试的机器。
会话(session)
自动化始终在一个会话的上下文中执行,这些客户端程序库以各自的方式发起与服务器的会话,但都以发给服务器一个 POST /session
请求结束,请求中包含一个被称作 'desired capabilities' 的 JSON 对象。这时服务器就会开启这个自动化会话,并返回一个用于发送后续命令的会话 ID。
Desired Capabilities
Desired capabilities 是一些发送给 Appium 服务器的键值对集合 (比如 map 或 hash),告诉服务器我们想要启动什么类型的自动化会话。也有各种可以在自动化运行时修改服务器行为的 capabilities。例如,我们可以把 platformName
capability 设置为 iOS
,告诉 Appium 我们想要 iOS 会话,而不是 Android 或者 Windows 会话。我们也可以设置 safariAllowPopups
capability 为 true
,确保我们在 Safari 自动化会话中可以使用 javascript 打开新窗口。有关 Appium capabilities 的完整列表,请参阅 capabilities doc 。
Appium 服务器
Appium 是用 Node.js 写的服务器。它可以从源码构建安装或者从 NPM 直接安装:
$ npm install -g appium
$ appium
Appium 客户端
有多个客户端程序库(Java、Ruby、Python、PHP,、JavaScript 和 C# 的)支持 Appium 对 WebDriver 协议的扩展,你需要用这些客户端程序库代替通常的 WebDriver 客户端。在这里浏览所有程序库的列表。
Appium.app, Appium.exe
有 Appium 服务器的图形界面包装器可以下载。它们打包了 Appium 服务器运行需要的所有东西,所以你不需要为 Node 而烦恼。它们还提供一个 Inspector 使你可以查看你应用的层级结构,这在写测试时很方便。
appium安装配置
Appium-desktop安装
原来版本的appium-server不再维护,新的工具 是Appium-desktop。
官网地址:http://appium.io/,下载合适的版本
windows平台下载:appium-desktop-setup-1.4.0.exe
双击进行安装,安装过程不需要任何设置
安装完成桌面会生成一个紫色的appium 图标,双击打开。
默认显示监控的 host 和 port ,这和 Appium-Server中是一致的。点击 “Start Server V 1.7.2” 按钮启动服务。
注意:不能在浏览器中设置代理
Traceback (most recent call last):
File "C:\Users\liujiey\Desktop\test.py", line 20, in setUp
self.driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)
File "build\bdist.win32\egg\appium\webdriver\webdriver.py", line 36, in __init__
super(WebDriver, self).__init__(command_executor, desired_capabilities, browser_profile, proxy, keep_alive)
File "C:\Python27\lib\site-packages\selenium-2.48.0-py2.7.egg\selenium\webdriver\remote\webdriver.py", line 87, in __init__
self.start_session(desired_capabilities, browser_profile)
File "C:\Python27\lib\site-packages\selenium-2.48.0-py2.7.egg\selenium\webdriver\remote\webdriver.py", line 141, in start_session
'desiredCapabilities': desired_capabilities,
File "C:\Python27\lib\site-packages\selenium-2.48.0-py2.7.egg\selenium\webdriver\remote\webdriver.py", line 199, in execute
response = self.command_executor.execute(driver_command, params)
File "C:\Python27\lib\site-packages\selenium-2.48.0-py2.7.egg\selenium\webdriver\remote\remote_connection.py", line 395, in execute
return self._request(command_info[0], url, body=data)
File "C:\Python27\lib\site-packages\selenium-2.48.0-py2.7.egg\selenium\webdriver\remote\remote_connection.py", line 463, in _request
resp = opener.open(request, timeout=self._timeout)
File "C:\Python27\lib\urllib2.py", line 394, in open
response = self._open(req, data)
File "C:\Python27\lib\urllib2.py", line 412, in _open
'_open', req)
File "C:\Python27\lib\urllib2.py", line 372, in _call_chain
result = func(*args)
File "C:\Python27\lib\urllib2.py", line 1199, in http_open
return self.do_open(httplib.HTTPConnection, req)
File "C:\Python27\lib\urllib2.py", line 1170, in do_open
r = h.getresponse(buffering=True)
File "C:\Python27\lib\httplib.py", line 1027, in getresponse
response.begin()
File "C:\Python27\lib\httplib.py", line 407, in begin
version, status, reason = self._read_status()
File "C:\Python27\lib\httplib.py", line 371, in _read_status
raise BadStatusLine(line)
BadStatusLine: ''
安装 python-client
python-client 的项目名称叫:Appium-Python-Client。
安装方式:pip install Appium-Python-Client
该项目依赖selenium
在python中测试: from appium import webdriver,导入成功说明安装完成
如果使用其他语言,则安装其他语言的client
安装 JDK
app sdk的运行需要JDK的支持,因此需要先安装JDK
需要配置JAVA_HOME,并设置path路径
安装 Android SDK
进行模拟器测试时,需要SDK的支持。如果真机测试的话,会用到platform-tool,例如adb等工具。因此建议安装SDK。
Android SDK 下载地址:
http://tools.android-studio.org/index.php/sdk
选择对应平台版本下载,这里选择:
installer_r24.4.1-windows.exe
安装SDK:
1、双击进行安装
2、安装过程中会检查JDK
3、安装完毕后会提示运行SDK manager
4、除默认勾选的之外,选择需要下载支持的版本,例如Android 7.0,Android 6.0等,这里选择Android 4.2.2进行下载
设置环境变量:
下面设置环境变量:
“我的电脑” 右键菜单 —> 属性 —> 高级 —> 环境变量 —> 系统变量 —> 新建…
变量名 | 变量值 |
---|---|
ANDROID_HOME | D:\android\Android\sdk |
找到 path 变量名—> “编辑” 添加:
变量名 | 变量值 |
---|---|
PATH | ;%ANDROID_HOME%\platform-tools;%ANDROID_HOME%\tools; |
创建模拟器:
1、双击 AVD Manage.exe 启动AVD管理器。
2、点击 “Create…” 按钮,创建Android虚拟机。
3、不要选择超过电脑屏幕分辨率的Device。Target选择SDK下载的版本,Skin选择no skin即可,点击 “OK” 创建完成。
4、在 AVD Manage 工具中选中创建的Android虚拟机,点击 “Start…” 按钮启动。
使用Intel atom模拟时,可能会出现
Starting emulator for AVD 'EMU'
emulator: ERROR: x86 emulation currently requires hardware acceleration!
Please ensure Intel HAXM is properly installed and usable.
CPU acceleration status: HAXM is not installed on this machine
此时可以在sdk manager下载extra中的HAXM或者https://software.intel.com/en-us/articles/intel-hardware-accelerated-execution-manager-intel-haxm下载并安装
异常:未安装sdk
Traceback (most recent call last):
File "C:\Users\liujiey\Desktop\test.py", line 20, in setUp
self.driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)
File "build\bdist.win32\egg\appium\webdriver\webdriver.py", line 36, in __init__
super(WebDriver, self).__init__(command_executor, desired_capabilities, browser_profile, proxy, keep_alive)
File "C:\Python27\lib\site-packages\selenium-2.48.0-py2.7.egg\selenium\webdriver\remote\webdriver.py", line 87, in __init__
self.start_session(desired_capabilities, browser_profile)
File "C:\Python27\lib\site-packages\selenium-2.48.0-py2.7.egg\selenium\webdriver\remote\webdriver.py", line 141, in start_session
'desiredCapabilities': desired_capabilities,
File "C:\Python27\lib\site-packages\selenium-2.48.0-py2.7.egg\selenium\webdriver\remote\webdriver.py", line 201, in execute
self.error_handler.check_response(response)
File "C:\Python27\lib\site-packages\selenium-2.48.0-py2.7.egg\selenium\webdriver\remote\errorhandler.py", line 181, in check_response
raise exception_class(message, screen, stacktrace)
WebDriverException: Message: An unknown server-side error occurred while processing the command. Original error: Could not find adb Please set the ANDROID_HOME environment variable with the Android SDK root directory path.
一个测试样例
创建脚本
一个测试脚本样例:
import os
import unittest
from appium import webdriver
from time import sleep
# Returns abs path relative to this file and not cwd
class ContactsAndroidTests(unittest.TestCase):
def setUp(self):
desired_caps = {}
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '4.2'
desired_caps['deviceName'] = 'Android Emulator'
//desired_caps['app'] = 'E://ContactManager.apk'
desired_caps['appPackage'] = 'com.example.android.contactmanager'
desired_caps['appActivity'] = '.ContactManager'
self.driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)
def tearDown(self):
self.driver.quit()
def test_add_contacts(self):
el = self.driver.find_element_by_accessibility_id("Add Contact")
el.click()
textfields = self.driver.find_elements_by_class_name("android.widget.EditText")
textfields[0].send_keys("Appium User")
textfields[2].send_keys("[email protected]")
self.assertEqual('Appium User', textfields[0].text)
self.assertEqual('[email protected]', textfields[2].text)
self.driver.find_element_by_accessibility_id("Save").click()
# for some reason "save" breaks things
alert = self.driver.switch_to_alert()
# no way to handle alerts in Android
self.driver.find_element_by_android_uiautomator('new UiSelector().clickable(true)').click()
self.driver.press_keycode(3)
if __name__ == '__main__':
suite = unittest.TestLoader().loadTestsFromTestCase(ContactsAndroidTests)
unittest.TextTestRunner(verbosity=2).run(suite)
Desired Capabilities
desired_caps = {}
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '4.2'
desired_caps['deviceName'] = 'Android Emulator'
desired_caps['app'] = '../../../sample-code/apps/ContactManager/ContactManager.apk'
desired_caps['appPackage'] = 'com.example.android.contactmanager'
desired_caps['appActivity'] = '.ContactManager'
driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)
-
deviceName:启动哪种设备,是真机还是模拟器?iPhone Simulator,iPad Simulator,iPhoneRetina 4-inch,Android Emulator,Galaxy S4…
deviceName通过adb devices查看
platformName:使用哪种移动平台。iOS, Android, orFirefoxOS。
platformVersion:指定平台的系统版本。例如指的Android平台,版本为5.1。
app:apk文件的路径,appium会尝试先安装该app。
appActivity:待测试的app的Activity名字。比如MainActivity、.Settings。注意,原生app的话要在activity前加个”.“。
appPackage:待测试的app的Java package。比如com.example.android.myApp, com.android.settings。
appActivity和appPackage一般由开发人员提供,如果无法获取的话,可以通过以下方式获取
1、用winrar打开apk
2、选择AndroidManifest.xml,右键查看文件
3、查看
其中:m a n i f e s t " c o m . e x a m p l e . a n d r o i d . c o n t a c t m a n a g e r"就是appPackage
其中:a c t i v i t y � . C o n t a c t M a n a g e r 就是appActivity
v e r s i o n C o d e
v e r s i o n N a m e
m i n S d k V e r s i o n � t a r g e t S d k V e r s i o n � n a m e � l a b e l � i c o n
d e b u g g a b l e � a n d r o i d * h t t p : / / s c h e m a s . a n d r o i d . c o m / a p k / r e s / a n d r o i d � p a c k a g e m a n i f e s t " c o m . e x a m p l e . a n d r o i d . c o n t a c t m a n a g e r � 1 . 0 u s e s - s d k � u s e s - p e r m i s s i o n � a n d r o i d . p e r m i s s i o n . G E T _ A C C O U N T S a n d r o i d . p e r m i s s i o n . R E A D _ C O N T A C T S ! a n d r o i d . p e r m i s s i o n . W R I T E _ C O N T A C T S
a p p l i c a t i o n a c t i v i t y � . C o n t a c t M a n a g e r
i n t e n t - f i l t e r � a c t i o n � a n d r o i d . i n t e n t . a c t i o n . M A I N c a t e g o r y a n d r o i d . i n t e n t . c a t e g o r y . L A U N C H E R
appium 定位控件
这里通过appium自带的Inspector工具可以查看对象各种属性。也可以用android sdk自带的uiautomatorviewer.bat来进行定位
1、启动appium server
2、启动模拟器,并安装待测试的apk:ContactManager.apk(将文件拖入模拟器即可)
3、模拟器中打开ContactManager.apk,放在待测试的页面
4、点击Start Inspector session图标
5、在name和value处分别输入以下内容,点击start session启动
platformName Android
platformVersion 4.2
deviceName Android Emulator
appPackage com.example.android.contactmanager
appActivity ContactManager
界面如下
录制脚本
Inspector提供了简单的脚本操作
1、选择录制脚本
2、在页面上做一些操作,比如点击等
3、可以看到页面上有脚本出现,复制脚本即可
定位元素信息
选中一个元素就可以实现定位,页面右侧展示了元素具体的内容
注意:出现不能点击鼠标来进行定位的话,可以选用uiautomatorviewer.bat来进行定位,或者两个结合使用。
id 定位
如果目标设备的API Level低于18则UIAutomatorViewer不能获得对应的Resource ID,只有等于大于18的时候才能使用。
resource-id 就是我们理解的id属性了。
使用方法:
driver.findElement(By.id("com.android.calculator2:id/formula"))
name 定位
text就是我们要查找的name!
使用方法:
driver.findElement(By.name("21"))
Accessibility ID定位
这个方法属于Appium扩展的定位方法。
其实,我们的核心是要找到元素的contentDescription属性。它就是元素的 content-desc 。
使用方法:
driver.findElementByAccessibilityId("Add contact").click();
android uiautomator定位
这个方法也属于 Appium(Android)扩展的定位方法。
也就是说一个元素的任意属性都可以通过android uiautomator方法来进行定位,但要保证这种定位方式的唯一性。
使用方法:
driver.find_element_by_android_uiautomator('new UiSelector().text("Custom View")').click() driver.find_element_by_android_uiautomator('new UiSelector().textContains("View")').click()
driver.findElementByAndroidUIAutomator('new UiSelector().description("equals")").click();
需要注意的是 description() 方法用的是content-desc属性。
find_elements_by_class_name方法
方法:
- find_elements_by_class_name()
通过元素class name属性定位所有含有该属性的元素
driver.find_elements_by_class_name('name')
appium API
sendKeys()方法
方法:
- sendKeys()
用法:
driver.findElements(By.name("Name")).sendKeys("jack");
pressKeyCode()方法
除此之外,appium扩展提供了pressKeyCode()方法。该方法Android特有。
方法:
- pressKeyCode()
发送一个键码的操作。需要一个入参。
driver.pressKeyCode(29); // 字母“a”
driver.pressKeyCode(3);//KEYCODE_HOME
switch_to_alert()方法
方法:
- switch_to_alert()
切换到alert窗口
driver.switch_to_alert()
click()方法
方法:
- click()
点击某个控件
element.click()
API文档参考:http://blog.csdn.net/yangyinsong815/article/details/51235708
至此,脚本中所有的知识点讲解完毕,现在开始运行它吧!运行之前请确保模拟器打开!
真机运行
模拟器并不能模拟真实的手机执行,最终我们的案例还是需要在真机中进行。
真机和模拟器执行的区别在于:
真机运行需要打开USB调试所有项