锁定

锁定屏幕

# python
driver.lock(5)

将 app 置于后台

把当前应用放到后台去

# python
driver.background_app(5)

收起键盘

收起键盘

# python
driver.hide_keyboard()

启动 Activity

在当前应用中打开一个 activity 或者启动一个新应用并打开一个 activity 。 只能在 Android 上使用

# python
driver.start_activity(‘com.example.android.apis‘, ‘.Foo‘)

打开通知栏 (Notifications)

打开下拉通知栏 只能在 Android 上使用

# python
driver.open_notifications()

是否已经安装

检查应用是否已经安装

# python
driver.is_app_installed(‘com.example.android.apis‘)

安装应用

安装应用到设备中去

# python
driver.install_app(‘path/to/my.apk‘)

删除应用

从设备中删除一个应用

# python
driver.remove_app(‘com.example.android.apis‘)

摇晃 (Shake)

模拟设备摇晃

# python
driver.shake()

关闭应用

关闭应用

# python
driver.close_app();

启动 (Launch)

根据服务关键字 (desired capabilities) 启动会话 (session) 。请注意这必须在设定 autoLaunch=false 关键字时才能生效。这不是用于启动指定的 app/activities ————你可以使用 start_activity 做到这个效果————这是用来继续进行使用了 autoLaunch=false 关键字时的初始化 (Launch) 流程的。

# python
driver.launch_app()

重置 (Reset)

应用重置(相当于卸载重装应用)

# python
driver.reset()

可用上下文 (context)

列出所有的可用上下文

翻译备注：context可以理解为 可进入的窗口 。例如，对于原生应用，可用的context和默认context均为NATIVE_APP。详情可查看对混合应用进行自动化测试

# python
driver.contexts

当前上下文 (context)

列出当前上下文

# python
driver.current_context

切换到默认的上下文 (context)

将上下文切换到默认上下文

# python
driver.switch_to.context(None)

应用的字符串 (App Strings)

获取应用的字符串

# python
driver.app_strings

按键事件 (Key Event)

给设备发送一个按键事件

# python
driver.keyevent(176)

当前 Activity

获取当前 activity。只能在 Android 上使用

# python
driver.current_activity

触摸动作(TouchAction) / 多点触摸动作(MultiTouchAction)

生成触摸动作的接口。这部分文档很快将会补充更多的内容进来。

# python
action = TouchAction(driver)
action.press(element=el, x=10, y=10).release().perform()

滑动(Swipe)

模拟用户滑动

# python
driver.swipe(start=75, starty=500, endx=75, endy=0, duration=800)

捏 (Pinch)

捏屏幕 (双指往内移动来缩小屏幕)

# python
driver.pinch(element=el)

放大 (Zoom)

放大屏幕 (双指往外移动来放大屏幕)

# python
driver.zoom(element=el)

滑动到 (Scroll To)

滑动到某个元素。

# python
todo: python

拉出文件 (Pull File)

从设备中拉出文件

# python
driver.pull_file(‘Library/AddressBook/AddressBook.sqlitedb‘)

推送文件(Push file)

推送文件到设备中去

# python
data = "some data for the file"
path = "/data/local/tmp/file.txt"
driver.push_file(path, data.encode(‘base64‘))

设置

从这里你可以获取/设置 appium 的服务器设置。 想知道它如何工作，以及它支持哪些设置，请查看关于设置的文档

current_settings = driver.get_settings()
driver.update_settings({"someSetting": true})

Appium API（常用）