在自动化脚本中如何高效设置文本，粘贴文本

在自动化脚本中，文本设置与粘贴是最基础也是最频繁的操作之一。无论是模拟用户搜索、填写表单，还是进行数据录入，都绕不开“把文字放到目标输入框”这个环节。然而，看似简单的任务，在实际的Android自动化开发中却常常成为“拦路虎”——因为并非所有目标控件都是标准的 EditText，有些界面甚至根本抓取不到任何标准Android控件。本文系统性地介绍三种覆盖不同场景的高效文本设置方案。

一、目标控件是 android.widget.EditText

最理想的场景是目标控件为标准的 EditText 或其子类。此时冰狐平台提供了最直接的 paste 函数，一行代码即可完成文本设置。

function main() {
    paste('cn:android.widget.EditText', '玩具', {type: 'set'});
}

上述代码中，第一个参数通过类名（cn 即 class name）定位到 EditText 控件，第二个参数为待设置的文本内容，第三个参数 {type: 'set'} 指定了设置模式。

需要特别注意的是，paste 函数仅对 EditText 及其子控件有效。如果调用后文本未能成功写入，可以尝试以下两种调试手段：

1. 将 type 参数改为 'paste'；

2. 在调用 paste 之前先用 click 点击选中该输入框，使其获得焦点。

这种方法效率最高、代码最简洁，适用于绝大多数标准的输入框场景。

二、目标控件不是 EditText

现实远比理想复杂。很多App的搜索框、输入区域并非标准 EditText，而是 View、TextView 或其他自定义Android控件。此时直接调用 paste 会失效。

冰狐平台提供的解决方案是：先将文本复制到系统剪贴板，再通过长按目标控件调出系统粘贴菜单，最后点击“粘贴”按钮完成输入。

function main() {
    // 把数据放到系统粘贴板
    setClipboardData('水果');

    // 长按目标控件，弹出粘贴菜单
    // 这里假设目标控件的文本为“搜索我的订单”，实际使用时请替换为真实标识
    click('txt:搜索我的订单', {isLongClick: true, afterWait: 1000});

    // 点击“粘贴”按钮，注意 root 参数必须填 'txt:粘贴'
    // 因为粘贴按钮与当前界面通常不在同一个窗口
    click('txt:粘贴', {root: 'txt:粘贴'});
}

这段代码的关键点在于：

• setClipboardData 将目标文本写入系统剪贴板；

• click 配合 {isLongClick: true} 实现长按操作，触发系统粘贴菜单；

• 点击“粘贴”按钮时，必须指定 root: 'txt:粘贴'，因为粘贴按钮弹窗与当前界面通常不属于同一个窗口上下文。

如果长按后没有弹出粘贴菜单，可以先对目标控件执行一次普通点击（使其获得焦点），再进行长按。

三、目标界面是完全自绘制的自定义界面

最棘手的情况是：目标界面完全由开发者自绘制，没有使用任何标准Android控件。此时冰狐的UI树抓取不到任何有效节点，前两种方法全部失效。

冰狐平台针对这种极端场景提供了基于 OCR 识别的解决方案。核心思路是：先用 OCR 找到目标控件在屏幕上的位置，然后模拟长按弹出粘贴菜单，最后点击“粘贴”按钮。

function main() {
    // 请求屏幕截图（OCR 需要基于当前屏幕图像）
    requestScreenShot();

    // 把待粘贴的文本放入系统剪贴板
    setClipboardData('水果');

    // 用 OCR 查找目标控件
    // 如果目标控件本身没有文本，可以查找其旁边的“搜索”按钮，再通过偏移定位
    var ret = ocrFindView('txt*:我的订单');
    if (ret.length > 0) {
        console.log('找到控件:', ret);

        // 计算控件中心点坐标，长按 800 毫秒弹出粘贴菜单
        gestureClick(
            parseInt(ret.region[0] + ret.region[2] / 2),
            parseInt(ret.region[1] + ret.region[3] / 2),
            {duration: 800, afterWait: 1000}
        );

        // 点击“粘贴”按钮完成输入
        click('txt:粘贴', {root: 'txt:粘贴', click: true});
    }
}

这段代码的流程拆解如下：

1. requestScreenShot()：获取当前屏幕截图，为 OCR 识别提供图像数据；

2. setClipboardData('水果')：将目标文本写入剪贴板；

3. ocrFindView('txt*:我的订单')：通过 OCR 在屏幕图像中查找包含“我的订单”文本的区域；

4. gestureClick：根据 OCR 返回的区域坐标计算中心点，执行 800 毫秒的长按操作；

5. click('txt:粘贴', {root:'txt:粘贴'})：点击弹出的“粘贴”按钮。

这里有一个非常实用的技巧：如果目标输入框本身没有任何文本可供 OCR 识别，可以查找其旁边的固定文字（如“搜索”按钮），然后通过坐标偏移来定位输入框位置。

四、三种方案的对比与选型建议

在实际项目中选择哪种方案，可以参考以下原则：

• 优先尝试 paste：代码最简洁、执行最快，适用于大多数标准输入框；

• paste 失效时改用剪贴板+长按方案：覆盖绝大多数非标准控件场景；

• UI树完全为空时启用 OCR 方案：虽然 OCR 有一定性能开销，但能解决最极端的问题。

五、常见问题与调试技巧

从论坛的讨论中可以看到，实际使用中还会遇到一些细节问题：

问题1：paste 设置后文本颜色为灰色，手动输入为黑色，点击搜索无效

这可能是因为某些 App 对 EditText 进行了特殊定制，paste 写入的文本未能触发控件的“文本改变”监听器。可以尝试先 click 点击输入框使其获得焦点，再调用 paste；如果仍然无效，建议切换到第二种方案（剪贴板+长按粘贴）。

问题2：手动输入才能弹出关联搜索建议，paste 无法触发

部分搜索框依赖输入法的事件回调来触发联想建议，而 paste 直接设置文本绕过了输入法。此时同样建议使用剪贴板+长按粘贴方案，因为这种方式更接近真实的手动输入行为。

问题3：长按后没有弹出“粘贴”按钮

可以先对目标控件执行一次普通点击（click），再执行长按操作。另外，不同 Android 版本和不同 App 的粘贴菜单样式可能不同，如果“粘贴”按钮的文本不是“粘贴”而是其他文字（如“Paste”），请相应调整 click 的定位文本。

六、总结

本文基于冰狐智能辅助平台的 API，系统性地介绍了三种覆盖不同场景的文本设置与粘贴方案：

1. 标准 EditText 控件：直接使用 paste 函数，一行代码搞定；

2. 非 EditText 的 Android 控件：通过 setClipboardData 写入剪贴板，长按控件弹出系统粘贴菜单，再点击“粘贴”按钮；

3. 完全自绘制的无控件界面：借助 requestScreenShot + ocrFindView 进行 OCR 定位，模拟长按和点击完成粘贴。

这三种方法基本覆盖了自动化脚本中可能遇到的所有文本输入场景。理解每种方案的适用边界和核心 API，能够帮助开发者在面对不同 App 时快速选择最合适的实现路径，从而写出更健壮、更高效的自动化脚本。