as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
Ring
AWS
文档
Support
Contact Us
My Cases
新手入门
设计和开发
应用发布
参考
支持
原生
Skip to main content
“Appium Vega驱动程序”支持以下万维网联盟 (W3C) WebDriver命令:**

find_element

find_elementfind_element命令可查找与指定选择器策略相匹配的第一个用户界面元素。
要XPath与 Appium Vega 驱动程序一起使用,你可以使用定位器策略。By.xpath()

参数

常见的XPath表达式组成部分

XPathXPath表达式包含以下组成部分:
  • 轴 - 指定搜索方向,例如后代轴、祖先轴和后续轴。
  • 节点测试 - 指定要选择的节点类型,例如element、attribute或text()。
  • 谓词 - 根据各种条件(例如属性值、位置或自定义函数)筛选所选节点。
以下示例演示了XPathXPath表达式的各个组成部分:

find_elements

find_elementsfind_elements命令可查找多个用户界面元素,支持各种定位器策略,并返回一个元素数组(即使为空,也会返回空数组)。使用此命令执行以下操作:
  • 遍历列表
  • 验证多个控件
为了获得最佳性能和可靠性,请采用特定的定位器策略和适当的超时设置。在复杂的用户界面场景中,使用分层XPathXPath等高级技术。

参数

find_element与find_elements的比较

要在父元素的上下文中找到子元素,请找到包含子元素的封闭元素。

click

clickclick命令可模拟单击特定元素中心点的操作。虽然有各种定位器策略可供选择,但单击元素ID是一种可靠且可维护的方法。

参数

clickclick命令会对之前找到的元素执行操作,因此不需要使用参数。

已知限制

在连接到视频采集卡而非真实电视或显示器的设备上,click()click() 命令可能会失败。自动化工具包和显示合成器之间的坐标转换可能导致触摸事件发生在不正确的坐标处。 解决方法:
  • 改用 D-pad 导航(setFocus+ 和 pressKeyCode``DPAD_CENTER)。element.click()

send_keys

send_keyssend_keys命令可模拟在元素中键入文本的操作,并且需要一个字符串参数。

参数

最佳实践:

  • 验证目标元素是否含有焦点并已准备好接收输入。
  • 在发送按键之前,请检查元素焦点。在发送按键之前,使用click()click() 等命令来选择元素。
  • 在发送按键的间隔时间添加短暂延迟,因为快速或同步输入可能会导致某些设备或应用出现问题。

get_attribute

get_attributeget_attribute命令可检索用户界面元素的指定属性的值。

参数

属性列表

get_element_text

get_element_textget_element_text - 检索用户界面元素的可见文本内容。它返回用户可见的文本,不包括任何隐藏的文本。

参数

get_element_text命令会对之前找到的元素执行操作,因此不需要使用参数。

最佳实践:

  • 在尝试获取其文本之前,请验证元素是否存在。
  • 适当处理潜在空文本返回。
  • 考虑断言中的文本格式和特殊字符。
  • 需要时使用适当的等待策略。

press_keycode

press_keycodepress_keycode命令可模拟按下设备上特定硬件按键的操作。请谨慎使用,因为它可能会影响应用状态和测试流程,并且仅接受数字键码(不接受十六进制代码)。

参数

tap

taptap命令可模拟点击屏幕上一组特定坐标的操作。此命令可以精确控制触摸交互,但应谨慎使用。

参数

最佳实践:

虽然taptap可提供细粒度控制,但为了确保测试的稳定性和可维护性,应优先考虑基于元素的交互。仅当基于元素的方法不可行时才使用。

is_enabled

is_enabledis_enabled命令检查用户界面元素的当前状态。如果已启用(交互),则返回truetrue;如果已禁用(非交互),则返回falsefalse。
启用的元素允许用户交互。但是,启用状态并不能保证交互性。元素可能以启用状态发挥作用,但缺乏可见性或存在其他交互障碍。要验证交互性,请与其他命令is_enabled结合使用,例如is_displayed。

参数

is_enabledis_enabled命令会对之前找到的元素执行操作,因此不会接受参数。

最佳实践:

  • 将is_enabledis_enabled用作全面元素状态检查中的一个环节。
  • 不要依赖is_enabled来确定元素的交互性。
  • 在检查元素状态之前实施等待策略。

