AutoX选择器API详解：10个实用技巧快速定位屏幕元素

AutoX选择器API详解：10个实用技巧快速定位屏幕元素

【免费下载链接】AutoXA UiAutomator on android, does not need root access(安卓平台上的JavaScript自动化工具)项目地址: https://gitcode.com/gh_mirrors/auto/AutoX

AutoX是一款强大的安卓平台JavaScript自动化工具，无需root权限即可实现屏幕元素定位与操作。其选择器API是实现自动化的核心，掌握这些技巧能让你精准高效地定位任何屏幕元素，轻松完成自动化脚本编写。

一、基础选择器：从简单开始精准定位

1. ID选择器：最直接的定位方式

ID选择器是最常用且高效的定位方式，通过控件的唯一标识符进行精准匹配。在AutoX中使用id()方法实现：

// 直接使用ID定位按钮 selector().id("btn_submit").click();

源码定义可见于autojs/src/main/java/com/stardust/autojs/core/accessibility/UiSelector.java，当ID不包含包名时，AutoX会自动补充当前应用包名，简化开发流程。

2. 文本选择器：按可见文字定位

通过控件显示的文本内容进行定位，适用于按钮、标签等有明确文字的元素：

// 定位文本为"确定"的按钮并点击 selector().text("确定").click();

对于动态变化的文本，可使用textContains()、textStartsWith()等方法进行模糊匹配，提高脚本的健壮性。

二、高级选择器：应对复杂场景的定位策略

3. 类名选择器：定位同类型控件

当需要定位同一类别的控件（如所有文本框、按钮）时，使用类名选择器：

// 获取所有输入框 let inputs = selector().className("android.widget.EditText").find();

通过classNameMatches()方法还支持正则表达式匹配，灵活应对不同格式的类名。

4. 描述符选择器：利用辅助信息定位

部分控件会提供描述信息（contentDescription），特别适用于图标类控件：

// 定位描述为"搜索"的图标 selector().desc("搜索").click();

5. 组合选择器：多条件精确定位

单一条件难以定位时，可组合多个条件实现精准匹配：

// 定位ID为"user_name"且文本包含"账号"的输入框 selector().id("user_name").textContains("账号").findOne();

三、定位技巧：提升效率的实战方法

6. 层级定位：应对复杂界面结构

通过父子关系定位深层嵌套的控件，使用child()、parent()等方法：

// 定位列表中的第三个子项 selector().id("list_view").child(2).click();

7. 等待机制：确保元素加载完成

使用untilFind()或findOne(timeout)方法等待元素出现，避免因界面未加载完成导致定位失败：

// 等待元素出现，最多等待5秒 let target = selector().text("登录成功").findOne(5000);

8. 正则匹配：灵活应对动态内容

对于文本、类名等存在变化的情况，使用正则表达式进行模糊匹配：

// 匹配所有以"btn_"开头的ID selector().idMatches(/btn_.*/).find();

四、实用场景：选择器API的实际应用

9. 游戏界面元素定位

在游戏自动化中，可通过组合条件定位特定元素：

// 定位游戏中的"召唤"按钮 selector().text("召唤").className("android.widget.Button").click();

10. 动态界面适配

对于天气应用等动态变化的界面，使用相对定位和模糊匹配：

// 定位温度显示控件 selector().textMatches(/\d+°/).findOne().text();

五、选择器API使用注意事项

1. 性能优化：复杂选择器会增加查找时间，建议优先使用ID等高效定位方式
2. 线程安全：避免在UI线程执行untilFind()等阻塞操作，源码中已做线程检查autojs/src/main/java/com/stardust/autojs/core/accessibility/UiSelector.java
3. 兼容性：不同应用可能使用不同的控件命名规范，需灵活调整选择策略

掌握这些选择器技巧后，你可以轻松应对各种复杂界面的元素定位需求。AutoX选择器API的强大功能，为安卓自动化脚本开发提供了坚实的基础，无论是日常任务自动化还是复杂的应用测试，都能游刃有余。

【免费下载链接】AutoXA UiAutomator on android, does not need root access(安卓平台上的JavaScript自动化工具)项目地址: https://gitcode.com/gh_mirrors/auto/AutoX