1、在脚本内启动其他程序

driver.start_activity(包名，界面名)

driver.start_activity('appPackage','appActivity')

2、将应用置于后台

进入后台3秒，然后再回到前台

driver.background_app(3)

3、关闭应用程序

关闭当前操作的应用程序，但不会关闭驱动对象

driver.close_app()

关闭驱动对象，同时，关闭所有关联的应用程序

driver.quit()

4、安装和卸载应用程序

安装应用程序

driver.install_app(path)

卸载应用程序

driver.remove_app(app_id)

判断是否安装应用程序，安装的话返回Ture，没有安装的话返回False

driver.is_app_installed(app_id)

5、获取元素的文本

text方法，返回文本

element.text

6、获取元素的位置和大小

location方法，返回键为x、y的字典

element.location

size方法，返回键为width，height的字典

element.size

7、获取定位元素的属性值

定位到元素后，获取属性值

element.get_attribute(value)

8、滑动、滚动和拖拽事件

• 方法名：swipe。滑动事件，从一个坐标滑动到另外一个坐标，只能在两点之前滑动。

#  start_x : 起点x坐标
#  start_y ：起点y坐标
#  end_x ：终点x坐标
#  end_y ：终点y坐标
#  duration=None ：滑动这个操作一个持续的时间长度，单位：ms
driver.swipe(start_x,start_y,end_x,end_y,duration=None)

注意：滑动的时候有误差，滑动持续时间越长误差越小，可以理解为惯性，滑动时间越短，惯性就越大。

• 方法名：scroll。滚动事件，从一个元素滑动到另外一个元素，知道页面自动停止。

#  origin_el ：开始元素
#  destination_el ：结束元素
driver.scroll(origin_el,destination_el)

注意：此方法不能设置滑动时间，惯性比较大

• 方法名：drag_and_drop。拖拽事件，从一个元素滑动到另外一个元素，但是注意是第二个元素位置替换第一个元素位置。

#  origin_el ：开始元素
#  destination_el ：结束元素
driver.drag_and_drop(origin_el,destination_el)

注意：此方法不能设置滑动时间，但无惯性。

• 三种方法的选择：

  场景	方法选择
  传入元素，且有惯性	scroll
  传入元素，无惯性	drag_and_drop
  传入坐标，有惯性	swipe，设置较短的滑动时间
  传入坐标，无惯性	swipe，设置较长的滑动时间

9、TouchAction操作

• 操作步骤：首先是找到要操作的元素，然后创建TouchAction对象，接着调用要执行的操作，最后用perform执行操作。

• 敲击操作，方法：tag（self, element=None, x=None, y=None, count=1），注意，元素和坐标选其一即可。

# element是找到要操作的元素
# x,y是坐标
# count是点击次数
tag（self, element=None, x=None, y=None, count=1）

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

#找到要操作的元素
setting_bnt = driver.find_element_by_id('XXX')
#首先是创建TouchAction对象
touch_action = TouchAction(driver)
# 然后调用要执行的操作
touch_action = touch_action.tap(setting_bnt)
# 最后用perform执行操作
touch_action.perform()

代码优化后：

setting_bnt = driver.find_element_by_id('XXX')
touch_action = TouchAction(driver).tap(setting_bnt).perform()

• 按下操作：也就是模拟手指按下，方法为：press(self, el=None, x=None, y=None,)

# el是找到要操作的元素
# x,y是坐标
# count是点击次数
press(self, el=None, x=None, y=None)

TouchAction(driver).press(self, el=None, x=None, y=None, pressure=None).perform()

• 抬起操作：也就是模拟手指按下后手指再抬起操作，若按下的时间比较短，其实和敲击tap是一样的效果。方法为：release()

TouchAction(driver).press(self, el=None, x=None, y=None, pressure=None).release().perform()

• 等待操作：模拟手指按下后等待操作。方法：wait(ms=0)。

#默认为0毫秒
wait(ms=0)

TouchAction(driver).press('XXX').wait(2000).release().perform()

• 长按操作：模拟手指长按元素的操作。方法：long_press(self, el=None, x=None, y=None, duration=1000)

# el是找到要操作的元素
# x,y是坐标
# duration是长按时间
long_press(self, el=None, x=None, y=None, duration=1000)

TouchAction(driver).long_press('XXX'，duration=2000).perform()

其实等价于press的如下操作，而long_press相当于自带了抬手操作

TouchAction(driver).press('XXX').wait(2000).release().perform()

• 移动操作：模拟手机在手机屏幕上移动，方法：move_to(self, el=None, x=None, y=None)

# el是找到要操作的元素
# x,y是坐标
move_to(self, el=None, x=None, y=None)

