移动开发

ADB 命令生成器先核对参数,再带到终端

选择动作模板,填写字面参数,检查命令及其实际影响。

ADB 命令生成器

动作参数

命令预览

adb devices -l

输出适用于 macOS、Linux 或 WSL 中的 POSIX sh。路径按字面处理,不展开变量或 ~。

参数仅在当前浏览器处理,不连接设备、不执行命令。

选项

列出设备时忽略目标选项。其他模板使用 -d、-e 或 -s;默认目标交由 ADB 选择。

命令预览已更新。

ADB 命令生成器把常见 Android 操作整理为可检查的命令文本。多个设备同时连接时,可以手填序列号限定目标;安装路径、应用包名和设备用户分别填写,避免把不同类型的参数混在一起。

本页覆盖安装 APK、读取日志、截图、文件传输及部分应用维护操作。预览只表示命令已生成,不代表设备已连接、应用已安装或文件已成功复制。

为什么使用 ADB 命令生成器

空格和单引号仍然属于路径

ADB 命令生成器分别处理本机参数和设备 shell 参数。文件名中的空格不会拆成另一个参数,单引号也不会提前结束引用;预览保留的是原始字面值,而非待展开的脚本。

路径片段穿过两层引用边界,组成一条命令预览。

动作的影响随模板一起变化

从日志读取切换到清除数据,风险区域立即显示删除影响。安装、文件覆盖和重启分别解释自己的后果;语法合法不等于操作适合当前设备。

日志读取卡片与删除卡片分别展示读取符号和醒目的警示符号。

复制之前需要明确的三件事

01

设备列表不受目标过滤

列出设备是服务器范围的查询。其他模板可以选择 USB 实机、模拟器或具体序列号。默认目标适合只有一个可用设备的情况;示例里的序列号不会验证模拟器是否存在。

02

分清本机和设备两端

安装 APK 的路径在电脑上;adb 截图先写入设备上的 .png 文件,再复制到本机路径。请输入真实的字面路径,不要自行在整段路径外添加 shell 引号。

03

先看结果是否仍然有效

自动构建等待 350 毫秒,关闭后可用 Ctrl/Cmd+Enter 手动构建。示例与清空先展示改变的字段,应用后可撤销一次,同时恢复参数和原命令。

九种模板各自负责什么

安装与卸载参数分开

安装使用本机 APK 路径,可选覆盖安装和测试包标记。卸载使用应用包名,不能填 APK 文件名。保留数据选项只增加 -k,不会保留应用本身。

按标签筛选日志

logcat 日志可按一个标签和最低级别筛选。标签留空时作用于全部日志;填写标签后增加 *:S 屏蔽其他标签。默认读取现有缓冲内容后退出,取消该选项才持续输出。

截图与传输保持方向

截图模板把 screencap 和 pull 用 && 连接,只有截图成功才取回图片。独立的拉取与推送模板分别固定来源和目标顺序,适用于单个文件或目录路径。

维护操作先看影响

清除数据包含明确的 Android 用户,普通重启不包含 recovery 或 bootloader 选项。复制和下载只提供当前命令,不附带隐藏参数草稿,也不伪造设备返回信息。

命令语法与设备边界

只生成命令文本
本工具不使用 WebUSB、不进行 Wi-Fi 配对、不发送请求或执行命令。设备是否授权、能否连接、命令是否成功,需要在实际终端确认。
固定使用一种主机语法
输出适用于 POSIX sh,包括相应的 macOS、Linux 和 WSL 环境,不直接适用于 Windows CMD 或 PowerShell。设备 shell 模板会分别处理本机和远端两层引用。
路径按字面且有上限
每个路径最多 4096 个 UTF-16 单元,不接受控制符或双向控制标记。设备路径必须为绝对路径。本机文件名若以连字符开头,请添加字面 ./ 前缀;不展开变量或波浪号。
清除数据不等于清缓存
pm clear 会删除一个包在指定用户下的全部数据和缓存。本页没有仅清缓存、批量删应用、root、恢复出厂、刷机、权限绕过或设备端撤销。
无法判断文件实际情况
不上传或读取 APK,不安装拆分包,也不检查签名、路径存在性或覆盖情况。截图后设备 PNG 保留。真实目录权限、应用签名和 Android 版本仍可能导致命令失败。
模板和日志范围固定
不接受任意 shell、自填参数、管道、端口转发、录屏或包名与 PID 自动查询。日志标签采用受限 ASCII 标识符;本页不提供清空日志缓冲区。

ADB 命令生成器常见问题

多个设备连接时,如何通过 adb 向其中一个设备安装 APK?

先在实际终端用 adb devices -l 查看序列号,再选“指定序列号”填写目标。生成的 -s 参数仅指向该设备。-d 和 -e 分别选择 USB 实机与模拟器;同类目标有多个时仍可能产生歧义。

如何使用 ADB 截取屏幕?

选择“截图并取回”,填写以 .png 结尾的设备绝对路径及本机目标。screencap 先保存图片,成功后才通过 && 执行 pull。两个目标位置已有文件时都可能被覆盖。

adb shell 是否经过两层 shell?

是的,本机 shell 先解析一次,adb shell 再把命令文本交给设备端 shell。只加一层引号可能在到达 Android 之前就被去掉;这里分别对两个边界进行字面引用。

如何按标签过滤 logcat 输出?

填写一个完整标签并选择最低级别,例如生成 Tag:I 和 *:S,后者屏蔽其他标签。留空会使用 *:I 筛选所有标签。日志实际可见范围还取决于设备权限和缓冲区。

通过 ADB 清除缓存会清除应用数据吗?

会,pm clear 清除的不只是缓存,还包括应用数据、设置和会话。清除应用数据模板会明确提示破坏性,并要求指定 Android 用户。如果需要保留应用数据,请不要把它当作仅清缓存命令。

adb pull 如何处理包含空格的目录?

直接输入包含空格的路径原文,不要额外包一层引号。pull 的路径经过本机参数解析;截图的设备路径还经过设备 shell。工具负责添加相应引用,但无法验证目录是否存在或可访问。

生成结果与设备文档不一致?

检查下一条命令

用 ADB 命令生成器一起核对目标、字面路径和操作影响。仅复制当前有效的预览,并在对应的 shell 环境中再次检查后使用。