appium基础API

1.1 APP元素信息操作API

介绍手机端元素信息的获取以及基本的输入操作

• 前置代码

# 导入driver对象
from appium import webdriver

import time

# server 启动参数
desired_caps = {}
# 设备信息（系统、版本、设备号）
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '9'
desired_caps['deviceName'] = '192.168.72.103:5555'
# app信息（包名、启动名）
desired_caps['appPackage'] = 'com.android.settings'
desired_caps['appActivity'] = '.Settings'

# 声明driver对象
driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)

try:
    pass
except Exception as e:
    print(e)
finally:
    # 关闭驱动对象
    driver.quit()

1.1.1 点击元素

• 看前面的知识

  1.1.2 发送数据到输入框

  方法：value 需要发送到输入框内的文本
  send_keys(vaue)

eg(业务场景):

打开设置,点击搜索框并输入内容abc

# 点击搜索框
driver.find_element_by_id("com.android.settings:id/search_action_bar").click()
# 定位到输入框并输入abc
driver.find_element_by_id("android:id/search_src_text").send_keys("abc")

提示：

• 可以将输入的abc改成输入中文，得到的结果：
  输入框无任何值输入且程序不会报错

解决方法：

• server 启动参数增加两个参数配置
  desired_caps[‘unicodeKeyboard‘] = True
desired_caps[‘resetKeyboard‘] = True

再次运行，会发现运行成功

# 点击搜索按钮
driver.find_element_by_id("com.android.settings:id/search_action_bar").click()
# 定位到输入框并输入abc
driver.find_element_by_id("android:id/search_src_text").send_keys("哈哈")

1.1.3 清空输入框内容

方法：clear()

eg(业务场景):

打开设置,点击搜索框,输入内容abc,删除已输入abc

# 点击搜索按钮
driver.find_element_by_id("com.android.settings:id/search_action_bar").click()
# 定位到输入框并输入abc
input_text = driver.find_element_by_id("android:id/search_src_text")
# 输入abc
input_text.send_keys("abc")
time.sleep(1)
# 删除abc
input_text.clear()

eg(业务场景):

打开设置,点击搜索框,多次输入内容，有下拉提示认为成功

driver.find_element_by_id("com.android.settings:id/search_action_bar").click()
    for i in ("vp", "WLA", "ls"):
        input_text = driver.find_element_by_id("android:id/search_src_text")
        input_text.clear()
        input_text.send_keys(i)
        dropdown_data = driver.find_element_by_id("android:id/title").text
        if dropdown_data:
            print(True)
        else:
            print(False)
    driver.find_element_by_class_name("android.widget.ImageButton").click()

1.1.4 获取元素的文本内容

方法: text

eg(业务场景)：

进入设置，获取所有元素class属性为“android.widget.TextView”的文本内容

text_vlaue = driver.find_elements_by_class_name("android.widget.TextView")
    for i in text_vlaue:
        print(i.text)

1.1.5 获取元素的属性值

方法: value:元素的属性
get_attribute(value)

eg(业务场景)：

进入设置，获取搜索框的content-desc属性值

 # 定位到搜索框
get_value = driver.find_element_by_id("com.android.settings:id/search_action_bar")
print(get_value.get_attribute("name"))

打开计算器，获取pi的各种属性

注意：

• 更改前置代码的启动应用的包名和启动名为计算器的

ele_pi = driver.find_element_by_id("com.android.calculator2:id/const_pi")
    for i in ("name", "text", "className", "resourceId"):
        print(ele_pi.get_attribute(i))

1.1.6 获取元素在屏幕上的坐标

方法:location

ge(业务场景)：

进入设置页面,获取搜索框在屏幕的坐标位置

# 定位到搜索框
get_value = driver.find_element_by_id("com.android.settings:id/search_action_bar")
# 打印搜索框在屏幕上的坐标
print(get_value.location)

1.1.7 获取app包名和启动名

获取包名方法：current_package
获取启动名：current_activity

eg(业务场景)：

启动设置，获取包名和启动名

print("包名：", driver.current_package)
print("启动名：", driver.current_activity)

1.1.8 综合应用