TouchAction(driver).move_to(x=100,y=250).perform()

注意：移动到目标位置有时是算绝对路径，有时是基于前面一个坐标点的偏移量，这要根据具体的app来进行选择。

示例：

from appium import webdriver
from appium.webdriver.common.touch_action import TouchAction
from selenium.webdriver.support.wait import WebDriverWait
import time

#启动参数
desired_caps = {}
desired_caps['platformName'] = 'Android'
desired_caps['platformVersion'] = '5'
desired_caps['deviceName'] = 'Android Emulator'
# 包名
desired_caps['appPackage'] = 'com.android.settings'
# 界面名或者启动名
desired_caps['appActivity'] = '.Settings'

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

#定位
def get_element(loca):
    return WebDriverWait(driver,5,0.5).until(lambda x:x.find_element_by_xpath(loca))

#move_to滑动
TouchAction(driver).press(x=182,y=624).move_to(x=539,y=624).move_to(x=539,y=983).perform()

time.sleep(2)
driver.quit()

10、截图操作

模拟人在操作手机进行截图，在进行自动化测试的时候可以对出现bug的页面进行截图，帮助定位和分析bug。

方法：get_screenshot_as_file(self, filename)

driver.get_screenshot_as_file('test.png')

11、获取手机分辨率

在测试的时候，一般手机的机型特别多，而且手机分辨率也各式各样，为了用普世的方法去精确定位元素在屏幕上的位置，一般需要获取屏幕的分辨率并进行计算，便于得到点击或者滑动的坐标。

方法：get_window_size(self, windowHandle='current')

driver.get_window_size()

12、获取和设置手机网络状态

• 获取手机网络：获取当前手机网络所处于哪一种网络设置。方法：network_connection

获取手机网络值所代表的意思（connection_type）：

driver.network_connection

• 设置网络：设置当前手机的网络环境。方法：set_network_connection(self, connection_type)

driver.set_network_connection(6)

注意：一般情况下，程序在进行判断当前手机网络时，并不是用数字，因为数字可读性太差，不便于阅读，而是使用系统提高的可读性较好的方法进行处理。具体如下：

from appium.webdriver.connectiontype import ConnectionType

class ConnectionType(object):
    NO_CONNECTION = 0
    AIRPLANE_MODE = 1
    WIFI_ONLY = 2
    DATA_ONLY = 4
    ALL_NETWORK_ON = 6

13、发送键到设备

模拟人操作手机按键，比如调整音调大小，或者双击返回键等等。

方法：press_keycode( keycode, metastate=None, flags=None)

#keycode (int): the keycode to be sent to the device 发送给设备的关键代码
#metastate (:obj:`int`, optional): meta information about the keycode being sent 关于被发送关键代码的元信息，一般为默认，可以不填。
#flags (:obj:`int`, optional): the set of key event flags

press_keycode(keycode, metastate=None, flags=None)

使用：

driver.press_keycode(4)

14、开启和关闭通知栏

• 开启通知栏，方法：open_notifications()

driver.open_notifications()

• 关闭通知栏，方法其实和人操作手机一样，一般就是向上滑动通知栏，或者是按返回键

driver.press_keycode(4)

15、发送文件到手机

通过push_file方法，可以将文件发送至手机

driver.push_file(path,data)

'''
path:文件路径
data:数据文件
'''

示例：

import base64

data1 = 'this is a test'

#base64编码
data = str(base64.b64encode(data.encode('utf-8')),'utf-8')
driver.push_file('/sdcard/123456.txt',data)

由于，输入的base64编码字符串必须符合base64的padding规则，否则程序会报padding错误。“当原数据长度不是3的整数倍时, 如果最后剩下两个输入数据，在编码结果后加1个“=”；如果最后剩下一个输入数据，编码结果后加2个“=”；如果没有剩下任何数据，就什么都不要加，这样才可以保证资料还原的正确性。”

import base64

def base64_handle(data):
    if (len(data) % 3 == 1):
        data += "=="
    elif (len(data) % 3 == 2):
        data += "="
        
    #base64编码
    data = str(base64.b64encode(data.encode('utf-8')),'utf-8')
    return data

data1 = 'this is a test'
data = base64_handle(data1)
driver.push_file('/sdcard/123456.txt',data)

16、从手机中拉取文件

通过pull_file方法，可以将文件发送至手机

pull_file(path)
'''
path:文件路径
'''

示例：

import base64

data = driver.pull_file(path)
#base64解码
data = str(base64.b64decode(data),'utf-8')
print(data)

注意，被拉取文件需要是相同的编码格式，否则打印出来的信息可能是乱码。

17、获取当前页面内的元素

driver.page_source