Bot.js Pro实战：ADB自动化测试脚本自动生成与防无障碍检测

1. 项目概述与核心价值最近在搞移动端自动化测试的朋友估计都遇到过同一个头疼的问题脚本写起来太费劲维护起来更费劲而且稍微复杂一点的App动不动就给你来个“无障碍检测”脚本跑着跑着就卡住或者失效了。我自己在给一个电商App做自动化回归测试时就深受其苦。传统的基于坐标点击或者简单的控件查找在界面频繁迭代、控件属性动态变化的情况下脚本的健壮性简直不堪一击。后来我接触并深度使用了Bot.js Pro这个工具它宣称能实现ADB自动化测试脚本的自动生成并且能有效对抗App的无障碍检测机制。经过几个项目的实战我可以负责任地说这玩意儿确实把自动化测试的开发效率和稳定性提升到了一个新高度。简单来说Bot.js Pro 是一个运行在Node.js环境下的自动化测试框架。它的核心价值在于两点一是“所见即所得”的脚本录制与自动生成能力你只需要在电脑上操作一遍手机界面它就能自动生成可执行的JavaScript测试代码二是其内置的“防无障碍检测”策略能够绕过或模拟真实用户操作避免被App识别为自动化工具而触发防护机制。这对于测试那些对自动化操作敏感的应用如金融、社交、游戏类App至关重要。它解决的不仅仅是“怎么写脚本”的问题更是“怎么让脚本稳定运行”的难题。2. Bot.js Pro 核心原理与架构拆解要理解Bot.js Pro为何强大我们需要先拆解它的工作原理。它并不是一个简单的“录屏转代码”工具而是一个融合了计算机视觉、控件树分析和智能事件模拟的复合型框架。2.1 基于ADB与计算机视觉的双重驱动Bot.js Pro 的底层通信依赖于Android Debug Bridge (ADB)。这是与设备交互的基石用于执行点击、滑动、输入等基础命令以及获取屏幕截图。但仅靠ADB是远远不够的因为ADB提供的UI层次结构信息通过uiautomator dump获取在某些复杂或自定义控件场景下可能不完整或难以解析。因此Bot.js Pro 引入了计算机视觉CV作为辅助和增强手段。它的工作流程通常是这样的实时屏幕捕获通过ADB连续获取设备屏幕截图。特征识别与匹配在录制阶段它不仅记录ADB事件还会对操作前后的屏幕图像进行特征分析。当你点击一个按钮时它会记录下这个按钮在当前屏幕中的视觉特征如颜色、形状、周围文本的OCR结果。代码生成与融合生成的脚本中对于控件的定位会采用一种混合策略。优先尝试通过ADB获取的控件属性如resource-id,text,class进行定位。如果这些属性不稳定或为空则会回退到使用之前记录的视觉特征进行图像匹配定位。这大大提高了脚本在界面变化时的容错能力。2.2 “防无障碍检测”的几种实现策略这是Bot.js Pro 的杀手锏。很多App会检测AccessibilityService无障碍服务的使用或者监控输入的异常速度、轨迹从而判定当前为自动化操作并予以阻断。Bot.js Pro 主要通过以下几种方式应对模拟真实人类操作延迟纯粹的自动化工具点击间隔是毫秒级的且非常规律。Bot.js Pro 可以在操作之间注入随机延迟例如在100ms到500ms之间随机并模拟人类点击前轻微的“犹豫”和点击后自然的停留。非精确坐标与轨迹模拟它不会总是点击控件的绝对中心。相反它会在控件区域内随机选择一个点进行点击。对于滑动操作它会生成带有轻微弧度或速度变化的贝塞尔曲线轨迹而非两点间的直线匀速滑动。绕过标准无障碍事件某些检测手段会监听特定的无障碍事件流。Bot.js Pro 可以通过ADB的input命令直接模拟底层输入事件或者使用monkey命令的特定参数这些事件可能不会触发高层的无障碍事件监听。环境伪装它可以配合一些手段需要额外配置来隐藏自动化测试的相关特征例如使用特定的设备指纹、模拟真实的传感器数据等。注意所谓的“防检测”是一个持续对抗的过程。没有任何一种方法能保证100%不被检测。Bot.js Pro 提供的是多种策略的组合拳能有效应对大多数常规检测但对于安全级别极高的App如某些支付类应用可能需要更定制化的方案。2.3 脚本生成从录制到可维护代码Bot.js Pro 的录制器会捕获你所有的ADB操作和屏幕变化。生成代码时它不是简单记录坐标序列而是尝试理解你的操作意图并生成基于业务逻辑的代码块。例如你完成了一个登录操作点击账号输入框 - 输入文本 - 点击密码输入框 - 输入文本 - 点击登录按钮。 一个低级的录制器可能生成tap(200, 300); inputText(myUsername); tap(200, 400); inputText(myPassword); tap(200, 500);而Bot.js Pro 倾向于生成更结构化、更易读的代码async function login(username, password) { const accountInput await findElement({ text: 请输入账号/手机号 }); await accountInput.click(); await inputText(username); const pwdInput await findElement({ text: 请输入密码 }); await pwdInput.click(); await inputText(password); const loginBtn await findElement({ text: 登录 }); await loginBtn.click(); }这种生成方式使得脚本更像一个“测试用例”而不仅仅是“操作序列”后续的参数化、模块化、断言添加都变得非常容易。3. 环境搭建与快速上手理论讲得再多不如动手跑一遍。下面我带大家从零开始搭建一个可用的Bot.js Pro 自动化测试环境。3.1 基础环境准备你需要准备以下几样东西一台Windows/Mac/Linux电脑作为控制端。一部Android手机或模拟器作为测试设备。强烈建议使用真机模拟器在某些手势和传感器相关的测试上可能有问题。在电脑上安装Node.js版本建议在14以上。去Node.js官网下载安装即可。在电脑上配置ADB环境下载Android SDK Platform-Tools将其路径添加到系统的PATH环境变量中。连接手机后在命令行输入adb devices能看到设备号即表示成功。在手机上开启开发者选项和USB调试这个步骤是必须的不同手机开启方式略有不同一般是在“关于手机”里连续点击“版本号”7次。3.2 Bot.js Pro 安装与项目初始化环境准备好后我们开始安装Bot.js Pro。全局安装命令行工具推荐 打开终端或命令行执行以下命令。这会将botjs命令安装到全局方便在任何地方使用。npm install -g botjs-pro-cli安装完成后输入botjs --version检查是否安装成功。创建并初始化测试项目 找一个合适的目录新建一个文件夹作为你的测试项目然后进入该文件夹进行初始化。mkdir my-botjs-project cd my-botjs-project botjs init初始化命令会引导你完成基本配置并生成一个标准的项目结构通常包括scripts/: 存放自动生成的或手写的测试脚本。config/: 配置文件如设备配置、全局参数。resources/: 存放图片、数据文件等资源。botjs.config.js: 项目的主配置文件。连接设备并授权 用USB线连接手机和电脑确保adb devices能识别到设备。首次连接时手机会弹出“允许USB调试吗”的提示一定要点击“允许”。这是后续所有自动化操作的基础。3.3 录制你的第一个自动化脚本一切就绪我们来录制一个最简单的脚本打开手机上的“设置”应用。启动录制器 在项目根目录下运行botjs record此时Bot.js Pro 会启动一个本地服务并在浏览器中打开一个Web界面。这个界面就是你的录制控制台。开始录制 在Web界面中你应该能看到已连接设备的实时屏幕镜像。点击界面上的“开始录制”按钮。 然后在你的手机屏幕上手动执行你想要自动化的操作。例如从桌面找到“设置”图标点击打开。 操作完成后回到Web界面点击“停止录制”。生成与查看代码 停止录制后Bot.js Pro 会分析录制数据并在scripts/目录下生成一个JavaScript文件例如open_settings.js。 打开这个文件你会看到类似下面的代码const { bot } require(botjs-pro); (async () { await bot.connectDevice(你的设备ID); // 自动填入的设备号 // 操作点击“设置”应用图标 // 策略优先通过文本匹配失败则使用图像匹配 const settingsApp await bot.findElement({ text: 设置, fallback: { image: ./resources/settings_icon.png } }); if (settingsApp) { await settingsApp.click({ humanLike: true }); // humanLike参数启用防检测模拟 await bot.delay(1000); // 操作后等待1秒 } else { throw new Error(未找到设置应用); } console.log(设置应用已打开); await bot.disconnect(); })();看它不仅仅记录了点击坐标而是尝试用text属性去定位并准备了图像回退方案。humanLike: true参数意味着这次点击会带有随机延迟和偏移模拟真人操作。4. 脚本开发进阶从录制到编程录制生成代码是快速入门的好方法但要构建健壮、可复用的测试套件我们必须深入理解并手动编写、优化脚本。4.1 核心API与元素定位策略Bot.js Pro 提供了丰富的API核心对象通常是bot。设备连接与管理// 连接指定设备 await bot.connectDevice(emulator-5554); // 连接默认设备列表中第一个 await bot.connectDevice(); // 断开连接 await bot.disconnect();元素定位Finders这是脚本稳定性的关键。Bot.js Pro 支持多种定位器推荐按以下优先级使用resourceId最稳定如果开发给了唯一的id。await bot.findElement({ resourceId: com.example.app:id/login_button });text对于有明确文本的控件很有效。await bot.findElement({ text: 登录 }); // 支持模糊匹配 await bot.findElement({ textContains: 账号 });className结合其他属性使用如android.widget.Button。组合定位同时使用多个属性提高精度。await bot.findElement({ className: android.widget.EditText, textContains: 手机号 });图像匹配Image当上述属性都失效时的终极武器。需要事先截取目标区域的图片作为模板。const element await bot.findElement({ image: ./resources/submit_btn.png, threshold: 0.8 // 匹配相似度阈值0-1之间 });实操心得不要过度依赖图像匹配它虽然强大但受屏幕分辨率、主题、亮度影响大且执行速度较慢。应作为属性定位失败后的保底方案。在录制时Bot.js Pro 自动保存的截图资源就用于此。元素操作const btn await bot.findElement({ text: 确定 }); // 点击 await btn.click({ humanLike: true, offsetX: 5, offsetY: 5 }); // 在控件内随机偏移(5,5)像素点击 // 长按 await btn.longPress(2000); // 长按2秒 // 输入文本会先清空原有内容 await btn.inputText(Hello World); // 获取属性 const text await btn.getText(); const bounds await btn.getBounds(); // 获取控件坐标 {x, y, width, height}手势与全局操作// 滑动 await bot.swipe(startX, startY, endX, endY, duration); // duration单位ms控制滑动速度 // 更自然的滑动 await bot.swipeHuman(startX, startY, endX, endY); // 带随机曲线和速度变化 // 按键事件 await bot.pressKey(home); // 返回桌面 await bot.pressKey(back); // 返回键 // 等待 await bot.delay(1500); // 固定等待1.5秒 await bot.waitForElement({ text: 加载完成 }, 10000); // 最多等待10秒直到元素出现4.2 编写结构化测试用例一个良好的测试脚本应该像一段程序而不仅仅是操作列表。使用Async/AwaitBot.js Pro API是异步的使用async/await让代码更清晰。模块化与函数封装将通用操作封装成函数。// commons/login.js async function login(username, password) { console.log(尝试登录用户名: ${username}); // ... 具体的登录操作 await bot.waitForElement({ text: 首页 }, 5000); console.log(登录成功进入首页); } module.exports { login }; // test_suite.js const { login } require(./commons/login); (async () { await login(testUser, 123456); // ... 后续测试步骤 })();参数化与数据驱动将测试数据与脚本逻辑分离。// 在config/data.json中定义测试数据 // [{“username”: “user1”, “pwd”: “pwd1”, “expected”: “成功”}, ...] const testData require(./config/data.json); for (const data of testData) { await login(data.username, data.password); // 添加断言验证登录结果是否符合data.expected }加入断言Assertions测试的核心是验证。虽然Bot.js Pro 本身可能不包含断言库但可以轻松集成如chai这样的库。const expect require(chai).expect; // ... 执行操作后 const welcomeText await bot.findElement({ textContains: 欢迎 }).getText(); expect(welcomeText).to.include(data.username); // 断言欢迎文本包含用户名4.3 对抗无障碍检测的深度配置在botjs.config.js中我们可以进行更细致的防检测配置module.exports { device: { id: auto, // 自动选择第一个设备 }, automation: { humanLike: true, // 全局启用拟人化操作 actionDelay: [100, 300], // 每个操作后的延迟范围 [最小, 最大] 毫秒 clickOffset: 3, // 点击点随机偏移的最大像素值 swipeHumanize: true, // 启用拟人化滑动 // 图像匹配配置 imageMatch: { threshold: 0.8, method: TM_CCOEFF_NORMED // 匹配算法 } }, // 可以配置多个设备或场景 profiles: { stable: { humanLike: true, actionDelay: [200, 500] }, // 稳定模式慢速 fast: { humanLike: false, actionDelay: [50, 100] } // 快速模式用于调试 } };在脚本中可以按需使用不同的配置档await bot.setConfig(stable); // 切换到稳定模式执行关键流程 await bot.click(..., { humanLike: true, delay: [300, 700] }); // 单个操作覆盖全局配置5. 实战构建一个完整的电商App自动化测试用例让我们以一个典型的电商App场景为例编写一个从启动App、登录、搜索商品、加入购物车到退出的完整测试用例。我们将融合前面讲的所有知识点。5.1 用例设计与准备工作测试用例验证用户登录后可以成功搜索特定商品并将其加入购物车。测试数据用户名test_buyer密码Test123456搜索关键词蓝牙耳机预期购物车中商品数量增加1且包含搜索到的商品。准备工作确保App已安装在被测手机上。在项目resources/目录下准备好一些关键元素的截图备用如App的启动图标、登录成功后首页的某个特征区域如“搜索框”。清理App数据确保从初始状态开始测试。5.2 脚本实现详解我们创建一个新文件scripts/test_ecommerce_cart.js。const { bot } require(botjs-pro); const expect require(chai).expect; // 导入封装的通用模块 const { login, logout } require(./commons/auth); const { searchProduct, addToCart } require(./commons/shopping); (async () { try { console.log( 电商App购物车流程测试开始 ); await bot.connectDevice(); // 连接设备 // --- 步骤1: 启动App --- console.log(1. 启动App...); // 方法1: 通过ADB命令启动Activity (最可靠) await bot.shell(am start -n com.example.ecommerce/.MainActivity); // 方法2: 如果不知道Activity可以先回到桌面再点击图标图像匹配备用 // await bot.pressKey(home); // const appIcon await bot.findElement({ image: ./resources/app_icon.png }); // await appIcon.click({ humanLike: true }); await bot.waitForElement({ textContains: 首页 }, 10000); // 等待首页加载 await bot.delay(2000); // 额外稳定等待 // --- 步骤2: 执行登录 --- console.log(2. 执行登录...); const loginSuccess await login(test_buyer, Test123456); expect(loginSuccess).to.be.true; // 断言登录成功 // --- 步骤3: 搜索商品 --- console.log(3. 搜索商品...); const searchResult await searchProduct(蓝牙耳机); expect(searchResult).to.have.length.greaterThan(0); // 断言搜索结果不为空 const targetProduct searchResult[0]; // 取第一个结果 console.log(目标商品: ${await targetProduct.getText()}); // --- 步骤4: 进入商品详情并加入购物车 --- console.log(4. 加入购物车...); await targetProduct.click({ humanLike: true }); await bot.waitForElement({ textContains: 商品详情 }, 5000); // 加入购物车前先获取购物车原始数量 const cartBadge await bot.findElement({ resourceId: com.example.ecommerce:id/cart_badge }); let cartCountBefore 0; if (cartBadge) { cartCountBefore parseInt(await cartBadge.getText()) || 0; } await addToCart(); // 执行封装的加入购物车操作 await bot.delay(1500); // 等待购物车更新 // --- 步骤5: 验证购物车 --- console.log(5. 验证购物车...); // 方法A: 检查角标数字 const cartBadgeAfter await bot.findElement({ resourceId: com.example.ecommerce:id/cart_badge }); if (cartBadgeAfter) { const cartCountAfter parseInt(await cartBadgeAfter.getText()) || 0; expect(cartCountAfter).to.equal(cartCountBefore 1); console.log(购物车数量验证通过: ${cartCountBefore} - ${cartCountAfter}); } // 方法B: 进入购物车页面检查商品是否存在 (更可靠) await bot.findElement({ resourceId: com.example.ecommerce:id/cart_icon }).click(); await bot.waitForElement({ text: 购物车 }, 5000); const cartItem await bot.findElement({ textContains: 蓝牙耳机 }, 3000); // 等待3秒 expect(cartItem).to.exist; console.log(购物车中存在目标商品验证通过。); // --- 步骤6: 清理与退出 --- console.log(6. 清理测试数据并退出...); // 从购物车删除测试商品 if (cartItem) { const deleteBtn await cartItem.parent().findElement({ text: 删除 }); await deleteBtn?.click(); } await logout(); // 执行封装的退出登录 await bot.pressKey(home); // 返回桌面 console.log( 测试用例执行成功 ); } catch (error) { console.error(!!! 测试用例执行失败 !!!); console.error(失败步骤:, error.message); console.error(错误堆栈:, error.stack); // 失败时截图便于排查 await bot.screenshot(./error_screenshot.png); throw error; // 重新抛出错误让测试框架捕获 } finally { await bot.disconnect(); // 确保最终断开连接 } })();5.3 封装的关键函数示例上面用到的login,searchProduct等函数是我们封装在commons/目录下的。commons/auth.js:async function login(username, password) { try { // 1. 查找并点击“我的”tab进入登录入口 const myTab await bot.findElement({ text: 我的 }); if (!myTab) { // 回退方案可能底部是图标尝试通过图像匹配 myTab await bot.findElement({ image: ./resources/tab_profile.png }); } await myTab.click({ humanLike: true }); // 2. 在“我的”页面找登录入口 await bot.waitForElement({ textContains: 登录/注册 }, 5000); const loginEntry await bot.findElement({ textContains: 登录/注册 }); await loginEntry.click({ humanLike: true }); // 3. 输入用户名密码 await bot.waitForElement({ className: android.widget.EditText }, 5000); const inputs await bot.findElements({ className: android.widget.EditText }); await inputs[0].inputText(username); await inputs[1].inputText(password); // 4. 点击登录按钮 const loginBtn await bot.findElement({ text: 登录 }); await loginBtn.click({ humanLike: true, delay: [500, 1000] }); // 登录操作可以更“犹豫”一点 // 5. 验证登录成功等待“我的”页面出现用户名或特定元素 const successIndicator await bot.waitForElement( { textContains: username } || { resourceId: com.example.ecommerce:id/user_name }, 10000 ); return !!successIndicator; // 返回布尔值表示成功与否 } catch (err) { console.error(登录过程出错:, err); return false; } } async function logout() { // ... 类似的封装找到退出登录的入口并点击 } module.exports { login, logout };6. 常见问题排查与性能优化在实际使用中你肯定会遇到各种问题。下面是我踩过的一些坑和解决方案。6.1 元素找不到NoSuchElement这是最常见的问题。原因1页面未加载完成。解决在关键操作前增加显式等待。bot.waitForElement比bot.delay更智能。// 不好 await bot.delay(3000); await bot.findElement(...); // 好 await bot.waitForElement({ text: 加载完成 }, 10000); // 最多等10秒原因2控件属性动态变化。比如text今天是“提交”明天改成“确认”。解决使用更稳定的定位方式如resourceId。或者使用textContains进行模糊匹配或结合多个属性。// 使用模糊匹配和组合定位 await bot.findElement({ className: android.widget.Button, textContains: 提 });原因3页面有弹窗、浮层遮挡。解决在查找元素前先检查并关闭可能的弹窗。可以写一个通用的dismissPopup函数。async function dismissCommonPopups() { const closeBtn await bot.findElement({ text: 关闭 }, 1000); // 快速查找不阻塞 if (closeBtn) { await closeBtn.click(); await bot.delay(500); } // 可以继续检查其他常见弹窗如“知道了”、“跳过”等 } // 在关键步骤前调用 await dismissCommonPopups();原因4App启用了无障碍检测界面状态异常。解决检查并强化humanLike配置。尝试在botjs.config.js中增加actionDelay的范围或为特定敏感操作单独设置更长的随机延迟。6.2 脚本运行不稳定时好时坏优化等待策略混合使用智能等待和固定等待。网络请求后多用waitForElement动画过渡后用短的delay。增加重试机制对于非关键性失败可以加入重试逻辑。async function clickWithRetry(selector, maxRetries 3) { for (let i 0; i maxRetries; i) { try { const el await bot.findElement(selector, 3000); if (el) { await el.click({ humanLike: true }); return true; } } catch (err) { console.log(第${i1}次点击尝试失败); await bot.delay(1000); } } throw new Error(元素${JSON.stringify(selector)}点击失败已达最大重试次数); }使用图像匹配作为保底对于极其不稳定的控件在属性定位失败后启用图像匹配回退。确保截图是在标准状态下截取的如正常亮度、默认主题。检查设备性能关闭手机后台不必要的应用确保测试时手机不卡顿。模拟器则要分配足够的CPU和内存。6.3 如何调试脚本大量使用console.log在每个步骤开始和结束时打印信息方便追踪执行流。失败时自动截图像上面实战例子一样在catch块中调用bot.screenshot()保存错误时的屏幕状态这是最直接的调试依据。放慢执行速度在调试阶段将botjs.config.js中的actionDelay调大比如设为[1000, 3000]让你有足够时间观察屏幕变化。单步执行Bot.js Pro 的Web录制界面通常也提供回放和单步调试功能可以加载你的脚本文件一步步执行并观察。6.4 提升脚本执行速度当脚本稳定后你可能需要它跑得更快。减少不必要的等待将固定的bot.delay替换为基于条件的waitForElement一旦条件满足立即继续。调整humanLike参数在非敏感操作流程或确定无检测的界面可以局部关闭拟人化。// 快速连续操作一些非关键步骤 await bot.setConfig(fast); // 切换到快速配置档 await doSomeBackgroundTasks(); await bot.setConfig(stable); // 切回稳定模式并行执行如果测试用例间无依赖可以考虑使用Node.js的异步机制并行执行多个bot实例操作多台设备需要管理好设备端口和会话。Bot.js Pro 把自动化测试从一种“高门槛技术活”变成了更接近“配置和描述性编程”的工作。它的自动生成能力让你快速起步而其对“防检测”的深入思考和提供的丰富API则让你有能力构建出能在复杂真实环境中稳定运行的测试脚本。记住好的自动化测试不是一蹴而就的需要根据应用的特点不断调整定位策略和等待逻辑是一个持续迭代和优化的过程。