# adbbox **Repository Path**: SorryMyLife/adbbox ## Basic Information - **Project Name**: adbbox - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-08-23 - **Last Updated**: 2026-08-23 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README

ADB 工具箱

一款基于 ADB 的 Android 设备图形化管理工具

GitHub Release GitHub Stars GitHub Forks GitHub Downloads GitHub Watchers

C# .NET Framework WinForms Windows Visual Studio

--- ## 简介 ADB 工具箱是一款 Windows 桌面应用，通过图形化界面封装 ADB 命令，帮助开发者和普通用户更方便地管理 Android 设备。支持 USB 和无线连接，提供应用管理、截屏录屏、文件传输、Shell 命令执行、快捷系统设置、权限管理、应用分身、开发调试等丰富功能。 --- ## 截图 ### 主界面 - 设备信息与核心功能

左侧显示设备详细信息，右侧为功能模块区，底部为日志输出窗口。 ### 扩展功能 - 权限管理与分身管理

包含应用权限管理、应用分身管理、开发工具等高级功能。 ### 包名自动补全

输入包名时自动弹出已安装应用列表，支持模糊搜索和快速选择。 ### 启动应用测试

通过包名选择器启动设备上的应用，模拟器显示 Via 浏览器成功启动。 ### Shizuku 激活

