菜单

【雷电模拟器】ADB命令使用说明(更新于26-9-3)

ADB(Android Debug Bridge,安卓调试桥)是连接电脑与安卓设备的通用命令行工具。雷电模拟器每个实例都通过 ADB 调试端口开放,开发者可以直接用 adb 完成连接、安装、模拟输入、截图、文件传输等全部调试与自动化工作,无需依赖任何专有命令行封装。

一、雷电模拟器 adb 端口与连接

1. adb 端口查看

雷电模拟器每个实例都通过一组 ADB 调试端口开放。常规命名规则为:

实例序号 默认 adb 端口
0(主实例) 5554
1 5556
2 5558
依次 +2

实例 0 启动后,在 adb devices 中通常显示为一个串号(如 emulator-5554

多开时实例 1 约对应 emulator-5556、实例 2 约对应 emulator-5558具体串号以本机 adb devices 实际输出为准

复制代码
adb devices                      # 查看本机所有实例串号

📌 同机双雷电(雷电9 + 雷电14)端口冲突提醒:若同一台电脑同时运行雷电9 与 雷电14 的实例 0,两者都会抢占 5555。先启动的实例正常注册,后启动的实例 adb 端口会被压制、在 adb devices看不到

解决办法:避免同机双开实例 0,或只保留一个模拟器版本运行。

2. 如何连接 adb(单实例)

  1. 打开雷电模拟器安装目录(如 E:\leidian\LDPlayer14),在地址栏输入 CMD 回车,呼出命令提示符。
  2. 输入 adb devices 回车,确认实例已列出(如 emulator-5554)。
  3. 输入 adb shell 回车,进入安卓 shell。
复制代码
E:\leidian\LDPlayer14> adb devices
List of devices attached
emulator-5554    device

E:\leidian\LDPlayer14> adb shell
xxx:/ #

3. 如何连接多开模拟器的 adb

当多个实例同时运行时,每个实例都会注册各自的串号。先用 adb devices 查看全部,再用 -s <串号> 指定目标:

复制代码
adb devices                            # 先看全部串号
adb -s emulator-5554 shell           # 连接实例 0
adb -s emulator-5554 shell pm list packages -3

若串号未出现,先确认对应模拟器实例已启动,再执行 adb devices 刷新。

二、多设备冲突与 -s 指定目标

当电脑同时连接多台模拟器(或多开实例)时,任何不带 -s 的 adb 命令都会报错

复制代码
adb.exe: more than one device/emulator

解决办法只有一种:始终用 -s <串号> 显式指定目标设备。把串号作为 adb 的第一个参数即可:

复制代码
adb -s emulator-5554 shell input tap 500 500

📌 关于串号的稳定性:运行中实例的串号(如 emulator-5554)由雷电 adb server 持续维护,adb disconnect 后会在数秒内被自动拉回;要彻底断开只能关闭实例或 adb kill-server(但再次运行任意 adb 命令会重新注册)。因此脚本里直接用 -s 锁定 adb devices 里的真实串号最省心。

三、常用 adb 指令指引

部分指令涉及权限,可先开启 ROOT(见 3.1)后再操作。下例默认已通过 adb shell 进入安卓,或在前缀带上 adb -s <串号>

1. 开启 ROOT 权限

打开模拟器「设置中心 → 其他 → 开启 ROOT 权限」。连接 adb 后输入 adb shell,若提示符为 $ 则权限不足:

复制代码
adb shell          # 进入后看到 $
exit               # 退回上一层
adb root           # 以 root 重启 adb 守护进程
adb shell          # 再次进入,提示符应为 #

2. 多设备下的操作格式

复制代码
adb -s <串号> <其他命令>
# 例:
adb -s emulator-5554 shell pm list packages -3

若本机只有一台模拟器,也可省略 -s,直接 adb <命令>

3. 安装与卸载 apk

复制代码
adb install C:\xx.apk              # 安装
adb install -r C:\xx.apk           # 覆盖安装(保留数据)
adb uninstall <包名>               # 卸载

4. 获取已安装应用包名

复制代码
adb shell pm list packages            # 所有应用
adb shell pm list packages -3        # 第三方应用
adb shell pm list packages -s        # 系统应用
adb shell dumpsys window | findstr mCurrentFocus   # 正在运行的应用

5. 获取 Activity 名

复制代码
adb shell cmd package resolve-activity --brief <包名> | tail -n 1

6. 查看应用版本号

复制代码
adb shell dumpsys package <包名> | findstr version

7. 清理应用数据

复制代码
adb shell pm clear <包名>

8. 模拟输入

动作 命令 说明
按键 adb shell input keyevent <键值> 3 为 HOME 键,4 为返回键
字符 adb shell input text <字符> hello不支持中文
点击 adb shell input tap <X> <Y> X Y 为屏幕坐标(像素)
滑动 adb shell input swipe <X1> <Y1> <X2> <Y2> [TIME] TIME 为毫秒,默认 100
长按 adb shell input swipe <X> <Y> <X> <Y> <TIME> 起止同点即长按
启动 App adb shell am start -n <包名>/<Activity> 见3.5获取的 Activity 名

9. 电脑与模拟器互传文件

复制代码
adb push C:\test.apk /sdcard/           # 电脑 → 模拟器
adb pull /sdcard/test.apk C:\           # 模拟器 → 电脑(用 Windows 盘符,勿用 /c/)

10. 截图

复制代码
adb shell screencap /sdcard/screen.png   # 截当前屏,存到设备
adb pull /sdcard/screen.png C:\          # 下载到电脑

11. 录制视频

复制代码
adb shell screenrecord /sdcard/test.mp4   # 开始录制
# 按 CTRL+C 结束
adb pull /sdcard/test.mp4 C:\             # 导出

12. 查看设备信息

复制代码
adb shell getprop ro.product.model        # 型号
adb shell getprop ro.product.brand        # 品牌
adb shell getprop ro.product.board        # 处理器
adb shell getprop ro.build.version.release # 安卓版本
adb shell wm size                          # 分辨率
adb shell dumpsys SurfaceFlinger | findstr "GLES"  # 渲染模式

13. 关闭开发者模式

复制代码
adb shell settings put global development_settings_enabled 0

四、adb 实战示例

把上述指令组合,即可对雷电模拟器做完整自动化。常见场景:

目的 命令
单实例点击坐标 adb shell input tap 500 500
指定实例点击坐标 adb -s emulator-5554 shell input tap 500 500
输入英文文本 adb shell input text hello
滑动操作 adb shell input swipe 300 800 300 300 500
返回主屏 adb shell input keyevent 3
查安卓版本 adb shell getprop ro.build.version.release
启动系统设置 adb shell am start -n com.android.settings/.Settings
截图并导出 adb shell screencap /sdcard/s.png 后接 adb pull /sdcard/s.png C:\
向设备推文件 adb push C:\conf.txt /sdcard/
上一个
【雷电模拟器】ldconsole命令行开发者使用说明(更新于26-08-31)
最近修改: 2026-09-03