UIAutomator2的API文档

Posted 2022-06-03 sc912

1.UI对象识别器Selector

用法d(text=‘Clock‘, className=‘android.widget.TextView‘)

支持以下参数，详细信息可参考UiSelector Java doc

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

#点击: 设置→个性主题 ：

方法一：

d(description=‘设置‘, className=‘android.widget.ImageView‘).click()

d(text=‘个性主题‘, className=‘android.widget.TextView‘).click()

方法二：

d(resourceId="com.miui.home:id/icon_title", text="设置").click()

d.xpath(‘//*[@text="个性主题"]‘).click()

2.获取UI对象状态及信息

d(text="3D_H5").exists

d.exists(text="3D_H5")

d(text="3D_H5").info

#获取/设置/清空编辑框内容

d(description="请输入QQ号码或手机或邮箱").get_text()

d(description="请输入QQ号码或手机或邮箱").set_text("1234")

d(description="请输入QQ号码或手机或邮箱").clear_text()

#获取控件中心位置坐标

x,y=d(text="设置").center()

#x,y = d(text="设置").center(offset=(0, 0)) # left-top x, y

#执行点击事件在UI对象

d(text="设置").click(timeout=30)#最多延迟等待30秒，没找到会抛出.UiObjectNotFoundError

d(text="设置").click(offset=(0.5, 0.5)) #默认点击中心坐标

d(text="设置").click(offset=(0, 0)) #点击坐标 左-上

d(text="设置").click(offset=(1, 1)) #点击坐标 右-下