WebdriverIO+Mocha安卓原生应用测试：$未定义且无法与元素交互

核心问题分析 #

你遇到的ReferenceError: $ is not defined错误，本质是没有通过WebdriverIO的客户端实例调用元素选择器方法。WebdriverIO的$（单元素选择器）和$$（多元素选择器）都是挂载在你创建的client对象上的，并非全局可用的函数。同时你的元素交互代码也存在写法问题，导致无法正常操作控件。

分步解决方法 #

1. 修正元素选择器与交互代码

修改你的android_app_test.js，确保所有WebdriverIO相关的操作都通过client实例调用，并且异步操作都加上await：

const webdriverio = require('webdriverio');
const androidOptions = require('../../../helpers/caps').androidOptions;
const assert = require('chai').assert;

androidOptions.capabilities.appPackage = "com.google.android.calculator"
androidOptions.capabilities.appActivity = "com.android.calculator2.Calculator"

describe('Android Calculator Automation', function () {
  let client;

  before(async function () {
    // 初始化客户端
    client = await webdriverio.remote(androidOptions);
  });

  after(async function () {
    // 销毁会话
    await client.deleteSession();
  });

  it('should interact with calculator elements', async function () {
    // 1. 通过client实例调用$选择器，await获取元素
    const digit2Elem = await client.$('#digit_2');
    
    // 2. 等待元素显示，注意要await异步方法
    await digit2Elem.waitForDisplayed({ timeout: 3000 });
    
    // 3. 直接调用元素实例的click方法，无需再通过client
    await digit2Elem.click();
  });
});

2. 关键修正点说明

• 把全局的$('#digit_2')改为client.$('#digit_2')：$是client的方法，必须通过实例调用
• 所有异步操作（waitForDisplayed、click）都添加await：确保代码按预期顺序执行
• 用元素实例的click()替代client.touchClick('digit_2')：touchClick是旧版API，且需要传入元素定位器而非ID字符串，新版更推荐直接调用元素的click()方法

3. 额外排查方向

如果修改后仍无法交互，建议检查以下几点：

• Appium服务状态：确保Appium服务已启动（执行appium命令），且设备连接正常（执行adb devices验证）
• 元素定位器正确性：用Appium Inspector抓取计算器的digit_2元素，确认其ID是否确实为digit_2
• WebdriverIO版本兼容性：确保你安装的WebdriverIO版本与Appium版本兼容（比如v7/v8版本API略有差异）
• 权限问题：测试设备是否允许Appium获取控件权限，部分安卓设备需要开启"无障碍"权限

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