android-screenshot-core

Android App 自动化截图核心库，基于 Appium + WebDriverIO。

支持的 App：

• 抖音
• 小红书

前置要求

• Node.js >= 18
• Appium Server 运行中
• Android 设备已连接（真机或模拟器）
• 目标 App 已安装

安装

npm install android-screenshot-core

使用

const screenshot = require('android-screenshot-core')

// 抖音截图（使用默认 Appium 配置 127.0.0.1:4723）
const buffer = await screenshot.douyin.searchAndScreenshot('https://v.douyin.com/xxx')

// 小红书截图
const buffer = await screenshot.xiaohongshu.searchAndScreenshot('https://www.xiaohongshu.com/xxx')

// 自定义 Appium 连接配置
const buffer = await screenshot.douyin.searchAndScreenshot('https://v.douyin.com/xxx', {
  hostname: '192.168.1.100',
  port: 4723,
  capabilities: {
    'appium:udid': 'device-serial',
  },
})

API

screenshot.douyin.searchAndScreenshot(url, [driverOptions])

在抖音内搜索指定 URL 并截图，返回 PNG Buffer。

screenshot.xiaohongshu.searchAndScreenshot(url, [driverOptions])

通过浏览器跳转在小红书内打开链接并截图，返回 PNG Buffer。

screenshot.getDriver([options])

获取或创建 Appium driver 实例（单例模式）。

screenshot.closeDriver()

关闭当前 Appium driver 会话。

driverOptions

| 参数 | 类型 | 默认值 | 说明 | |------|------|--------|------| | hostname | string | 127.0.0.1 | Appium 服务地址 | | port | number | 4723 | Appium 服务端口 | | capabilities | object | - | 自定义 Appium capabilities，会与默认值合并 |