bat-automator 设备操控库

- 支持 Android、iOS 设备

原理

- 使用 scrcpy 来做 android 设备录屏以绕开 adb screenrecord 在部分机型不可用问题：brew install scrcpy
- 用 adb 来操控 android 设备：brew install android-platform-tools
- 用 tidevice 来操控 iOS 设备：pip3.9 install -U tidevice
- 用 tidevice 的 relay 做端口映射，有一个 60s 左右的启动耗时，所以换成用 iProxy 做端口映射
- 用 ios-minicap 做 iOS 录屏（自动安装）
- 废弃
- 用 ffmpeg 做视频分帧：ffmpeg 的安装
- 统一 node18

支持能力

$3

- 启停 APP
- 模拟划屏
- 元素点击、输入
- 设备录屏
- 设备截屏

$3

> 示例均针对 Android 设备

##### 启停 APP
``
const automator = require('bat-automator');

// 设备号
let deviceId = 'abc';

// APP 包名
let baiduPackageName = 'com.baidu.searchbox';
let baiduMainActivity = 'com.baidu.searchbox.MainActivity';

const main = async () => {
// 获取设备句柄
let device = await automator.launch(deviceId);

// 停止 APP
await device.closeApp(baiduPackageName);

// 各类操作
// ...

// 启动 APP
await device.launchApp(baiduPackageName, baiduMainActivity);
};
`

##### 模拟划屏
`
const automator = require('bat-automator');

// 设备号
let deviceId = 'abc';

const main = async () => {
// 获取设备句柄
let device = await automator.launch(deviceId);

// 模拟手指从 (0, 0) 划到 (1, 1)
await device。swipe(0, 0, 1, 1);
};
`

##### 元素点击
`
const automator = require('bat-automator');

// 设备号
let deviceId = 'abc';

const main = async () => {
// 获取设备句柄
let device = await automator.launch(deviceId);

// 获取元素
let element = await device.$x('//node[@text="我的"]');

// 元素点击
await element.tap();
};
`

##### 元素输入
`
const automator = require('bat-automator');

// 设备号
let deviceId = 'abc';

const main = async () => {
// 获取设备句柄
let device = await automator.launch(deviceId);

// 获取元素
let element = await device.$x('//node[@text="搜索"]');

// 元素输入
await element.input("龙霸天好吃吗");
};
`

##### 设备录屏
`
const automator = require('bat-automator');

// 设备号
let deviceId = 'abc';

// 录屏存储路径
let videoPath = '/Users/data/video.mp4';

const main = async () => {
// 获取设备句柄
let device = await automator.launch(deviceId);

// 启动录屏
let video = await device.record(videoPath);

// 各类操作
// ...

// 结束录屏
await video.kill();
};
``