• 添加联系人

 # 导入driver对象
from appium import webdriver
import time
import logging

# server 启动参数
desired_caps = {}
# 设备信息（系统、版本、设备号）
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '9'
desired_caps['deviceName'] = '192.168.72.103:5555'
# app信息（包名、启动名）
desired_caps['appPackage'] = 'com.android.contacts'
desired_caps['appActivity'] = '.activities.PeopleActivity'

# 声明driver对象
driver = webdriver.Remote('http://localhost:4723/wd/hub', desired_caps)

try:
    # pass
    driver.find_element_by_id("com.android.contacts:id/floating_action_button").click()

    driver.find_element_by_id("com.android.contacts:id/left_button").click()

    driver.find_element_by_xpath("//*[contains(@text,'姓氏')]").send_keys("张")
    driver.find_element_by_xpath("//*[contains(@text,'名字')]").send_keys("小红")
    driver.find_element_by_xpath("//*[contains(@text,'电话')]").send_keys("12345678910")

    driver.find_element_by_class_name("android.widget.Button").click()
except Exception as e:
    print(e)
finally:
    # 关闭驱动对象
    driver.quit()

1.2 APP元素事件操作API

1.2.1 swip滑动事件

从一个坐标位置滑动到另一个坐标位置,只能是两个点之间的滑动
方法：
swipe(start_x, start_y, end_x, end_y, duration=None)

eg(业务场景)：

进入设置,从坐标(148,659)滑动到坐标(148,248)

# 滑动没有持续时间
driver.swipe(148,659,148,248)
# 滑动持续5秒的时间
driver.swipe(148,659,148,248,5000)

1.2.2 scroll滑动事件

从一个元素滑动到另一个元素，直到页面自动停止
方法：
scroll(origin_el, destination_el)

eg(业务场景)：

进入设置页，模拟手指从存储菜单位置 到 网络菜单位置的上滑操作

# 定位到存储菜单栏
el1 = driver.find_element_by_xpath("//*[contains(@text,'存储')]")
# 定位到网络菜单栏
el2 = driver.find_element_by_xpath("//*[contains(@text,'网络')]")
# 执行滑动操作
driver.scroll(el1,el2)

1.2.3 drag拖拽事件

从一个元素滑动到另一个元素,第二个元素替代第一个元素原本屏幕上的位置
方法：
drag_and_drop(origin_el, destination_el)

eg(业务场景)：

进入设置页,模拟手指将存储菜单 滑动到网络菜单栏位置

# 定位到存储菜单栏
el1 = driver.find_element_by_xpath("//*[contains(@text,'存储')]")
# 定位到网络菜单栏
el2 = driver.find_element_by_xpath("//*[contains(@text,'网络')]")
# 执行滑动操作
driver.drag_and_drop(el1,el2)

1.2.4 应用置于后台事件

APP放置后台，模拟热启动
方法：
background_app(seconds)

eg(业务场景)：

进入设置页，将APP置于后台5s

driver.background_app(5)

效果：
app置于后台5s后，再次展示当前页面

1.3 APP模拟手势高级操作

• TouchAction是AppiumDriver的辅助类，主要针对手势操作，比如滑动、长按、拖动等
• 原理是将一系列的动作放在一个链条中发送到服务器，服务器接受到该链条后，解析各个动作，逐个执行
• 所有手势都要通过执行函数才会运行

1.3.1 手指轻敲操作

模拟手指轻敲一下屏幕操作
方法：tap(element=None, x=None, y=None)
参数|说明
-|-
element|被定位到的元素
x|相对于元素左上角的坐标，通常会使用元素的X轴坐标
y|通常会使用元素的Y轴坐标

方法：发送命令到服务器执行操作
perform()

eg(业务场景)：

进入设置，点击WLAN选项

el = driver.find_element_by_xpath("//*[contains(@text,'WLAN')]")
# 通过元素定位方式敲击屏幕
TouchAction(driver).tap(el).perform()
# 通过坐标方式敲击屏幕，WLAN坐标:x=155,y=250
TouchAction(driver).tap(x=155,y=250).perform()

1.3.2 手指按操作

