更新记录

1.0.0（2025-11-22）

1.0.0（2025-11-22）

插件初始化

平台兼容性

uni-app x(4.81)

zcx-adb-shell

引入

import { adbCmd } from "@/uni_modules/zcx-adb-shell";

方法

获取设备列表

type AdbDevice = {
  id :string;
  status: 'offline'|'unauthorized'|'device';
}
/**
 * @description 获取设备列表
 * @returns Promise<AdbDevice[]> 设备列表
 */
adbCmd.get_devices()

配对设备

 /**
 * @description 配对设备
 * @param ip string ip地址
 * @param port string 端口
 * @param code string 配对码
 * @returns Promise<boolean> true
 */
adbCmd.pairDevice(ip:string, port:string, code:string)

连接设备

 /**
 * @description 连接设备
 * @param ip string ip地址
 * @param port string 端口
 * @returns Promise<boolean> true
 */
adbCmd.connectDevice(ip:string, port:string)

获取设备信息

 /**
 * @description 获取设备信息
 * @param id string 设备id
 * @returns Promise<UTSJSONObject> JSON对象
 */
adbCmd.getDeviceInfo(id:string)

模拟按键

 /**
 * @description 模拟按键
 * @param id string 设备id
 * @param code number 按键码
 * @returns Promise<boolean> true
 */
adbCmd.sendKeyEvent(id:string,code:number)

模拟滑动

 /**
 * @description 模拟滑动
 * @param id string 设备id
 * @param x1 number 起始位置x坐标
 * @param y1 number 起始位置y坐标
 * @param x2 number 结束位置x坐标
 * @param y2 number 结束位置y坐标
 * @returns Promise<boolean> true
 */
adbCmd.sendSwipeEvent(id:string,x1:number,y1:number,x2:number,y2:number)

模拟点击

 /**
 * @description 模拟点击
 * @param id string 设备id
 * @param x number x坐标
 * @param y number y坐标
 * @returns Promise<boolean> true
 */
adbCmd.sendTap(id:string,x:number,y:number)

获取屏幕分辨率

 /**
 * @description 获取屏幕分辨率
 * @param id string 设备id
 * @returns Promise<[number,number]> 分辨率
 */
adbCmd.getResolution(id:string)

发送文本

 /**
 * @description 发送文本
 * @param id string 设备id
 * @param text string 文本(只支持英文)
 * @returns Promise<boolean> true
 */
adbCmd.sendText(id:string, text:string)

屏幕截图

 /**
 * @description 屏幕截图
 * @param id string 设备id
 * @returns Promise<string> 保存路径(/sdcard/${id}_sc.png)
 */
adbCmd.screenshot(id:string)

拉取文件

 /**
 * @description 拉取文件
 * @param id string 设备id
 * @param path:string 远程文件路径
 * @param dir:string 本地目录
 * @returns Promise<boolean> true
 */
adbCmd.pullFile(id:string,path:string,dir:string)

推送文件

 /**
 * @description 推送文件
 * @param id string 设备id
 * @param path:string 本地文件路径
 * @param dir:string 远程目录
 * @returns Promise<boolean> true
 */
adbCmd.pushFile(id:string,path:string,dir:string)

获取应用列表

type AppItem{
    pkg: string, //包名
    _isSys: boolean, //是否系统应用
}
 /**
 * @description 获取应用列表
 * @param id string 设备id
 * @returns Promise<AppItem[]> 应用列表
 */
adbCmd.getAppList(id:string)

安装应用

 /**
 * @description 安装应用
 * @param id string 设备id
 * @param path string APK文件路径
 * @returns Promise<boolean> true
 */
adbCmd.installApp(id:string,path:string)

卸载应用

 /**
 * @description 卸载应用
 * @param id string 设备id
 * @param name string 应用包名
 * @returns Promise<boolean> true
 */
adbCmd.uninstallApp(id:string,name:string)

基于本插件开发的应用

adb调试工具
下载地址: https://r.pptwl.cn/twmddn
说明文档: https://juejin.cn/post/7575065042158714930