Appium+Python3+ Android入门

前言:

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


1、环境配置

一、安装Node.jsnode

https://nodejs.org/android

二、安装Appiumweb

http://appium.io/ npm

三、安装Android SDKandroid-studio

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

四、安装Python-clientapp

pip3 install Appium-Python-Client框架

五、安装Appium-clientide

npm install wd

最后,打开命令行,输入“appium-doctor”命令,若是出现如下提示,说明你Appium所须要的各项环境都已准备完成。


2、服务关键字

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

Desired Capabilities本质上是以key value字典的方式存放,客户端将这些键值对发给服务端,告诉服务端咱们想要怎么测试。

desired_caps = {}

desired_caps['platformName'] ='Android'

desired_caps['platformVersion'] ='6.0.1'

desired_caps['deviceName'] ='e0bbc8b7'

desired_caps['appPackage'] ='com.ximalaya.ting.android'

desired_caps['appActivity'] ='com.ximalaya.ting.android.host.activity.WelComeActivity'

desired_caps["unicodeKeyboard"] ="True"

desired_caps["resetKeyboard"] ="True"

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

 

它告诉appium Server这样一些事情:

•deviceName:启动哪一种设备,是真机仍是模拟器?iPhone Simulator,iPad Simulator,iPhone Retina 4-inch,Android Emulator,Galaxy S4…

•automationName:使用哪一种自动化引擎。appium(默认)仍是Selendroid。

•platformName:使用哪一种移动平台。iOS, Android, orFirefoxOS。

•platformVersion:指定平台的系统版本。例如指的Android平台,版本为5.1。

•appActivity:待测试的app的Activity名字。好比MainActivity、.Settings。注意,原生app的话要在activity前加个”.“。

•appPackage:待测试的app的Java package。好比com.example.android.myApp, com.android.settings。


3、定位控件

一、ID定位

使用方法:driver.find_element_by_id(‘com.android.calculator2:id/formula’)

 

二、name定位

使用方法:driver.find_element_by_name("9"))

 

三、class name定位

