三、appium基础API讲解和UIAutomatorViewer工具和元素操作API讲解

一. Appium 基础操作 API

前置参数讲解

# 导模块
from appium import webdriver
# 创建一个字典，包装相应的启动参数
desired_caps = dict()
# 需要连接的手机的平台(不限制大小写)
desired_caps['platformName'] = 'Android'
# 需要连接的手机的版本号(比如 5.2.1 的版本可以填写 5.2.1 或 5.2 或 5 ，以此类推)
desired_caps['platformVersion'] = '5.1'
# 需要连接的手机的设备号(andoird平台下，可以随便写，但是不能不写)
desired_caps['deviceName'] = '192.168.56.101:5555'
# 需要启动的程序的包名
desired_caps['appPackage'] = 'com.android.settings'
# 需要启动的程序的界面名
desired_caps['appActivity'] = '.Settings'
# 连接appium服务器
driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)
# 退出
driver.quit()

1.1 在脚本内启动其他 app
格式：

# 脚本内启动其他app
# 参数：
# appPackage：要打开的程序的包名
# appActivity：要打开的程序的界面名
driver.start_activity(appPackage, appActivity)

示例：

import time
from appium import webdriver
desired_caps = dict()
# 手机参数
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '5.1'
desired_caps['deviceName'] = '192.168.56.101:5555'
# 应用参数
desired_caps['appPackage'] = 'com.android.settings'
desired_caps['appActivity'] = '.Settings'
# 获取driver
driver = webdriver.Remote('http://localhost:4723/wd/hub',desired_caps)
time.sleep(3)
driver.start_activity('com.android.mms', '.ui.ConversationList')# 退出driver
time.sleep(20)
driver.quit()

1.2 获取 app 的包名和界面名
格式

# 获取包名
driver.current_package
# 获取界面名
driver.current_activity

示例

import time
from appium import webdriver
desired_caps = dict()
# 手机参数
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '5.1'
desired_caps['deviceName'] = '192.168.56.101:5555'
# 应用参数
desired_caps['appPackage'] = 'com.android.settings'
desired_caps['appActivity'] = '.Settings'
# 获取driver
driver = webdriver.Remote('http://localhost:4723/wd/hub',desired_caps)
time.sleep(3)
print(driver.current_package)
print(driver.current_activity)
driver.quit()

1.3 关闭 app 和 驱动对象
格式

# 关闭当前操作的app，不会关闭驱动对象
driver.close_app()
# 关闭驱动对象，同时关闭所有关联的app
driver.quit()

示例

from appium import webdriver
desired_caps = dict()
# 手机参数
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '5.1'
desired_caps['deviceName'] = '192.168.56.101:5555'
# 应用参数
desired_caps['appPackage'] = 'com.android.settings'
desired_caps['appActivity'] = '.Settings'
# 获取driver
driver = webdriver.Remote('http://localhost:4723/wd/hub',desired_caps)
# 关闭应用
driver.close_app()
# 退出driver
driver.quit()

结果：
使用 quit() 后会报错，使用close_app() 不会报错
小结：
close_app() 不会关闭驱动对象，只会关闭应用
quit() 会关闭驱动对象

1.4 安装和卸载以及是否安装 app
方法名

# 安装app
# 参数：
# app_path：apk路径
driver.install_app(app_path)

# 卸载app
# 参数：
# app_id：应用程序包名
driver.remove_app(app_id)

判断app是否已经安装
# 参数：
# app_id：应用程序包名
# 返回值：
# 布尔类型，True为安装，False为没有安装
driver.is_app_installed(app_id)

示例

import time
from appium import webdriver
desired_caps = dict()
# 手机参数
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '5.1'
desired_caps['deviceName'] = '192.168.56.101:5555'
# 应用参数
desired_caps['appPackage'] = 'com.android.settings'
desired_caps['appActivity'] = '.Settings'
# 获取driver
driver = webdriver.Remote('http://localhost:4723/wd/hub',desired_caps)
if driver.is_app_installed('cn.goapk.market'):
    driver.remove_app('cn.goapk.market')
else:
    driver.install_app(r'C:\Users\xuxu\Desktop\win\anzhishichang.apk')
driver.quit()

1.5 将应用置于后台
格式

# app放置到后台一定时间后再回到前台，模拟热启动
# 参数：
# seconds：后台停留多少秒
driver.background_app(seconds)

示例

import time
from appium import webdriver
desired_caps = dict()
# 手机参数
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '5.1'
desired_caps['deviceName'] = '192.168.56.101:5555'
# 应用参数
desired_caps['appPackage'] = 'com.android.settings'
desired_caps['appActivity'] = '.Settings'
# 获取driver
driver = webdriver.Remote('http://localhost:4723/wd/hub',desired_caps)
time.sleep(3)
driver.background_app(5)
time.sleep(5)
driver.quit()

二、 UIAutomatorViewer工具

简介
定位元素的时候必须根据元素的相关特征来进行定位，而 UIAutomatorViewer 就是用来获取元素特征的
示例

1. 打开 uiautomatorviewer
2. 打开 android 模拟器
3. 启动《设置》应用程序
4. 点击 Device Screenshot 按钮
5. 点击 ”放大镜“ 按钮
6. 查看 Node Detail 中的 ”resource-id“ 信息
   
   

注意点:

1. 自动打开的命令行窗口不要关
   如果关了，整个工具也会关闭
2. 打开uiautomatorviewer闪退
   解决方案：jdk版本问题造成的，jdk为1.9时可能会出现这个问题，请换成1.8的版本
3. 点击第二个按钮报错
   解决方案：
   adb kill-server
   adb start-server

三、元素定位操作 API

元素定位步骤

1. 打开 uiautomatorviewer 工具
2. 打开模拟器或真机
3. 通过 uiautomatorviewer 工具获取想要进行操作的元素的 Node Detail 信息
4. 通过元素定位 API 进行定位
5. 对元素进行相关操作

3.1 定位一个元素
方法名

# 通过id定位一个元素
# 参数：
# id_value：元素的resource-id属性值
# 返回值：
# 定位到的单个元素
driver.find_element_by_id(id_value)

# 通过class_name定位一个元素
# 参数：
# class_value：元素的class属性值
# 返回值：
# 定位到的单个元素
driver.find_element_by_class_name(class_value)

# 通过xpath定位一个元素
# 参数：
# xpath_value：定位元素的xpath表达式
# 返回值：
# 定位到的单个元素
driver.find_element_by_xpath(xpath_value)

示例

import time
from appium import webdriver
desired_caps = dict()
# 手机参数
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '5.1'
desired_caps['deviceName'] = '192.168.56.101:5555'
# 应用参数
desired_caps['appPackage'] = 'com.android.settings'
desired_caps['appActivity'] = '.Settings'
# 获取driver
driver = webdriver.Remote('http://localhost:4723/wd/hu