使用Appium+NodeJS点击安卓键盘搜索按钮失败求完整指南

问题描述 #

使用Appium结合NodeJS做自动化测试，在输入框完成文本输入后，尝试点击手机键盘上的搜索按钮，所有执行代码均未生效。怀疑问题与依赖项（如驱动）或webdriverio库有关，附测试代码：

const { remote } = require("webdriverio");

const capabilities = {
  "appium:platform": "Android",
  "appium:platformVersion": "11",
  "appium:automationName": "UiAutomator2",
  "appium:appPackage": "com.android.settings",
  "appium:appActivity": ".Settings",
  platformName: "Android",
  "appium:app":
    "/Users/ASUS/Downloads/MEmu Download/Showcaller-Caller-ID-Block-1.9.1(www.Farsroid.com).apk",
  "appium:deviceName": "Pixel 2 API 30",
  "appium:adv": "Pixel_2_API_30",
  "appium:autoGeneratePermissions": true,
  "appium:settings[ignoreUnimportantViews]": true,
};

const wdOpts = {
  hostname: process.env.APPIUM_HOST || "localhost",
  port: parseInt(process.env.APPIUM_PORT, 10) || 4723,
  logLevel: "info",
  capabilities,
};

async function runTest() {
  const driver = await remote(wdOpts);
  try {
    await driver.touchPerform([{ action: "tap", options: { x: 50, y: 50 } }]);

    await driver.touchAction({
        action: "tap",
        x: 50,
        y: 50,
      });
  } finally {
    await driver.pause(1000);
    await driver.deleteSession();
  }
}

runTest().catch(console.log);

补充信息：

• 模拟器界面显示带有搜索输入框与弹出键盘的场景
• Appium Inspector已捕获界面元素信息

一、先解决基础配置与依赖问题 #

1. 修复Capabilities冲突 #

你的配置中同时指定了系统设置的appPackage/appActivity和第三方应用的app路径，这会导致Appium启动应用混乱：

• 若要测试安装的第三方应用，删除appium:appPackage和appium:appActivity字段；
• 若要测试系统设置，删除appium:app字段。

2. 验证Appium与驱动兼容性 #

• 确保使用Appium v2.x版本，执行以下命令检查UiAutomator2驱动：

  # 查看已安装驱动
  appium driver list
  # 未安装则执行
  appium driver install uiautomator2
  # 更新驱动到最新版
  appium driver update uiautomator2
  

3. 匹配webdriverio版本 #

确保webdriverio v8.x与Appium v2.x兼容，检查并更新：

# 查看当前版本
npm list webdriverio
# 安装最新兼容版
npm install webdriverio@latest

二、点击键盘搜索按钮的有效实现方案 #

方案1：元素定位直接点击 #

通过Appium Inspector找到键盘搜索按钮的元素属性（如content-desc="搜索"或text="搜索"），直接定位点击：

async function runTest() {
  const driver = await remote(wdOpts);
  try {
    // 定位输入框并输入文本
    const searchInput = await driver.$('//*[@resource-id="com.your.app:id/search_edit_text"]');
    await searchInput.setValue("测试搜索内容");
    
    // 定位键盘搜索按钮并点击
    const keyboardSearchBtn = await driver.$('//*[@content-desc="搜索"]');
    await keyboardSearchBtn.click();
  } finally {
    await driver.pause(1000);
    await driver.deleteSession();
  }
}

方案2：模拟Android按键事件 #

Android键盘搜索键对应KeyCode为84，回车键（部分场景等效搜索）对应66，直接发送按键：

// 输入文本后执行
// webdriverio v7及以下
await driver.pressKeyCode(84);
// webdriverio v8改用actions
await driver.actions().sendKeys('\uE007').perform(); // 回车键，适配多数搜索场景

方案3：精准坐标点击 #

若元素定位失败，从Appium Inspector获取搜索按钮的真实坐标，使用touchAction点击：

await driver.touchAction({
  action: 'tap',
  x: 920, // 替换为Inspector中显示的x坐标
  y: 1780 // 替换为Inspector中显示的y坐标
});

注意：不要用代码中固定的50,50坐标，该位置并非搜索按钮区域。

三、调试排查技巧 #

• 开启详细日志：将wdOpts中的logLevel改为debug，查看执行过程中是否有元素定位失败、驱动报错等信息；
• 用Appium Inspector录制：直接在Inspector中模拟点击搜索按钮，生成对应代码后复制到脚本中验证；
• 确认权限：确保appium:autoGeneratePermissions: true已添加到Capabilities中，避免权限限制。

内容的提问来源于stack exchange，提问作者Mohammad Darbandi