模拟手指按下屏幕,按就要对应着离开
方法:press(el=None, x=None, y=None)
参数|说明
-|-
element|被定位到的元素
x|通常会使用元素的X轴坐标
y|通常会使用元素的Y轴坐标

方法：结束动作，手指离开屏幕
release()

eg(业务场景):

进入设置，点击WLAN选项

el = driver.find_element_by_xpath("//*[contains(@text,'WLAN')]")
# 通过元素定位方式按下屏幕
TouchAction(driver).press(el).release().perform()
# 通过坐标方式按下屏幕，WLAN坐标:x=155,y=250
# TouchAction(driver).tap(x=155,y=250).release().perform()

1.3.3 等待操作

方法：wait(ms=0)
参数：ms 暂停的毫秒数

eg(业务场景):

进入设置，点击WLAN选项，长按WiredSSID选项5秒

# 点击WLAN
driver.find_element_by_xpath("//*[contains(@text,'WLAN')]").click()
# 定位到WiredSSID
el =driver.find_element_by_id("android:id/title")
# 通过元素定位方式长按元素
TouchAction(driver).press(el).wait(5000).perform()
# 该方法未能完成长按操作，没有报任何错误
# TouchAction(driver).press(x=171,y=245).wait(5000).release().perform() 

1.3.4 手指长按操作

模拟手机按下屏幕一段时间,按就要对应着离开.
方法：
long_press(el=None, x=None, y=None, duration=1000)

eg(业务场景):

进入设置，点击WLAN选项，长按WiredSSID选项5秒

# 点击WLAN
driver.find_element_by_xpath("//*[contains(@text,'WLAN')]").click()
# 定位到WiredSSID
el =driver.find_element_by_id("android:id/title")
# 通过元素定位方式长按元素
TouchAction(driver).long_press(el,duration=5000).release().perform()
# 通过坐标方式长按元素，WLAN坐标:x=161,y=242
# 通过这个方法定位时报服务端错误，怀疑是appium1.7.1版本bug
# TouchAction(driver).long_press(x=161,y=242).perform() 

1.3.5 模拟手机的滑动操作

方法：
move_to(el=None, x=None, y=None)

eg(业务场景1)：

进入设置,向上滑动屏幕

# 定位到存储
el = driver.find_element_by_xpath("//*[contains(@text,'存储')]")
# 定位到更多
el1 = driver.find_element_by_xpath("//*[contains(@text,'更多')]")
# 元素方式滑动
TouchAction(driver).press(el).move_to(el1).release().perform()
# 坐标的方式滑动
# TouchAction(driver).press(x=240,y=600).wait(100).move_to(x=100,y=100).release().perform()

eg(业务场景2)：

进入设置，向上滑动屏幕到可见"安全"选项，进入到安全，点击屏幕锁定方式，点击图案，绘制图案

# 定位到WLAN
el1 = driver.find_element_by_xpath("//*[contains(@text,'WLAN')]")
# 定位到存储
el2 = driver.find_element_by_xpath("//*[contains(@text,'存储')]")
# 存储上滑到WLAN
driver.drag_and_drop(el2,el1)
# 定位到用户
el3 = driver.find_element_by_xpath("//*[contains(@text,'用户')]")
# 注意 这次使用drag_and_drop方法，传入的"存储定位"仍使用其原始在屏幕上的位置，所以是由存储滑动到用户才可以上滑，否则需要重新"定位存储"
# 存储上滑倒用户位置
driver.drag_and_drop(el2,el3)
# 点击安全按钮
driver.find_element_by_xpath("//*[contains(@text,'安全')]").click()
# 点击屏幕锁定方式按钮
driver.find_element_by_xpath("//*[contains(@text,'屏幕锁定')]").click()
# 点击图案按钮
# 绘制图案四个坐标 1:(80,256) 2:(240,256) 3:(240,418) 4:(400,418)
TouchAction(driver).press(x=80,y=256).wait(100).move_to(x=160,y=0).wait(100).move_to(x=0,y=162).wait(100).move_to(x=160,y=0).release().perform()

更新中......

移动端测试——APP元素信息[事件]操作API和APP模拟手势高级操作（4）