以下内容来自：Appium API Documentation
创建Session，得到self.driver，后面跟设备交互都调用driver的方法
desired_caps = desired_caps = {
'platformName': 'Android',
'platformVersion': '7.0',
'deviceName': 'Android Emulator',
'automationName': 'UiAutomator2',
'app': PATH('/path/to/app.apk'),
'noReset': True,
'fullReset': False
}
self.driver = webdriver.Remote('http://127.0.0.1:4723/wd/hub', desired_caps)
更启动参数及参数说明： Appium Desired Capabilities.
结束Session
self.driver.quit()
页面相关
# 模拟返回键
self.driver.back()
# 获取横竖屏
orientation = self.driver.orientation()
# 设置横竖屏
driver.orientation = "LANDSCAPE"
# 启动某个Android 页面
self.driver.start_activity("com.example", "ActivityName");
# 获取当前 Activity
activity = self.driver.current_activity()
# 获取当前包名称
package = self.driver.current_package()
App相关
# 安装APK
self.driver.install_app('/Users/johndoe/path/to/app.apk')
# 卸载APP
self.driver.remove_app('com.example.AppName')
# 判断APP是否安装
self.driver.is_app_installed('com.example.AppName')
# 启动APP
self.driver.launch_app()
# 关闭APP
self.driver.close_app()
# 重置APP，清空APP数据
self.driver.reset()
# 在后台运行
self.driver.background_app(10)
页面元素操作
# 在当前页面查找元素
el = self.driver.find_element_by_accessibility_id('elementID')
# 查找多个元素
el = self.driver.find_elements_by_accessibility_id('elementID')
# 点击某个元素
el = self.driver.find_element_by_accessibility_id('elementID')
el.click()
# 设置文本
el = self.driver.find_element_by_accessibility_id('elementID')
el.send_keys('Hello world!')
# 清空文本
el = self.driver.find_element_by_accessibility_id('elementID')
el.clear()
# 获取元素文本内容
el = self.driver.find_element_by_accessibility_id('elementID')
text = el.text
# 获取元素tag名称
el = self.driver.find_element_by_accessibility_id('elementID')
tagName = el.tag_name
# 获取元素的属性
el = self.driver.find_element_by_accessibility_id('elementID')
tagName = el.get_attribute('content-desc')
# 判断是否为选中状态
el = self.driver.find_element_by_accessibility_id('elementID')
el.is_selected()
# 判断是否为可用状态
el = self.driver.find_element_by_accessibility_id('elementID')
el.is_enabled()
# 判断是否显示
el = self.driver.find_element_by_accessibility_id('elementID')
el.is_displayed()
# 获取元素的位置
el = self.driver.find_element_by_accessibility_id('elementID')
x, y = el.location
# 获取元素的宽高
el = self.driver.find_element_by_accessibility_id('elementID')
width, height = el.size
事件相关
# 点击某个物理键
self.driver.press_keycode(10)
# 长按某个物理键
self.driver.long_press_keycode(10)
# 隐藏键盘
self.driver.hide_keyboard()
# 模拟鼠标点击
actions = ActionChains(driver)
actions.move_to_element(element)
actions.click()
actions.perform()
# 模拟按住
actions = ActionChains(driver)
actions.move_to_element(element)
actions.click_and_hold()
actions.perform()
# 模拟双击
actions = ActionChains(driver)
actions.move_to_element(element)
actions.double_click()
actions.perform()
# 模拟按下之后又松开
actions = ActionChains(driver)
actions.move_to_element(element)
actions.click_and_hold()
actions.move_to_element(element, 10, 10)
action.release();
actions.perform()
# 导入TouchAction
from appium.webdriver.common.touch_action import TouchAction
# 单击
actions = TouchAction(driver)
actions.tap(element)
actions.perform()
# 双击
actions = TouchAction(driver)
actions.double_tap(element)
actions.perform()
# 按住拖动
actions = TouchAction(driver)
actions.tap_and_hold(element)
actions.move(50, 50)
actions.perform()
# 手指按住屏幕
actions = TouchAction(driver)
actions.tap_and_hold(element)
actions.move(50, 50)
actions.perform()
# 手指按住屏幕，并放开
actions = TouchAction(driver)
actions.tap_and_hold(20, 20)
actions.release(50, 50)
actions.perform()
# 手指长按屏幕
actions = TouchAction(driver)
actions.long_press(element)
actions.perform()
# 滑动一段距离
actions = TouchAction(driver)
actions.scroll_from_element(element, 10, 100)
actions.scroll(10, 100)
actions.perform()
# 抛动
actions = TouchAction(driver)
actions.flick_element(element, 1, 10, 10)
actions.perform()
# 多点触控
a1 = TouchAction()
a1.press(10, 20)
a1.move_to(10, 200)
a1.release()
a2 = TouchAction()
a2.press(10, 10)
a2.move_to(10, 100)
a2.release()
ma = MultiAction(self.driver)
ma.add(a1, a2)
ma.perform()
# 模拟触摸事件
actions = TouchAction(driver)
actions.tap_and_hold(20, 20)
actions.move_to(10, 100)
actions.release()
actions.perform()
文件操作
self.driver.push_file('/path/to/device/foo.bar', 'QXJlIHlvdXIgYmVlcnMgb2theT8=');
file_base64 = self.driver.pull_file('/path/to/device/foo.bar')
folder_base64 = self.driver.pull_folder('/path/to/device/foo.bar')
屏幕录制
# 开启屏幕录制
self.driver.start_recording_screen()
# 结束屏幕录制
self.driver.stop_recording_screen()
# 屏幕截屏
screenshotBase64 = self.driver.get_screenshot_as_base64()
设备相关
# 震动手机
self.driver.shake()
# 锁屏幕，解锁
self.driver.lock()
self.driver.unlock()
# 获取设备时间
time = self.driver.device_time()