使用方法:driver.find_element_by_class_name(“android.widget.Button"))

 

四、XPath定位

使用方法:用class的属性来替代作标签的名字。

driver.find_element_by.xpath(“//android.view.ViewGroup/android.widget.Button”)

 

当果若是出现class相同的状况下能够用控件的属性值进行区分。

driver.find_element_by_xpath("//android.widget.Button[contains(@text,'7')]").click();

driver.find_element_by_xpath(”//android.widget.Button[contains(@content-desc,’times')]").click();

driver.find_element_by_xpath("//android.widget.Button[contains(@text,'7')]").click();

driver.ffind_element_by_xpath("//android.widget.Button[contains(@content-desc,'equals')]").click();

 

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

五、Accessibility ID定位

使用方法:其实,咱们的核心是要找到元素的contentDescription属性。它就是元素的content-desc。

driver.find_element_by_accessibility_id("plus").click();

 

六、android uiautomator定位

使用方法:

一个元素的任意属性均可以经过android uiautomator方法来进行定位,但要保证这种定位方式的惟一性。

driver.find_element_by_android_uiautomator("new UiSelector().text(\”8\")").click();

driver.find_element_by_android_uiautomator("new UiSelector().description(\”plus\")").click();

 

 


4、应用操做

一、安装应用

installApp()

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

二、卸载应用

removeApp()

从设备中删除一个应用。

三、关闭应用

closeApp()

关闭打开的应用,默认关闭当前打开的应用,因此不须要入参。这个方法并不是真正的关闭应用,至关于按home键将应用置于后台,能够经过launchApp()再次启动。

四、启动应用

launchApp()

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

五、检查应用是否安装

isAppInstalled()

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

六、将应用置于后台

runAppInBackground()

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

七、应用重置

resetApp()

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


5、键盘操做

一、SendKeys()方法

driver.find_element_by_name(“Name”).send_keys("jack");

二、PressKeyCode()方法

除此以外,Appium扩展提供了pressKeyCode()方法。该方法Android特有。

发送一个键码的操做。(键码对照表请自行百度,此处不展现了。)

driver.press_keycode(3)//点击Android的HOME键

driver.press_keycode(27)//点击拍照键

三、输入法问题:

必须使用appium自带键盘,并添加:

desired_caps["unicodeKeyboard"] = "True"

desired_caps["resetKeyboard"] = "True"


6、TouchAction操做

Appium的辅助类,主要针对手势操做,好比滑动、长按、拖动等。

一、按压控件press()

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

press(WebElement el, int x, int y)

二、长按控件longPress()

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

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

三、点击控件tap()

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

tap(WebElement el, int x, int y)

四、移动moveTo()

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

movTo(WebElement el, int x, int y)

五、暂停wait()

暂停脚本的执行,单位为毫秒。

action.wait(1000);


7、其余操做

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

一、熄屏

方法:lockDevice()

点击电源键熄灭屏幕。

在iOS设备能够设置熄屏一段时间。Android上面不带参数,因此熄屏以后就不会再点亮屏幕了。

driver.lockDevice(1000);// iOS

driver.lockDriice();//Android

二、收起键盘

方法:hideKeyboard()

收起键盘,这个方法颇有用,当咱们对一个输入框输入完成后,须要将键盘收起,再切换到一下输入框进行输入。

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

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

四、截屏

方法:get_screenshot_as_file()

用法:driver.get_screenshot_as_file('../screenshot/foo.png'),参数为保存的图片路径和名称

五、获取控件各类属性

方法:get_attribute()

用法: driver.find_element_by_id().get_attribute(name),

name便是左侧的标志(class,package,checkable,checked....),

可获取的字符串类型:

name(返回content-desc或text)

text(返回text)

className(返回class,只有API=>18才能支持)

resourceId(返回resource-id,只有API=>18才能支持)


8、unittest之断言

在unittest单元测试框架中,TestCase类提供了一些方法来检查并报告故障:

>>assertEqual(first, second, msg=None)

判断first和second的值是否相等,若是不相等则测试失败,msg用于定义失败后所抛出的异常信息。

>>assertNotEqual(first, second, msg=None)

测试first和second不相等,若是相等,则测试失败。

>>assertTure(expr,msg=None)

>>assertFalse(expr,msg=None)

测试expr为Ture(或为False)

>>assertIs(first, second, msg=None)

>>assertIsNot(first, second, msg=None)

测试的first和second是(或不是)相同的对象。

>>assertIsNone(expr, msg=None)

>>assertIsNotNone(expr, msg=None)

测试expr是(或不是)为None

>>assertIn(first, second, msg=None)

>>assertNotIn(first, second, msg=None)

测试first是(或不是)在second中。second包含是否包含first。


9、实例代码(例子app:喜马拉雅FM)

import os

import unittest

from appium import webdriver

from time import sleep

# Returns abs path relative to this file and not cwd

PATH =lambdap: os.path.abspath(

os.path.join(os.path.dirname(__file__), p)

)

class Contacts Android Tests(unittest.TestCase):

def setUp(self): 

desired_caps = {}

desired_caps['platformName'] ='Android'

desired_caps['platformVersion'] ='6.0.1'

desired_caps['deviceName'] ='e0bbc8b7'

desired_caps['appPackage'] ='com.ximalaya.ting.android'

desired_caps['appActivity'] ='com.ximalaya.ting.android.host.activity.WelComeActivity'

desired_caps["unicodeKeyboard"] ="True"

desired_caps["resetKeyboard"] ="True"

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

sleep(6)

def tearDown(self):

self.driver.close_app()

self.driver.quit()

deftest_Login(self):

self.driver.find_element_by_id('com.ximalaya.ting.android:id/tab_myspace').click()

sleep(2)

self.driver.find_element_by_accessibility_id('设置').click()

sleep(2)

width =self.driver.get_window_size()['width']

height =self.driver.get_window_size()['height']

self.driver.swipe(width /2, height *7/8, width /2, height *4/8,1000)

# 不一样的手机分辨率不一样,因此一个坐标若是用另外一个分辨率不一样的手机可能位置就有所变化了,为了让apppium 更好的兼容不一样分辨率的设备,

# 在执行滑动前先获取屏幕的分辨率。

self.driver.find_element_by_id('com.ximalaya.ting.android:id/main_tv_login').click()

self.driver.find_element_by_id('com.ximalaya.ting.android:id/main_username').send_keys('18500425217')

self.driver.find_element_by_id('com.ximalaya.ting.android:id/main_password').send_keys('wj1234')

self.driver.find_element_by_id('com.ximalaya.ting.android:id/main_login').click()

sleep(4)

text =self.driver.find_element_by_id('com.ximalaya.ting.android:id/tab_myspace').text

self.assertEqual(text,'个人')

deftest_Search(self):

sleep(3)

message =self.driver.find_element_by_id('com.ximalaya.ting.android:id/main_item_finding_title').text

self.assertEqual(message,'每天好书')

self.driver.find_element_by_accessibility_id("搜索").click()

self.driver.find_element_by_id('com.ximalaya.ting.android:id/main_search_et').send_keys('段子')

self.driver.find_element_by_id('com.ximalaya.ting.android:id/main_search_button').click()

self.driver.get_screenshot_as_file('/Users/wangjuan/截图图库/1.jpg')

self.driver.press_keycode(4)

self.assertEqual(message,'每天好书')

if__name__ =='__main__':

suite = unittest.TestLoader().loadTestsFromTestCase(ContactsAndroidTests)

unittest.TextTestRunner(verbosity=2).run(suite)

 


以上,但愿对你有所帮助~~