你可以使用 Hamibot 提供的控件查找方式，通过 text() 方法快速定位控件。下面是一个基本的示例脚本代码：

// 示例：跳转页面后使用 text 查找控件
var targetWidget = text("目标控件文本").findOne();
targetWidget.click(); // 或者执行其他操作，如 input(), longClick() 等

说明：

• text("目标控件文本") 会根据控件的文本属性进行匹配。
• findOne() 会一直等待直到找到符合条件的控件。
• 如果需要设置超时时间，可以使用 findOne(6000) 这样的方式，在指定毫秒内找不到则返回 null。

如果控件在新页面上加载可能需要一点时间，Hamibot 的 findOne() 默认会自动等待控件出现，无需手动添加延迟。但如果有必要确保页面已经完成跳转，可以添加一个短时间的延迟：

// 假设页面跳转需要一些时间，等待1秒
sleep(1000);

// 再查找控件
var targetWidget = text("目标控件文本").findOne();
if (targetWidget) {
    targetWidget.click();
} else {
    toast("未找到目标控件");
}

文档地址 https://docs.hamibot.com/

---

补充回答 1

如果你发现控件在页面跳转后需要较长时间才能加载完成，可以考虑以下几种优化方式来提升查找效率：

---

✅ 1. 使用 waitFor() 提前等待控件出现

waitFor() 方法会阻塞脚本执行，直到目标控件出现为止。它比手动加 sleep() 更智能，避免不必要的等待。

// 等待目标控件出现（不会超过默认超时时间）
text("目标按钮").waitFor();

// 控件出现后立即点击
text("目标按钮").findOne().click();

你也可以设置最大等待时间（单位：毫秒）：

text("目标按钮").waitFor(5000); // 最多等5秒

---

✅ 2. 结合 exists() 做判断，减少阻塞

如果你不希望脚本一直等待，可以用 exists() 主动检测控件是否存在，再决定下一步操作。

// 每隔200ms检查一次，最多检查5次
for (var i = 0; i < 5; i++) {
    if (text("目标按钮").exists()) {
        text("目标按钮").findOne().click();
        break;
    }
    sleep(200);
}

---

✅ 3. 使用 id 或 desc 替代 text（如果更稳定）

如果控件的 text 属性容易变化或加载慢，建议优先使用 id 或 desc（描述属性），它们通常加载更快、更稳定。

例如：

// 使用 id 定位
id("com.example:id/target_button").findOne().click();

// 使用 desc 定位
desc("提交").findOne().click();

---

✅ 4. 提高控件搜索效率的小技巧

• 组合多个条件：增加唯一性，提高定位准确率。

  text("提交").className("android.widget.Button").findOne().click();
  

• 使用 findOnce() 进行单次搜索（非阻塞）

  var widget = text("提交").findOnce();
  if (widget) {
      widget.click();
  } else {
      toast("未找到控件");
  }
  

---

✅ 总结推荐方案

// 推荐做法：使用 waitFor + findOne
text("提交").waitFor();
text("提交").findOne().click();

这样既能保证控件加载完成，又不会浪费等待时间，是目前最高效的方式之一。

文档地址 https://docs.hamibot.com/

---

补充回答 2

在 Hamibot 的控件操作中，exists() 和 waitFor() 是两个常用的方法，它们适用于不同的场景。以下是它们的对比和使用建议：

---

🔍 exists()

• 功能：判断当前屏幕上是否存在符合条件的控件。
• 行为：立即返回布尔值（true 或 false），不会阻塞脚本。
• 适用场景：
  • 控件可能出现也可能不出现时做判断。
  • 需要配合循环或条件分支进行逻辑控制。

if (text("确定").exists()) {
    text("确定").click();
}

---

🕐 waitFor()

• 功能：等待控件出现，直到满足条件为止。
• 行为：会阻塞脚本执行，直到找到控件或者超时。
• 优点：无需手动加延迟，适合确保某个控件一定加载完成后再继续操作。
• 示例：

text("下一步").waitFor(); // 等待该控件出现
text("下一步").findOne().click();

你可以指定最大等待时间（单位毫秒）：

text("提交").waitFor(3000); // 最多等3秒

---

⚡ 哪个更快更高效？

指标	exists()	waitFor()
是否阻塞	❌ 不阻塞	✅ 阻塞（直到控件出现或超时）
执行效率	更快（单次判断）	更慢（持续等待）
使用复杂度	需要配合循环/判断逻辑	简洁，一行代码即可
推荐使用情况	控件不一定出现、需要判断逻辑	控件一定会出现，且必须等待其加载

---

✅ 总结建议

• 如果你确定控件一定会出现，而且必须等待它加载完成再继续操作 → 使用 waitFor() 更简洁可靠。
• 如果你需要做判断逻辑（比如控件可能不存在、有多种路径），→ 使用 exists() 更灵活。

示例：结合使用提高效率

// 先等待控件出现（最多5秒）
if (text("确认").waitFor(5000)) {
    text("确认").click();
} else {
    toast("超时未找到控件");
}

这种方式既保证了控件出现，又避免了无限等待，是一种推荐做法。

文档地址 https://docs.hamibot.com/