一键激活 Shizuku 服务，日志显示启动过程，模拟器显示 Shizuku 运行成功。 --- ## 技术架构 ``` +================================================================+ | ADB 工具箱 (WinForms) | +================================================================+ | | | +----------------------------------------------------------+ | | | UI Layer (Form1.cs) | | | | | | | | topPanel (连接栏) mainSplit (主区域) | | | | +----------------+ +----------------+ +-------------+ | | | | | 连接方式选择 | | Panel1: | | bottomPanel | | | | | | 无线 / USB | | 设备信息面板 | | 日志按钮栏 | | | | | | IP/端口/配对码 | | 左侧固定显示 | | 日志输出窗口 | | | | | | | +----------------+ +-------------+ | | | | | 设备选择 | | Panel2: | | | | | | 刷新/断开 | | rightPanel | | | | | | 连接状态 | | (功能区) | | | | | +----------------+ | AutoScroll | | | | | | +-------------+| | | | | | | 应用管理 || | | | | | | 设备操作 || | | | | | | 设备工具 || | | | | | | Shell命令 || | | | | | | 快捷设置 || | | | | | | 媒体/导航 || | | | | | | 网络控制 || | | | | | | 系统工具 || | | | | | | 权限管理 || | | | | | | 分身管理 || | | | | | | 开发工具 || | | | | | +-------------+| | | | | +----------------+ | | +--------------------------------------------------------------+ | | | +----------------------------------------------------------+ | | | Layout Engine | | | | | | | | relayoutAll() flowRow() | | | | +------------------+ +-----------------------------+ | | | | | 集中式布局管理 | | 手动行排列 + 自动换行 | | | | | | SuspendLayout | | 控件直接放入 GroupBox | | | | | | AutoScrollMinSize | | 无 FlowLayoutPanel | | | | | | 滚动位置钳制 | | gap=4, rowHeight=34 | | | | | +------------------+ +-----------------------------+ | | | +----------------------------------------------------------+ | | | | +----------------------------------------------------------+ | | | Core Layer | | | | | | | | AdbUtils.cs InputDialog.cs AutoCompletePopup | | | | +----------------+ +----------------+ +---------------+ | | | | | ADB命令构建 | | 文本输入对话框 | | 包名自动补全 | | | | | | 账户解析 | | InputDialog | | 弹窗选择 | | | | | | AccountInfo类 | | | | 模糊搜索 | | | | | +----------------+ +----------------+ +---------------+ | | | | | | | | FileSelector.cs SystemInfoHelper TextBoxHelper | | | | +----------------+ +----------------+ +---------------+ | | | | | 文件夹选择 | | Windows系统信息 | | Hint提示文本 | | | | | | SaveFileDialog | | OS版本检测 | | 32/64位检测 | | | | | | FolderBrowser | | .NET版本检测 | | | | | | | +----------------+ +----------------+ +---------------+ | | | | | | | | UniversalDriverInstaller.cs | | | | +--------------------------------------------------+ | | | | | ADB驱动安装 (Google / MTK / Qualcomm) | | | | | | certmgr.exe 证书安装 + pnputil 驱动安装 | | | | | +--------------------------------------------------+ | | | +----------------------------------------------------------+ | | | | +----------------------------------------------------------+ | | | External Dependencies | | | | | | | | tools/win32/ tools/win64/ | | | | +----------------+ +----------------+ | | | | | adb.exe | | adb.exe | | | | | | scrcpy.exe | | scrcpy.exe | | | | | +----------------+ +----------------+ | | | | | | | | tools/Driver/ | | | | +--------------------------------------------------+ | | | | | Google/Driver | MTK | Qualcomm | | | | | +--------------------------------------------------+ | | | +----------------------------------------------------------+ | +================================================================+ ``` --- ## 技术栈 | 项目 | 详情 | |------|------| | 编程语言 | C# | | 目标框架 | .NET Framework 4.8 | | UI 框架 | Windows Forms (WinForms) | | 构建工具 | MSBuild / dotnet build | | IDE | Visual Studio | | 平台 | Windows 10 / 11 (x86 & x64) | | 外部工具 | ADB (Android Debug Bridge)、scrcpy | | 驱动支持 | Google USB Driver、MTK Driver、Qualcomm Driver | ### 引用的程序集 | 程序集 | 用途 | |--------|------| | System.Windows.Forms | UI 控件与窗口 | | System.Drawing | 图形绘制 | | System.Diagnostics | 进程管理（执行 ADB 命令） | | System.Net.Http | 网络请求 | | System.IO | 文件操作 | | System.Text.RegularExpressions | 正则解析（账户/设备信息） | | System.Threading / Tasks | 异步执行命令 | | System.Security.Principal | 权限检测 | --- ## 项目结构 ``` adbbox/ ├── Form1.cs # 主窗口 (UI 布局 + 事件处理 + 命令执行) ├── Form1.Designer.cs # 窗口设计器 (Minimal) ├── AdbUtils.cs # ADB 命令构建器 + 账户解析 + AccountInfo 类 ├── InputDialog.cs # 文本输入对话框 ├── StringListSelectionDialog.cs # 包名自动补全弹窗 (可调整大小) ├── FileSelector.cs # 文件/文件夹选择器 ├── SystemInfoHelper.cs # Windows 系统信息 (OS/架构/.NET 版本) ├── TextBoxHelper.cs # TextBox Hint 提示文本扩展 ├── UniversalDriverInstaller.cs # ADB 驱动安装 (Google/MTK/Qualcomm) ├── Program.cs # 程序入口 ├── App.config # 应用配置 ├── app.manifest # 应用清单 (DPI 感知) ├── adbbox.csproj # 项目文件 (.NET Framework 4.8) ├── adbbox.slnx # 解决方案文件 ├── images/ # 截图 │ ├── 1.png # 主界面 │ ├── 2.png # 扩展功能 │ ├── 3.png # 包名自动补全 │ ├── 4.png # 启动应用测试 │ └── 5.png # Shizuku 激活 └── tools/ # ADB & scrcpy 工具 (不包含在仓库中) ├── win32/ │ ├── adb.exe │ └── scrcpy.exe ├── win64/ │ ├── adb.exe │ └── scrcpy.exe └── Driver/ ├── Google/Driver/ ├── MTK/ └── Qualcomm/ ``` --- ## 功能模块 ### 设备连接 | 功能 | 说明 | |------|------| | USB 连接 | 自动检测已连接的 Android 设备 | | 无线连接 | 通过 IP 地址 + 端口 + 配对码连接 | | 设备切换 | 下拉列表选择已连接设备 | | 连接状态 | 实时显示连接状态 | ### 设备信息 | 项目 | ADB 命令 | |------|----------| | 设备型号 | `getprop ro.product.model` | | 品牌 | `getprop ro.product.brand` | | 安卓版本 | `getprop ro.build.version.release` | | SDK 版本 | `getprop ro.build.version.sdk` | | 电量 | `dumpsys battery` | | 分辨率 | `wm size` | | 密度 | `wm density` | | 存储 | `df /data` (自动转换 KB/MB/GB) | | IP 地址 | `ip addr show wlan0` | | 序列号 | `getprop ro.serialno` | ### 应用管理 | 功能 | ADB 命令 | |------|----------| | 安装 APK | `adb install -t -r` | | 批量安装 | 选择文件夹批量安装 | | 卸载 | `pm uninstall --user ` | | 清除数据 | `pm clear ` | | 强制停止 | `am force-stop ` | | 启动应用 | `monkey -p -c LAUNCHER 1` | | 禁用 / 启用 | `pm disable` / `pm enable` | | 冻结 / 解冻 | `pm suspend` / `pm unsuspend` | | 全部包名 | `pm list packages -u` | | 第三方包名 | `pm list packages -3` | | 系统包名 | `pm list packages -s` | | 查看应用信息 | `dumpsys package ` | | Shizuku 激活 | 新旧版本均支持 | | Dhizuku 激活 | `dpm set-device-owner` | | 黑域激活 | 新旧版本均支持 | ### 设备操作 | 功能 | 说明 | |------|------| | 截屏保存 | `screencap` + `pull`，保存为 PNG | | 开始录屏 | `screenrecord --time-limit 180` | | 停止录屏 | `pkill -INT screenrecord` | | 拉取录像 | `pull /sdcard/recording.mp4` | | 推送文件 | `adb push ` | | 拉取文件 | `adb pull ` | ### 设备工具 | 功能 | ADB 命令 | |------|----------| | 正常重启 | `reboot` | | Recovery | `reboot recovery` | | Bootloader | `reboot bootloader` | | Sideload | `reboot sideload` | | Fastboot | `reboot fastboot` | | 关机 | `reboot -p` | ### Shell 命令 - 自定义输入任意 Shell 命令 - 执行结果实时输出到日志窗口 ### 快捷设置 | 分类 | 功能 | |------|------| | 屏幕 | 触摸开/关 (`show_touches`)、指针开/关 (`pointer_location`) | | 动画 | 关闭/0.5x/1x/1.5x (`window_animation_scale` 等) | | 亮度 | 获取/设置 (`screen_brightness`) | | 字体 | 设置缩放比例 (`font_scale`) | | 分辨率 | 设置/恢复默认 (`wm size`) | | 密度 | 设置/恢复默认 (`wm density`) | | 常亮 | 开/关 (`stay_on_while_plugged_in`) | | 自动旋转 | 开/关 (`accelerometer_rotation`) | ### 媒体 / 导航 | 功能 | 按键码 | |------|--------| | 音量+ / 音量- | `KEYCODE_VOLUME_UP` / `DOWN` | | 播放 / 暂停 | `KEYCODE_MEDIA_PLAY` / `PAUSE` | | 上一曲 / 下一曲 | `KEYCODE_MEDIA_PREV` / `NEXT` | | 返回 | `KEYCODE_BACK` | | 主页 | `KEYCODE_HOME` | | 最近任务 | `KEYCODE_APP_SWITCH` | | 亮屏 / 息屏 | `KEYCODE_WAKEUP` / `SLEEP` | ### 网络控制 | 功能 | ADB 命令 | |------|----------| | WiFi 开/关 | `svc wifi enable/disable` | | 蓝牙 开/关 | `svc bluetooth enable/disable` | | 移动数据 开/关 | `svc data enable/disable` | | 飞行模式 开/关 | `settings put global airplane_mode_on` | ### 系统工具 | 功能 | 说明 | |------|------| | 查看日志 | `logcat -d -t 100` | | 清除日志 | `logcat -c` | ### 应用权限管理 (AppOps) | 功能 | ADB 命令 | |------|----------| | 查看权限 | `appops get ` | | 重置权限 | `appops reset ` | | 位置 开/关 | `appops set COARSE_LOCATION / FINE_LOCATION allow/deny` | | 相机 开/关 | `appops set CAMERA allow/deny` | | 麦克风 开/关 | `appops set RECORD_AUDIO allow/deny` | | 存储 开/关 | `appops set READ/WRITE_EXTERNAL_STORAGE allow/deny` | | 通知 开/关 | `appops set POST_NOTIFICATIONS allow/deny` | | 授权存储 | `pm grant READ/WRITE_EXTERNAL_STORAGE` | | 撤销存储 | `pm revoke READ/WRITE_EXTERNAL_STORAGE` | | 查看包权限 | `dumpsys package | grep permission` | ### 应用分身管理 | 分类 | 功能 | ADB 命令 | |------|------|----------| | 工作资料 | 创建 | `pm create-user --profileOf 0 --managed ` | | 工作资料 | 设置 ProfileOwner | `dpm set-profile-owner --user ` | | 工作资料 | 移除 ProfileOwner | `dpm remove-profile-owner ` | | 克隆分身 | 创建 | `pm create-user --user-type android.os.usertype.profile.CLONE --profileOf 0 ` | | 用户管理 | 创建普通用户 | `pm create-user ` | | 用户管理 | 删除用户 | `pm remove-user ` | | 用户管理 | 列出所有用户 | `pm list users` | | 用户管理 | 用户应用列表 | `pm list packages --user ` | | 用户管理 | 启动/停止/切换用户 | `am start-user / stop-user / switch-user` | | 分身操作 | 安装到用户 | `pm install-existing --user ` | | 分身操作 | 从用户卸载 | `pm uninstall --user ` | | 分身操作 | 启动用户应用 | `monkey --user -p -c LAUNCHER 1` | | 分身操作 | 暂停/恢复分身 | `am set-inactive --user true/false` | | 自动配置 | 创建后自动执行 | `settings --user put secure user_setup_complete 1` | | 自动配置 | 创建后自动执行 | `settings --user put global device_provisioned 1` | ### 开发工具 | 功能 | 说明 | |------|------| | 查看无障碍 | `settings get secure enabled_accessibility_services` | | 关闭无障碍 | `settings put secure enabled_accessibility_services ""` | | 关闭/恢复动画 | `settings put global *_animation_scale 0/1` | | GPU 渲染分析 | `setprop debug.hwui.profile 1` | | 布局边界 | `setprop debug.layout true` | | 当前用户账户 | `dumpsys account` 解析 User 0 | | 所有用户账户 | `dumpsys account` 解析全部用户 | --- ## 环境要求 - Windows 10 / 11 - .NET Framework 4.8 - Android 设备需开启 USB 调试 ## 快速开始 1. 从 [Releases](https://github.com/MrsEWE44/adbbox/releases) 下载最新版本 2. 解压后运行 `adbbox.exe` 3. 连接 Android 设备（USB 或无线） 4. 选择设备后即可使用各项功能 ## 开发构建 ```bash # 命令行构建 dotnet build adbbox.csproj # 或使用 Visual Studio 打开 adbbox.slnx 后按 F5 ``` ## 许可证 本项目仅供学习交流使用。