is_displayed

is_displayedis_displayed命令用于检查用户界面元素在屏幕上是否可见。它返回true可见和false隐藏状态。
当元素出现在屏幕边界内时,会变得可见。

参数

is_displayed命令会对之前找到的元素执行操作,因此不会接受参数。

最佳实践:

  • 将is_displayedis_enabled用作全面元素状态检查中的一个环节。

implicitly_wait

implicitly_waitimplicitly_wait命令用于设置搜索不可用元素时的等待时间。虽然此命令增强了测试稳定性,但请谨慎使用。对于复杂的场景,implicitly_wait结合使用explicit waits以平衡可靠性和执行速度。
有关详细实现,请参阅设置隐式等待时间(仅提供英文版)。

参数

最佳实践:

  • implicitly_wait在测试开始时设置。
  • 如有必要,重置为合理的默认值(例如0毫秒)。

get_window_rect

get_window_rectget_window_rect命令可检索当前应用窗口相对于整体屏幕大小的大小和位置。 例如: Python
Java
其中:
  • xx - 窗口左侧坐标
  • yy - 窗口顶部坐标
  • widthwidth - 窗口的宽度
  • height-窗户的高度

参数

不需要任何参数。

最佳实践:

结合使用get_window_rectget_window_rect与其他命令,以创建稳健的测试脚本来处理不同的屏幕尺寸和布局。

get_page_source

get_page_sourceget_page_source命令检索应用的当前页面源,该源代表底层用户界面结构。 Python
Java

参数

该get_page_source命令不需要任何参数。

get_screenshot

get_screenshotget_screenshot命令以base64编码字符串的形式捕获当前应用状态。使用此命令时,需考虑用户隐私。不要捕获数字版权管理 (DRM) 内容。 Python
Java
有关方法的完整列表和示例,请参阅Appium文档(仅提供英文版)。

参数

此命令不需要任何参数。

install_app

该install_app命令会在设备上安装应用程序。VPKG文件路径必须在主机(Appium服务器)的文件系统上可用。在测试开始时,使用此命令来自动设置环境。 示例: Python:
Java:

参数

activate_app

activate_appactivate_app命令用于在设备上启动指定的应用或将其置于前台。此命令可用于测试应用切换场景,或在执行进一步测试操作之前确认特定应用处于活动状态。 示例: Python:
Java:

参数

最佳实践

要正确appId启动应用程序,请运行vpm list applications。

terminate_app

该terminate_app命令停止当前正在运行的应用程序。当测试应用在强制关闭期间的行为或建立测试案例之间的干净状态时,使用此命令。 示例:

参数

remove_app

该remove_app命令将应用程序从设备上卸载。 示例:

参数

execute_script

该execute_script命令运行 shell 命令或调用 API。jsonrpc 要在设备上执行shell命令,请执行以下操作。 appium_driver.execute_script("shell", "echo hello world") # 要调用Appium公共接口中未公开的jsonrpcjsonrpc API,请执行以下操作: appium_driver.execute_script("jsonrpc: getScreenContext", "")

push_file

push_filepush_file命令让您能够将文件直接传输到设备。必须以base64编码字符串形式提供文件内容。用例包括上传测试数据、配置文件或测试执行期间所需的任何其他文件。 Python:
Java:

参数

pull_file

该pull_file命令允许您直接从设备传输文件。该命令以base64编码字符串形式返回文件内容。用例包括下载测试结果、配置文件或测试执行期间及之后所需的任何其他文件。 Python:
Java:

参数

方向键导航

该execute_script函数通过发送 Linux 输入事件代码jsonrpc: injectInputKeyEvent method。此功能可让您的应用以编程方式模拟用户输入事件,以进行自动化和测试。 该函数在脚本中运行指定的命令和按键事件,从而在专为方向键输入而设计的应用中实现方向键导航。 该表列出了输入事件代码。 有关已定义键码的完整列表,请参阅输入事件代码(仅提供英文版)。输入事件代码参考有助于创建无障碍且实用的键盘体验。对特定键码的支持因设备类型和输入配置而异。测试针对非标准键盘布局或行为的键盘输入处理。 使用以下命令格式injectInputKeyEvent:
例如,使用以下命令进行向下导航。

最后修改于 2026年8月21日