应用性质描述语言接口

应用性质描述语言（PDL）是Kea与被测试应用交互的方式，用户可通过接口的调用来实现与被测移动应用的交互。

用户界面交互事件

备注

目前，kea的性质描述语言底层通过 uiautomator2 作为交互工具，来进行与移动设备的交互。

例如，要向应用程序发送点击事件，你可以使用以下代码：

d(resourceId="player_playback_button").click()

d 是 uiautomator2 的驱动。

resourceId 设置组件的编号，用于选择器定位组件。

click() 表示向该组件发送点击事件。

下面是一些常用的交互事件:

  • click

    d(text="OK").click()

  • long_click

    d(text="OK").long_click()

  • edit text

    d(text="OK").set_text("text")

  • rotate device

    d.rotate("l") # or left
d.rotate("r") # or right

  • press [key]

    d.press("home")
d.press("back")

在定位组件时，可以使用以下选择器。

选择器

选择器用于在用户界面中识别特定的组件，其支持以下参数：

  • text, textContains, textMatches, textStartsWith

  • className, classNameMatches

  • description, descriptionContains, descriptionMatches, descriptionStartsWith

  • checkable, checked, clickable, longClickable

  • scrollable, enabled, focusable, focused, selected

  • packageName, packageNameMatches

  • resourceId, resourceIdMatches

  • index, instance

样例

# 选择text值为 "More Options" 的控件并点击它。
d(text='More Options').click()

# 在一个选择器中使用多个参数。
# 选择具有text值为 "Clock" 和类名为 "android.widget.TextView" 的控件并点击它。
d(text='Clock', className='android.widget.TextView').long_click()

# 选择具有资源编号为 "com.example/input_box" 的控件，并将其文本值设置为 "Hello world"。
d(resourceId="com.example/input_box").set_text("Hello world")