appium是一款移动自动化测试工具,经常被用于实现UI自动化测试,其可支持安卓和IOS两大平台,还支持多种编程,因而得到了广泛的应用。此处便是立足于安卓平台,借助appium工具,使用python语言实现简单的自动化测试。
Native App:原生应用(特定移动设备或平台开发的应用程序)
Mobile Web App:移动Web应用(通过移动浏览器访问的应用程序,如IOS的Safari,Android的Chrome)
Hybrid App:混合应用(主要指使用网络技术开发,嵌入到App中运行的应用)
appium的核心是一个C/S架构,appium相当于一个web服务器,提供一套接口,它会接收客户端的命令,然后在移动设备上运行命令,最后通过HTTP响应包把结果返回给客户端,每个客户端连接上服务器后都会创建一个session,自动化都会围绕一个session进行。即appium在PC上启动一个Server,监听来自客户端的自动化测试的运行,并将请求发送到对应的的移动设备中运行。
(1)JDK包下载网址如下:https://www.oracle.com/java/technologies/downloads/#jdk19-windows,由于原网址下载过慢,也可考虑使用开源软件镜像站下载
(2)下载版本:目前有19、17、11、8等版本的,选合适的就行,这边下载的是1.8.0_282版本
(3)安装:网上教程一堆,安装JDK和配置好环境变量便可
(4)安装完成后使用 win+R 唤出window终端输入 java -version 查看是否安装成功
C:\Users\24637>java -version
openjdk version "1.8.0_282"
OpenJDK Runtime Environment (build 1.8.0_282-b08)
Eclipse OpenJ9 VM (build openj9-0.24.0, JRE 1.8.0 Windows 8.1 amd64-64-Bit 20210120_560 (JIT enabled, AOT enabled)
OpenJ9 - 345e1b09e
OMR - 741e94ea8
JCL - ab07c6a8fd based on jdk8u282-b08)
安装Android SDK有两种方法,一种是直接下载安装SDK包,一种是通过Android Studio安装SDK。
1、下载SDK包后解压到你设定的路径,配置好环境变量,SDK包下载网址如下:https://developer.android.google.cn/studio/releases/platform-tools,同样可考虑使用开源软件镜像站下载
2、通过Android Studio安装SDK,选好路径,配置好环境变量,然后启动Android Studio安装对应的sdk包—目前官网推荐的是下载包含有Android SDK的Android Studio。
详细教程上网搜索便可,最终目的是可以正常使用安卓的adb功能,安装完成后使用 win+R 唤出window终端输入 adb --version查看是否安装成功。
C:\Users\24637>adb --version
Android Debug Bridge version 1.0.41
Version 33.0.3-8952118
Installed as E:\android-sdk_r24.4.1-windows\android-sdk-windows\platform-tools\adb.exe
appium Client支持多种编程语言,由于此处使用的是python语言,所以这里选择使用Python-Client,可通过以下两种方法安装对应的测试库。
1、win+R 唤出 window 终端输入:pip install Appium-Python-Client
window 终端输入 pip list 可查看是否安装了对应的包:
C:\Users\24637>pip list
WARNING: Ignoring invalid distribution -ip (e:\python_3.10.2_64_bit\lib\site-packages)
Package Version
------------------------- ---------
adbutils 0.15.2
altgraph 0.17.3
apkutils2 1.0.0
Appium-Python-Client 2.2.0
argcomplete 1.12.3
2、pycharm软件安装则是直接搜索安装Appium-Python-Client即可,打开设置菜单 > 项目 > python解释器 > 添加 > 搜索Appium-Python-Client 选中后点击安装即可,安装成功后可以在python解释器里看到对应的包。
appium-desktop主要是作为服务器,来监听我们的移动设备,接收Client(客户端)发来的JSON请求,解析后驱动移动设备运行测试用例,我们可以根据自己的平台下载相应的版本。
1、appium-desktop下载网站为: https://github.com/appium/appium-desktop/releases/tag/v1.22.3-4,此处下载的是window版本的appium(Appium-Server-GUI-windows-1.22.3-4.exe)
2、下载完成后直接双击打开安装,安装成功后会在桌面生成一个appium的图标,启动后界面如下图所示,默认显示监听的Host和Port为0.0.0.0:4723,单击启动 “服务器 v1.22.3” 按钮,启动Server,监听本机的4723端口。
随着appium-desktop的发展,appium-desktop的服务和查看元素的功能已经分开了,最新版本的appium-desktop目前只作为服务器,而原来的查看元素的功能被剥离了出来,查看元素信息就需要下载Appium Inspector。Appium Inspector下载网站为:https://github.com/appium/appium-inspector/releases,此处下载的版本是:Appium-Inspector-windows-2022.11.1.exe,目前已有最新的版本,也可以直接下载最新的版本便可。下载完后直接安装,启动后界面如下图所示。
安卓模拟器,顾名思义就是用来模拟安卓设备,从而实现对安卓设备的模拟操作和调试,常用的安卓模拟器有:Android Studio emulator(官方)、genymotion、mumu、雷电、夜神、逍遥等,此处实验使用的模拟器为MuMu模拟器。进入MuMu模拟器官网直接下载便可,下载网站为:https://mumu.163.com/,下载完成后直接打开使用便可,其界面如下。
**此章节主要是介绍Appium的一些基础,也可以先选择从第五章节看起,先实现Appium的简单例子
Desired Capabilities是由客户端生成的一个字典对象,在appium中主要扮演着告诉服务器App(被测App)运行的环境。
import time
from appium import webdriver
from appium.webdriver.common.appiumby import AppiumBy
# 定义Android运行环境
desired_caps = {
"deviceName": "Android Emulator", # 启动的设备
"automationName": "Appium", # 使用的自动化引擎,如appium(默认)或Selendroid
"platformName": "Android", # 使用的移动平台,如Android或IOs
"platformVersion": "6.0.1", # 指定的平台的系统版本,这里为安卓平台,版本7.0
"appPackage": "com.android.settings", # 被测试App的Package名
"appActivity": ".Settings", # 被测试App的Activity名
"unicodeKeyboard": True, # 设置中文键盘
"resetKeyboard": True, # 重置自动化时设置的键盘
}
driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)
# 1、使用ID定位(点击搜索)
driver.find_element(AppiumBy.ID, "com.android.settings:id/search").click()
如上代码所示,Desired Capabilities字典里面设置好了待测软件所需要的相关参数,每个字典元素都有其固定的作用,上面只是最为常用的一些参数,想了解更多的配置参数说明,可以参考官方文档:
http://appium.io/docs/en/writing-running-appium/caps/
(1)使用ID定位
ID定位是使用控件的resource-id进行定位,通过Appium Inspector工具可以查看resource-id,如上图所示,resource-id的使用用到driver.find_element()函数,安装和导入好对应的库便可使用,且要注意区分AppiumBy模块和By模块,By模块一般用于web的测试,所以此若是用By模块,会导致一些定位方法无法被识别到,所以这里就乖乖使
用AppiumBy就好,方法如下:
from appium import webdriver
from appium.webdriver.common.appiumby import AppiumBy
# from selenium.webdriver.common.by import By
desired_caps = {
...
...
}
driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)
# 1、使用ID定位(点击搜索)
driver.find_element(AppiumBy.ID, "com.android.settings:id/search").click()
time.sleep(1)
(2)使用Class Name定位
通过控件的class属性进行定位,可以通过Appium Inspector工具查看到控件的class属性(如上图所示),若遇到多个元素的class属性都是一个名称,我们可以使用driver.find_elements()函数,先定位一组控件,再进一步筛选,从而找到想要操作的控件,下面是使用class定位一个控件的写法:
from appium import webdriver
from appium.webdriver.common.appiumby import AppiumBy
# from selenium.webdriver.common.by import By
desired_caps = {
...
...
}
driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)
# 2、使用Class Name定位(点击退出搜索)
driver.find_element(AppiumBy.CLASS_NAME, "android.widget.ImageButton").click()
time.sleep(1)
(3)使用XPath定位
XPath是通过查找层级签名来定位控件,可以通过Appium Inspector工具查看到控件的XPath属性(如上图所示),XPath在appium上的用法很强大,就是太长了点,可通过实际应用场景进行使用,使用方法如下:
from appium import webdriver
from appium.webdriver.common.appiumby import AppiumBy
# from selenium.webdriver.common.by import By
desired_caps = {
...
...
}
driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)
# 3、使用XPath定位(点击显示)
driver.find_element(AppiumBy.XPATH, "/hierarchy/android.widget.FrameLayout/android.view.ViewGroup/android.widget.FrameLayout[2]/android.widget.FrameLayout/android.widget.ScrollView/android.widget.LinearLayout/android.widget.LinearLayout[2]/android.view.ViewGroup/android.widget.FrameLayout[1]/android.widget.LinearLayout/android.widget.LinearLayout/android.widget.LinearLayout").click()
time.sleep(1)
(4)使用Accessibility id定位
在Android中,Accessibility id定位取控件的content-desc属性,同样可通过Appium Inspector工具查看到对应的属性(如上图所示),使用方法如下:
from appium import webdriver
from appium.webdriver.common.appiumby import AppiumBy
# from selenium.webdriver.common.by import By
desired_caps = {
...
...
}
driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)
# 4、使用Accessibility id定位
driver.find_element(AppiumBy.ACCESSIBILITY_ID, "向上导航").click()
time.sleep(1)
(4)使用Android uiautomator定位
Android uiautomator定位,属于appium的扩展定位方法,且只支持Android平台;Android uiautomator可以直接使用UIAutomator2的定位方法来查找控件,由于其使用的是UIAutomator2测试库,所以同样可通过对应的属性来实现对控件的定位,其指同样可以通过Appium Inspector工具查看到对应的属性(如上图所示),此处大概列举几种常见的属性定位方式如下:
import time
from appium import webdriver
from appium.webdriver.common.appiumby import AppiumBy
# from selenium.webdriver.common.by import By
desired_caps = {
...
...
}
driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)
# 5、使用Android uiautomator定位,属于appium的扩展定位方法,且只支持Android平台
driver.find_element(AppiumBy.ANDROID_UIAUTOMATOR, 'new UiSelector().text("网易新闻")').click() #text属性,匹配全部
time.sleep(10)
driver.find_element(AppiumBy.ANDROID_UIAUTOMATOR, 'new UiSelector().textContains("登录")').click() #text属性,匹配部分
time.sleep(1)
driver.find_element(AppiumBy.ANDROID_UIAUTOMATOR, 'new UiSelector().textStartsWith("我的钱")').click() #text属性,匹配开头
time.sleep(1)
driver.find_element(AppiumBy.ANDROID_UIAUTOMATOR, 'new UiSelector().description("返回")').click() #content-desc属性
time.sleep(1)
driver.find_element(AppiumBy.ANDROID_UIAUTOMATOR, 'new UiSelector().resourceId("com.netease.newsreader.activity:id/lb")').click() #id属性
time.sleep(1)
driver.find_element(AppiumBy.ANDROID_UIAUTOMATOR, 'new UiSelector().className("android.widget.TextView")').click() #class属性
time.sleep(1)
driver.find_element(AppiumBy.ANDROID_UIAUTOMATOR, 'new UiSelector().className("android.widget.EditText")').send_keys("hello world!") #class属性,(.TextView)元素不能用于输入,(.EditText)元素才能定位后输入
UIAutomator的定位方式有很多,以上简单列举了其对于text属性、content-desc属性、id属性、class属性的使用方法,有兴趣了解更多的,,可以查看官方的文档,其链接如下:https://developer.android.google.cn/training/testing/ui-automator
(4)其它定位
#6、Web APP下,或者Hybrid APP(混合应用)的WebView组件下使用
driver.find_element(AppiumBy.NAME, "").click()
driver.find_element(AppiumBy.TAG_NAME, "").click()
driver.find_element(AppiumBy.LINK_TEXT, "").click()
driver.find_element(AppiumBy.PARTIAL_LINK_TEXT, "").click()
driver.find_element(AppiumBy.CSS_SELECTOR, "").click()
time.sleep(1)
#7、前面三个是IOS的定位,后4个不常用,这里就不做介绍了
driver.find_element(AppiumBy.IOS_UIAUTOMATION, "").click()
driver.find_element(AppiumBy.IOS_PREDICATE, "").click()
driver.find_element(AppiumBy.IOS_CLASS_CHAIN, "").click()
driver.find_element(AppiumBy.ANDROID_VIEWTAG, "").click()
driver.find_element(AppiumBy.ANDROID_DATA_MATCHER, "").click()
driver.find_element(AppiumBy.IMAGE, "").click()
driver.find_element(AppiumBy.CUSTOM, "").click()
实际的定位方法还有很多,前面就简单列举几种最常见的方法,其他方法可在实践中继续学习拓展
(1)应用操作
1、driver.install_app(“应用包名路径”) #安装app
2、driver.remove_app(“应用包名”) #卸载app
3、driver.terminate_app(“应用包名”) #关闭app
4、driver.activate_app(“应用包名”) #打开app
5、result = driver.is_app_installed(“应用包名”) #判断app是否安装
print(result)
6、driver.background_app(10) #退至后台
Appium可通过以上对应的函数实现对app应用的各种操作,如安装、卸载、关闭、打开等,例子如下:
import time
from appium import webdriver
from appium.webdriver.common.appiumby import AppiumBy
desired_caps = {
...
...
}
driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)
driver.terminate_app("com.android.settings") #关闭设置应用
time.sleep(1)
if driver.is_app_installed("com.adsk.sketchbook"): #判断应用是否已安装
driver.remove_app("com.adsk.sketchbook") #卸载应用
print("卸载书写软件成功!")
else:
driver.install_app("C:/Users/24637/Desktop/自动化测试常用软件/com.adsk.sketchbook_5.2.5_liqucn.com.apk") #安装应用
print("软件不存在,正在安装。。。")
driver.activate_app("com.netease.newsreader.activity")
driver.background_app(5) #退至后台
(2)上下文操作
1、contexts = driver.contexts #获取当前所有可用上下文
print(contexts)
2、current_context = driver.current_context #获取当前上下文
print(current_context)
3、driver.switch_to.context(‘NATIVE_APP’) #切换上下文
import time
from appium import webdriver
from appium.webdriver.common.appiumby import AppiumBy
desired_caps = {
...
...
}
driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)
#上下文操作
contexts = driver.contexts #获取当前所有可用上下文
print(contexts)
current_context = driver.current_context #获取当前上下文
print(current_context)
# driver.switch_to.context('NATIVE_APP') #切换上下文
上下文就是一种属性的有序序列,为驻留在环境内的对象定义环境,appium里面的上下文主要针对混合应用,它们与App原生控件和内嵌的Web页面上的元素的定位方式不同,所以需要确认当前操作的元素或者控件的上下文,以便于使用不同的定位策略
(3)键盘输入
1、driver.keyevent(键值码)
import time
from appium import webdriver
from appium.webdriver.common.appiumby import AppiumBy
desired_caps = {
...
...
}
driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)
driver.activate_app("com.netease.newsreader.activity") #打开网易新闻应用
time.sleep(5)
driver.find_element(AppiumBy.ANDROID_UIAUTOMATOR, 'new UiSelector().className("android.widget.TextView")').click() #点击搜索
time.sleep(1)
driver.find_element(AppiumBy.ANDROID_UIAUTOMATOR, 'new UiSelector().className("android.widget.EditText")').send_keys("jack!") #输入jack
time.sleep(1)
#键值输入186
driver.keyevent(8)
driver.keyevent(15)
driver.keyevent(13)
#键值输入hello
driver.keyevent(36)
driver.keyevent(33)
driver.keyevent(40)
driver.keyevent(40)
driver.keyevent(43)
将光标定位到了某输入框后,自动进入键盘输入模式,执行keyevent()方法,输入对应的字符编号,这便是键值函数的用法。以上只是简单列举了一些键值的用法,更多键值信息在以下网站找到参考:https://developer.android.google.cn/reference/android/view/KeyEvent
(4)触摸操作 TouchAction
1、触摸点击操作
触摸点击操作函数TouchAction(driver).tap(),主要有三个参数,坐标点(x=33, y=86)、控件元素(element = el)和点击次数(count = 2),通过对这三个参数的操作,可实现使用坐标或者控件进行触摸定位,实现单击和双击的触摸点击功能,其具体使用例子如下所示:
from appium import webdriver
from appium.webdriver.common.appiumby import AppiumBy
from appium.webdriver.common.touch_action import TouchAction
desired_caps = {
...
...
}
driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)
driver.activate_app("com.netease.newsreader.activity") #打开网易新闻应用
time.sleep(15)
#通过控件实现触摸
el = driver.find_element(AppiumBy.ID, "com.netease.newsreader.activity:id/c52")
actions = TouchAction(driver).tap(element=el)
actions.perform()
#通过坐标点实现触摸
actions = TouchAction(driver)
actions.tap(x=333, y=609)
actions.perform()
#双击
actions = TouchAction(driver)
actions.tap(x=333, y=609,count=2) #count为点击次数
actions.perform()
2、触摸长按
from appium import webdriver
from appium.webdriver.common.appiumby import AppiumBy
from appium.webdriver.common.touch_action import TouchAction
desired_caps = {
...
...
}
driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)
driver.terminate_app("com.android.settings")
#长按控件
el = driver.find_element(AppiumBy.ANDROID_UIAUTOMATOR,'text("网易新闻")')
TouchAction(driver).long_press(el, duration=2000).perform()
TouchAction(driver).long_press(x=521, y=349, duration=2000).perform()
3、移动
将光标移动到新的元素或坐标点,同样可以通过控件和坐标进行定位,而后进行移动操作,其函数如下:
#移动
el = driver.find_element(AppiumBy.ANDROID_UIAUTOMATOR,'text("CIBN酷喵")') #通过控件定位
TouchAction(driver).move_to(el).perform()
TouchAction(driver).move_to(x=523, y=507).perform() #通过坐标定位
4、暂停
暂停脚本的执行,wait(self,ms=0),单位为毫秒
TouchAction(driver).wait(5000).perform()
5、多点触控执行
appium不仅可以执行一个动作,还可以同时执行多个动作,形成动作链,模拟多个手指触摸的动作,appium需要通过构建一个MultiAction对象来实现执行多个动作的。通过导入MultiAction库进行编写,如下所示:
from appium import webdriver
from appium.webdriver.common.touch_action import TouchAction
from appium.webdriver.common.multi_action import MultiAction
desired_caps = {
...
...
}
driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)
driver.terminate_app("com.android.settings")
time.sleep(3)
#同时执行多个动作 MultiAction
a1 = TouchAction()
a1.press(x=243,y=184)
a1.move_to(x=930, y=184)
a1.release()
a2 = TouchAction()
a2.long_press(x=243,y=342)
a2.move_to(x=930, y=342)
a2.release()
ma = MultiAction(driver)
ma.add(a1, a2)
ma.perform()
(5)特有操作
1、获取当前App的包名(package),仅支持Android
package = driver.current_package
print(package)
2、获取当前App的activity,仅支持Android
activity = driver.current_activity
print(activity)
3、收起键盘(有些客户端可能无效)
activity = driver.current_activity
print(activity)
4、息屏(有些客户端可能无效)
driver.lock(seconds=1)
5、获取屏幕宽高
windows = driver.get_window_size()
print(windows["width"])
print(windows["height"])
6、拉取文件
拉取文件到设备中,这里要注意拉取到的数据格式为base64编码的,所以这里要进行编解码处理,并导入base64库。
import base64
file_base64 = driver.pull_file('/sdcard/1.txt').encode() #encode()函数,将字符串Str类型数据转换成bytes数据类型
file_base64 = base64.decodebytes(file_base64) #这里是把bytes的数据进行base64解码,解码成功后,返回的数据类型为bytes
print(file_base64.decode()) #把bytes数据类型转换成Str数据类型,并打印出来
7、推送文件
把文件推送到设备中
import base64
data = "some data for the file"
data = base64.b64encode(data.encode('utf8')) #编码成base64数据,并转换成bytes格式的数据
path = "/sdcard/1.txt"
driver.push_file(path, data.decode()) #把数据推送到设备里面
以上便是appium的一些常用API的用法,要想进一步了解更多的API的接口信息,则也可以直接进入以下网址查询,基本所有相关的API使用方法都能在里面找到,Appium的API接口文档链接如下:https://appium.io/docs/en/about-appium/api/
此外,想了解更多的appium内容,也可以到官网查看它的相关信息,appium官网链接如下:http://appium.io/docs/en/about-appium/intro/
对于Appium Inspector的使用,这里主要讲解它两个基本的功能,获取元素的控件信息和录制脚本的功能,其具体用法如下。
(1)获取元素的功能
上面讲解元素的定位方式的时候,获取App的相关控件参数也是通过Appium Inspector来实现的,这里边简单的展开讲解下其使用的方法。
1、启动MuMu模拟器,win + r 输入cmd进入window终端,输入:“adb connect 127.0.0.1:7555” 连接上安卓模拟器
C:\Users\24637>adb connect 127.0.0.1:7555
* daemon not running; starting now at tcp:5037
* daemon started successfully
connected to 127.0.0.1:7555
2、启动Appium Server GUI
直接点击打开后,点击启动服务器便可
3、启动Appium Inspector
按照以上图片所示,设置好IP和端口,并根据终端App运行的环境,设置好Desired Capabilities的参数值,点击运行。
4、获取控件元素信息
启动Appium Inspector成功后,会进入到以上界面,选中查看元素模式,把光标移动到对应的App元素上,右边便可出现对于的元素控件信息
(2)录制脚本的功能
录制脚本,也可以分为根据坐标操作元素和根据控件操作元素两大内容
1、通过坐标操作元素-点击
点击中间像眼睛的按钮,打开录制功能,把模式切换为点击坐标点的模式,点击客户端的坐标元素,便会同步在右边的录制显示框显示对应的代码,如上图所示,连续多次点击执行,便会生成对应的自动化测试脚本,把其复制粘贴到python里面运行便可。
#此处为点击后,生成的代码
actions = ActionChains(driver)
actions.w3c_actions = ActionBuilder(driver, mouse=PointerInput(interaction.POINTER_TOUCH, "touch"))
actions.w3c_actions.pointer_action.move_to_location([object Object], undefined)
actions.w3c_actions.pointer_action.pointer_down()
actions.w3c_actions.pointer_action.pause(0.1)
actions.w3c_actions.pointer_action.release()
actions.perform()
这里注意两点内容,第一点为:在复制代码时,需要选择显示全部的代码,并且复制全部的代码,而不是只移植一个函数;第二点为:如上显示的代码所示,获取到的函数的坐标是([object Object], undefined),这里移植到python里面运行的话,是会报错的,这里需要手动输入点击的坐标值,即要改为以下代码::
actions.w3c_actions.pointer_action.move_to_location(179,282)
2、通过坐标操作元素-滑动
打开录制功能,把模式切换为滑动坐标的模式,先选中一个点,再选中一个点,实现滑动操作,同样生成对应的滑动代码如下
#此处为滑动后,生成的代码
actions = ActionChains(driver)
actions.w3c_actions = ActionBuilder(driver, mouse=PointerInput(interaction.POINTER_TOUCH, "touch"))
actions.w3c_actions.pointer_action.move_to_location([object Object], undefined)
actions.w3c_actions.pointer_action.pointer_down()
actions.w3c_actions.pointer_action.move_to_location(undefined, undefined)
actions.w3c_actions.pointer_action.release()
actions.perform()
同上,复制全部的代码到python,更改对应函数里的坐标值,便可实现滑动操作了。
actions.w3c_actions.pointer_action.move_to_location(714,822)
actions.w3c_actions.pointer_action.move_to_location(714,307)
3、通过控件操作元素-点击
打开录制功能,把模式切换为选择元素的模式,选中一个元素,使用右边的选定元素里的小工具实现点击功能。
#通过控件点击搜索设置
el2 = driver.find_element(by=AppiumBy.ACCESSIBILITY_ID, value="搜索设置")
el2.click()
通过控件操作有个好处就是不需要手动更改代码的坐标,可直接复制全部的代码到python,便可实现代码的运行。
4、通过控件操作元素-发送密钥
打开录制功能,把模式切换为选择元素的模式,点击选中,并进入到输入框,使用右边的选定元素里的小工具实现输入密钥‘hello’的功能。
#点击搜索框,并切换至输入模式,输入hello
el1 = driver.find_element(by=AppiumBy.ACCESSIBILITY_ID, value="搜索设置")
el1.click()
el2 = driver.find_element(by=AppiumBy.ID, value="android:id/search_src_text")
el2.click()
time.sleep(1) #增加的延时
el2.send_keys("hello")
使用密钥时,要确保已经定位到了输入框。复制全部的代码到python,可能会出现执行到输入密钥时报错的情况,这大概率是由于指令执行过快,App的输入框还没完全反应过来,便执行输入导致,此时可手动增加一个延时便可实现代码的运行。
除了以上介绍的基本用法外,还有应用的其他详细功能,这里就不多介绍了,工具类就多操作,多尝试,这里只要掌握了自动脚本录制和移植到python运行便可,其它细节的功能,可边用边发掘。
经过前面的介绍,大家基本可以入门appium了,下面就用前面所学的内容,实现以下的UI自动化内容:运行脚本,进入设置App > 点击
(1)启动MuMu安卓模拟器
由于下面编辑的自动化脚本用到网易新闻,所以这里也可以先下载好网易新闻的apk,并安装好。
(2)启动Appium Server GUI
(3)win + r 输入cmd进入window终端,输入:“adb connect 127.0.0.1:7555”连接上安卓模拟器
(4)点击打开Appium Inspector,获取控件元素
(5)打开PyCharm输入以下代码,运行前面(1)-(4)的内容,操作方法前面已经介绍了,这里便直接进行代码编辑的实操介绍,环境搭建好后,便可开始进行代码的编写,这里结合以上的内容,运用上面所学的基本知识,立足于原生设置菜单和网易新闻apk,编写一个简单的完整例子如下:
import time
from appium import webdriver
from appium.webdriver.common.appiumby import AppiumBy
# 定义Android运行环境
desired_caps = {
"deviceName": "Android Emulator", # 启动的设备
"automationName": "Appium", # 使用的自动化引擎,如appium(默认)或Selendroid
"platformName": "Android", # 使用的移动平台,如Android或IOs
"platformVersion": "6.0.1", # 指定的平台的系统版本,这里为安卓平台,版本6.0.1
"appPackage": "com.android.settings", # 被测试App的Package名
"appActivity": ".Settings", # 被测试App的Activity名
"unicodeKeyboard": True, # 设置中文键盘
"resetKeyboard": True, # 重置自动化时设置的键盘
}
driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)
# 1、使用ID定位(点击搜索)
driver.find_element(AppiumBy.ID, "com.android.settings:id/search").click()
time.sleep(1)
# 2、使用Class Name定位(点击退出搜索)
driver.find_element(AppiumBy.CLASS_NAME, "android.widget.ImageButton").click()
time.sleep(1)
# 3、使用XPath定位(点击显示)
driver.find_element(AppiumBy.XPATH, "/hierarchy/android.widget.FrameLayout/android.view.ViewGroup/android.widget.FrameLayout[2]/android.widget.FrameLayout/android.widget.ScrollView/android.widget.LinearLayout/android.widget.LinearLayout[2]/android.view.ViewGroup/android.widget.FrameLayout[1]/android.widget.LinearLayout/android.widget.LinearLayout/android.widget.LinearLayout").click()
time.sleep(1)
# 4、使用Accessibility id定位(点击返回)
driver.find_element(AppiumBy.ACCESSIBILITY_ID, "向上导航").click()
time.sleep(1)
# 5、使用ID定位(点击搜索)
driver.find_element(AppiumBy.ID, "com.android.settings:id/search").click()
time.sleep(1)
# 6、使用CLSS_NAME定位,输入hello
driver.find_element(AppiumBy.CLASS_NAME, "android.widget.EditText").send_keys("hello")
time.sleep(3)
# 7、退出设置菜单
driver.terminate_app("com.android.settings")
# 使用Android uiautomator定位,属于appium的扩展定位方法,且只支持Android平台
# 8、text属性,匹配全部,识别到网易新闻,并点击
driver.find_element(AppiumBy.ANDROID_UIAUTOMATOR, 'new UiSelector().text("网易新闻")').click()
time.sleep(15)
# 9、text属性,匹配部分,识别到部分内容,并点击
driver.find_element(AppiumBy.ANDROID_UIAUTOMATOR, 'new UiSelector().textContains("登录")').click()
time.sleep(1)
# 10、text属性,匹配开头,识别开头文字,并点击
driver.find_element(AppiumBy.ANDROID_UIAUTOMATOR, 'new UiSelector().textStartsWith("我的钱")').click()
time.sleep(1)
# 11、content-desc属性,根据content-desc属性识别,点击返回
driver.find_element(AppiumBy.ANDROID_UIAUTOMATOR, 'new UiSelector().description("返回")').click()
time.sleep(1)
# 12、id属性,根据id属性识别,点击返回首页
driver.find_element(AppiumBy.ANDROID_UIAUTOMATOR, 'new UiSelector().resourceId("com.netease.newsreader.activity:id/lb")').click()
time.sleep(1)
# 13、class属性,根据class属性识别,点击输入框
driver.find_element(AppiumBy.ANDROID_UIAUTOMATOR, 'new UiSelector().className("android.widget.TextView")').click()
time.sleep(1)
# 14、class属性,(.TextView)元素不能用于输入,(.EditText)元素才能定位后输入,根据class属性识别,进入输入框输入模式,输入hello world!
driver.find_element(AppiumBy.ANDROID_UIAUTOMATOR, 'new UiSelector().className("android.widget.EditText")').send_keys("hello world!")
time.sleep(5)
# 15、退出网易新闻
driver.terminate_app("com.netease.newsreader.activity")
脚本运行效果视频如下所示:
脚本运行效果
至此,关于使用appium的简单介绍就到这里了,师傅领进门,修行看个人,结合实际,把技术灵活运用才是王道。冲鸭,社畜们,无聊的生活可太需要知识的调和了。