import time

// 由于是对app自动化,所以driver一定是来自appium框架,不是来自selenium框架(web自动化)
from appium import webdriver

# server 启动参数
desired_caps = {}
# 设备信息
desired_caps[‘platformName‘] = ‘Android‘
desired_caps[‘platformVersion‘] = ‘4.4.4‘
desired_caps[‘deviceName‘] = ‘192.168.56.101:5555‘
# app的信息
desired_caps[‘appPackage‘] = ‘com.android.settings‘
desired_caps[‘appActivity‘] = ‘.Settings‘

# 声明我们的driver对象
driver = webdriver.Remote(‘http://127.0.0.1:4723/wd/hub‘, desired_caps)

    ??从一个坐标位置滑动到另一个坐标位置,只能是两个点之间的滑动
    方法：swipe(start_x, start_y, end_x, end_y, duration=None)
    参数：
        1.start_x：起点X轴坐标
        2.start_y：起点Y轴坐标
        3.end_x：  终点X轴坐标
        4.end_y,： 终点Y轴坐标
        5.duration： 滑动这个操作一共持续的时间长度，单位：ms

业务场景：
    1.进入设置
    2.从坐标(50,1583)滑动到坐标(50,463)  //从底部向上滑动

import time

from appium import webdriver

# server 启动参数
desired_caps = {}
# 设备信息
desired_caps[‘platformName‘] = ‘Android‘
desired_caps[‘platformVersion‘] = ‘4.4.4‘
desired_caps[‘deviceName‘] = ‘192.168.56.101:5555‘
# app的信息
desired_caps[‘appPackage‘] = ‘com.android.settings‘
desired_caps[‘appActivity‘] = ‘.Settings‘

# 声明我们的driver对象
driver = webdriver.Remote(‘http://127.0.0.1:4723/wd/hub‘, desired_caps)

# 滑动
print(time.time())
# 用户滑到流量使用情况,滑动时间越长就越精准,可以理解为手机滑动的惯性导致
driver.swipe(50,1583,50,463,5000)
print(time.time())

"""
swipe通过driver使用的
传入起始的位置x和y 与 结束的位置x和y
时间参数越长滑动的越精准
默认的时间自己测试，大约是0.8左右（通过time.time()测试）
"""

    ?? 从一个元素滑动到另一个元素，直到页面自动停止
    方法：scroll(origin_el, destination_el)
    参数：
        1.origin_el：滑动开始的元素
        2.destination_el：滑动结束的元素

业务场景：
        1.进入设置页
        2.模拟手指从用户位置 到 电池位置的上滑操作

import time

from appium import webdriver

# server 启动参数
desired_caps = {}
# 设备信息
desired_caps[‘platformName‘] = ‘Android‘
desired_caps[‘platformVersion‘] = ‘4.4.4‘
desired_caps[‘deviceName‘] = ‘192.168.56.101:5555‘
# app的信息
desired_caps[‘appPackage‘] = ‘com.android.settings‘
desired_caps[‘appActivity‘] = ‘.Settings‘

# 声明我们的driver对象
driver = webdriver.Remote(‘http://127.0.0.1:4723/wd/hub‘, desired_caps)

# 从用户按钮滑动到声音按钮
user_btn=driver.find_element_by_xpath("//*[contains(@text,‘用户‘)]")
sound_btn=driver.find_element_by_xpath("//*[contains(@text,‘声音‘)]")
battery_btn=driver.find_element_by_xpath("//*[contains(@text,‘电池‘)]")
driver.scroll(user_btn,battery_btn)

# 和swipe相比都存在一定的惯性,不过参数不同,一个是坐标,一个是元素

    ?? 从一个元素滑动到另一个元素,第一个元素替代第二个元素原本屏幕上的位置
    方法：drag_and_drop(origin_el, destination_el)
    参数：
        1.origin_el：滑动开始的元素
        2.destination_el：滑动结束的元素

业务场景：
        1.进入设置页
        2.模拟手指从用户按钮滑动到声音按钮的上滑操作

import time

from appium import webdriver

# server 启动参数
desired_caps = {}
# 设备信息
desired_caps[‘platformName‘] = ‘Android‘
desired_caps[‘platformVersion‘] = ‘4.4.4‘
desired_caps[‘deviceName‘] = ‘192.168.56.101:5555‘
# app的信息
desired_caps[‘appPackage‘] = ‘com.android.settings‘
desired_caps[‘appActivity‘] = ‘.Settings‘

# 声明我们的driver对象
driver = webdriver.Remote(‘http://127.0.0.1:4723/wd/hub‘, desired_caps)

# 从用户按钮滑动到声音按钮
user_btn=driver.find_element_by_xpath("//*[contains(@text,‘用户‘)]")
sound_btn=driver.find_element_by_xpath("//*[contains(@text,‘声音‘)]")
driver.drag_and_drop(user_btn,sound_btn)  #用户滑到声音

safe_btn=driver.find_element_by_xpath("//*[contains(@text,‘安全‘)]")
user_btn=driver.find_element_by_xpath("//*[contains(@text,‘用户‘)]")
driver.drag_and_drop(safe_btn,user_btn)  # 安全滑到用户,用户要重新获取,因为用户在电脑缓存的位置变了
# scroll和drag的区别,drag没有惯性
# 相同点:都是使用元素进行传参
# 和swipe相比,一个传的是元素drag,一个传的是坐标swipe
# 当swipe时间足够长的时候,和drag效果相同

"""
find_ele 如果找到了某个元素,会将具体位置缓存到系统中
find_ele 获取当前出现在屏幕页面的元素,如果元素没有出现在屏幕页面上,获取不到
只要不重新获取,就算已经跑出屏幕外,也会认为元素在之前缓存的位置
只要某个元素在屏幕中出现了一部分,find_ele也会正常找到
"""

需求：在手机设置界面，翻页查找关于手机选项

import time

from appium import webdriver

# server 启动参数
desired_caps = {}
# 设备信息
desired_caps[‘platformName‘] = ‘Android‘
desired_caps[‘platformVersion‘] = ‘4.4.4‘
desired_caps[‘deviceName‘] = ‘192.168.56.101:5555‘
# app的信息
desired_caps[‘appPackage‘] = ‘com.android.settings‘
desired_caps[‘appActivity‘] = ‘.Settings‘

# 声明我们的driver对象
driver = webdriver.Remote(‘http://127.0.0.1:4723/wd/hub‘, desired_caps)
while True:
    try:
        driver.find_element_by_xpath("//*[contains(@text,‘关于手机‘)]").click()
        break
    except Exception:
        # 翻页
        driver.swipe(50, 1607, 50, 341, 5000)
# 所有关于手机界面的文本框
eles = driver.find_elements_by_class_name("android.widget.TextView")
# for...else...语法，如果for循环正常结束，else中语句执行。如果是break的，则不执行。
for ele in eles:                   
    if ele.text == "4.4.4":
        print("有")
        break
else:
    print("没有")

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

模拟手指轻敲一下屏幕操作(可以用坐标来指定敲击屏幕上的点)
方法：tap(element=None, x=None, y=None)
方法：perform() # 发送命令到服务器执行操作
参数：
        1.element：被定位到的元素
        2.x：相对于元素左上角的坐标，通常会使用元素的X轴坐标
        3.y：通常会使用元素的Y轴坐标

业务场景：
        1.进入设置
        2.点击显示选项

import time

from appium import webdriver

# server 启动参数
from appium.webdriver.common.touch_action import TouchAction

desired_caps = {}
# 设备信息
desired_caps[‘platformName‘] = ‘Android‘
desired_caps[‘platformVersion‘] = ‘4.4.4‘
desired_caps[‘deviceName‘] = ‘192.168.56.101:5555‘
# app的信息
desired_caps[‘appPackage‘] = ‘com.android.settings‘
desired_caps[‘appActivity‘] = ‘.Settings‘

# 声明我们的driver对象
driver = webdriver.Remote(‘http://127.0.0.1:4723/wd/hub‘, desired_caps)
view_btn=driver.find_element_by_xpath("//*[contains(@text,‘显示‘)]")
# 轻敲
# 只传入元素就会点击元素
# TouchAction(driver).tap(view_btn).perform()

# 只传入坐标,会点击以屏幕左上角为原点 点击
#TouchAction(driver).tap(x=174,y=1034).perform()

# 元素和坐标都传以元素为准
TouchAction(driver).tap(view_btn,x=174,y=1034).perform()

模拟手指按下屏幕,按就要对应着离开.

方法:press(el=None, x=None, y=None)
方法:release() # 结束动作，手指离开屏幕
    参数：
        1.element：被定位到的元素
        2.x：通常会使用元素的X轴坐标
        3.y：通常会使用元素的Y轴坐标

业务场景:
        1.进入设置
        2.点击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()

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

业务场景:
        进入Gestures Builder软件
        按住屏幕一段时间，接着抬起(会发现左下角Done按钮，由按下的灰色，到抬起变为黑色)

import time
from appium import webdriver
from appium.webdriver.common.touch_action import TouchAction

# server 启动参数

desired_caps = {}
# 设备信息
desired_caps[‘platformName‘] = ‘Android‘
desired_caps[‘platformVersion‘] = ‘4.4.4‘
desired_caps[‘deviceName‘] = ‘192.168.56.101:5555‘
# app的信息
desired_caps[‘appPackage‘] = ‘com.android.gesture.builder‘
desired_caps[‘appActivity‘] = ‘.CreateGestureActivity‘

# 声明我们的driver对象
driver = webdriver.Remote(‘http://127.0.0.1:4723/wd/hub‘, desired_caps)
time.sleep(30)   # 软件可能有些卡顿，等一下软件启动
TouchAction(driver).press(x=1000,y=1000).wait(5000).release().perform()

模拟手机按下屏幕一段时间,按就要对应着离开.

方法：long_press(el=None, x=None, y=None, duration=1000)
参数：
        1.element：被定位到的元素
        2.x：通常会使用元素的X轴坐标
        3.y：通常会使用元素的Y轴坐标
        4.duration：持续时间，默认为1000ms

业务场景:
        1.进入设置
        2.点击WLAN选项
        3.长按WiredSSID选项5秒

import time
from appium import webdriver
from appium.webdriver.common.touch_action import TouchAction

# server 启动参数

desired_caps = {}
# 设备信息
desired_caps[‘platformName‘] = ‘Android‘
desired_caps[‘platformVersion‘] = ‘4.4.4‘
desired_caps[‘deviceName‘] = ‘192.168.56.101:5555‘
# app的信息
desired_caps[‘appPackage‘] = ‘com.android.settings‘
desired_caps[‘appActivity‘] = ‘.Settings‘

# 声明我们的driver对象
driver = webdriver.Remote(‘http://127.0.0.1:4723/wd/hub‘, desired_caps)
# 获取无线按钮
WLAN_Btn=driver.find_element_by_xpath("//*[contains(@text,‘WLAN‘)]")
WLAN_Btn.click()
TouchAction(driver).long_press(x=48,y=219,duration=5000).release().perform()

模拟手机的滑动操作
    方法：move_to(el=None, x=None, y=None)
    参数:
        1.el:定位的元素
        2.x:相对于前一个元素的X轴偏移量
        3.y:相对于前一个元素的Y轴偏移量

业务场景：
        1.进入设置
        2.向上滑动屏幕

代码实现：
        # 定位到存储
        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()

    需求：
        1.进入设置
        2.向上滑动屏幕到可见"安全"选项
        3.进入到安全
        4.点击屏幕锁定方式
        5.点击图案
        6.绘制图案

import time
from appium import webdriver
from appium.webdriver.common.touch_action import TouchAction

# server 启动参数

desired_caps = {}
# 设备信息
desired_caps[‘platformName‘] = ‘Android‘
desired_caps[‘platformVersion‘] = ‘4.4.4‘
desired_caps[‘deviceName‘] = ‘192.168.56.101:5555‘
# app的信息
desired_caps[‘appPackage‘] = ‘com.android.settings‘
desired_caps[‘appActivity‘] = ‘.ChooseLockPattern‘  //直接进入到绘制密码锁界面

# 声明我们的driver对象
driver = webdriver.Remote(‘http://127.0.0.1:4723/wd/hub‘, desired_caps)

# 模拟手机解锁图案的绘制
# 注意：move_to()里面的x和y是相对偏移量,相对于之前按压坐标算的
TouchAction(driver)    .press(x=210,y=660)    .move_to(x=327,y=0)\   /*向右移动327元素*/
    .move_to(x=327,y=0)\  /*向右移动327元素*/
    .move_to(x=0,y=330)\  /*向下移动330元素*/
    .release()    .perform()
# 知道什么是链条
# 一堆动作 通过动作.动作.动作.动作.perform 这一串动作就是链条
# 关于代码过长的问题
# 两种方式(用哪种都 可以)
# - 直接在.之前回车,此时上一行末尾会有一个‘\’。‘\‘表示后面还有内容,并且是一行的
# - 在前后加 ‘()‘,再进行回车

针对手机的一些常用设置功能进行操作.

方法：device_time

代码实现：
        # 获取当前手机的时间
        print(driver.device_time)
    执行结果：
        Wed Dec 27 08:52:45 EST 2017

获取手机的宽高，可以根据宽高做一些坐标的操作

方法：get_window_size()

代码实现：
        print(driver.get_window_size())
    执行结果：
        {‘width‘: 1080, ‘height‘: 1920}

模拟系统键值的操作，比如操作home键，音量键,返回键等。

方法：keyevent(keycode, metastate=None):
方法：press_keycode(keycode, metastate=None):
参数：
    keycode：发送给设备的关键代码
    metastate：关于被发送的关键代码的元信息，一般为默认值

业务场景:
    1.打开设置
    2.对音量键进行操作

# 音量加
driver.keyevent(keycode=24)
time.sleep(5)
# 音量减
driver.keyevent(keycode=25)

打开手机的通知栏，可以获取通知栏的相关信息和元素操作

方法：open_notifications()

业务场景: 
    1.启动设置
    2.打开通知栏

# 打开通知栏
driver.open_notifications()

获取手机当前连接的网络

方法：network_connection

业务场景:
    获取手机当前网络模式

代码实现：
    print(driver.network_connection)
执行结果：
    6

设置手机网络

更改手机的网络模式，模拟特殊网络情况下的测试用例

方法：set_network_connection(connectionType)
参数：
    connectionType：需要被设置成为的网络类型

业务场景：
    1.启动设置
    2.设置手机网络为飞行模式

代码实现：
    driver.set_network_connection(1)
    or
    driver.set_network_connection(ConnectionType.AIRPLANE_MODE) # 通过常量模式设置

手机截图

截取手机当前屏幕，保存指定格式图片到设定位置

方法：get_screenshot_as_file(filename)
    参数：
    filename：指定路径下，指定格式的图片.

业务场景：
        1.打开设置页面
        2.截图当前页面保存到当前目录，命名为screen.png

# 手机截图
driver.get_screenshot_as_file(‘./设置.png‘)