# adb-helper

**Repository Path**: xulei8820/adb-helper

## Basic Information

- **Project Name**: adb-helper
- **Description**: 基于 .NET 8 WinForms 的 Android APK 安装工具，通过 ADB 实现设备的 APK 安装、信息查看与应用启动。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 3
- **Forks**: 1
- **Created**: 2026-06-14
- **Last Updated**: 2026-06-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 安卓 ADB 助手 (AdbHelper)

[![.NET](https://img.shields.io/badge/.NET-8.0-512BD4?logo=dotnet)](https://dotnet.microsoft.com/download/dotnet/8.0)
[![Platform](https://img.shields.io/badge/platform-Windows-0078D6?logo=windows)](https://www.microsoft.com/windows)
[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE.txt)
[![Version](https://img.shields.io/badge/version-1.2.0-blue)](https://gitee.com/fonery/adbhelper)

基于 .NET 8 WinForms 的安卓 ADB 桌面管理工具，集 ADB 工具箱、设备控制与投屏、文件管理、APK 安装于一体，免配置开箱即用。

## 功能特性

### 🧰 ADB 工具箱
- **设备信息** — 显示型号、品牌、产品名、序列号、连接方式、Android 版本、SDK 等级、安全补丁、构建类型、CPU 架构
- **应用管理** — 第三方/系统应用列表，支持卸载、清除数据、强制停止、启动应用
- **快捷操作** — 截屏、录屏、无线配对、WiFi 连接、网络扫描
- **命令执行** — 自定义 ADB Shell 命令

### 📱 设备控制与投屏
- **实时屏幕镜像** — 每秒 3 帧的实时设备画面投屏，支持缩放与自适应
- **触摸交互** — 鼠标点击/滑动直接操作设备（支持 input 和 sendevent 两种注入方式）
- **实体按键** — HOME、BACK、MENU、RECENTS、电源、音量键等模拟
- **输入注入** — 文字输入、广播发送（am broadcast）
- **屏幕解锁** — 自动检测并唤醒/解锁设备

### 📂 文件管理
- **设备文件浏览** — 树形目录导航，支持递归展开
- **文件传输** — 上传文件到设备、下载文件到电脑
- **文件操作** — 删除、重命名、新建文件夹
- **权限查看** — 显示文件权限、大小、修改时间
- **多选操作** — 批量选择、全选、反选

### 📦 APK 安装
- **APK 解析** — 使用 [ApkReader](https://www.nuget.org/packages/ApkReader/) 直接解析二进制 AndroidManifest，无需 aapt
- **信息提取** — 包名、版本号、应用名、最低/目标 SDK 版本
- **安装选项** — 覆盖安装 (`-r`)、授予所有权限 (`-g`)、安装后自动启动
- **格式支持** — `.apk` / `.apk.1` / `.xapk` / `.apks`

### 🔗 设备连接
- **USB 连接** — 自动检测 USB 连接设备
- **WiFi 连接** — 支持 TCP 模式连接、无线配对（Android 11+ QR 码）
- **局域网扫描** — 并行 Ping + TCP 端口探测 + mDNS 服务发现

### ⚡ ADB 环境
- **内嵌 ADB** — platform-tools 以嵌入资源打包，首次运行自动解压
- **零配置** — 无需安装 Android SDK，无需配置环境变量

## 界面预览

| 主界面 | APK 安装  |
|:---:|:---:|
| ![主界面](images/main.png) | ![ADB连接](images/apk-installer.png) |

| ADB 工具箱 | 设备控制 |
|:---:|:---:|
| ![ADB工具箱](images/toolbox.png) | ![设备控制](images/device.png) |

| 输入控制 | 文件管理 |
|:---:|:---:|
| ![输入控制](images/input-control.png) | ![文件管理](images/files.png) |

| ADB 连接 | 无线配对 |配对码配对|
|:---:|:---:|:------------------------------:|
| ![APK安装](images/adb-connect.png) | ![QR码配对](images/pair-qr.png) | ![QR码配对](images/pair-code.png) |

## 环境要求

- **操作系统**：Windows 10/11
- **运行时**：[.NET 8 Desktop Runtime](https://dotnet.microsoft.com/download/dotnet/8.0)
- **Android 设备**：已开启 USB 调试（开发人员选项）

## 快速开始

### 下载安装

从 [Releases](https://gitee.com/fonery/adbhelper/releases) 页面下载最新版本安装包，运行安装即可。

### 从源码构建

```bash
# 克隆仓库
git clone https://gitee.com/fonery/adbhelper.git
cd adbhelper

# 还原依赖
dotnet restore

# 构建
dotnet build

# 运行
dotnet run
```

## 使用说明

### 连接设备

**USB 连接**（推荐）：
1. 用 USB 数据线连接手机和电脑
2. 手机弹出"允许 USB 调试"对话框，勾选"始终允许"并确认
3. 点击主界面「刷新设备」扫描

**WiFi 连接**：
1. 先通过 USB 连接，点击「WiFi 连接」→「开启 TCP 模式」
2. 拔掉 USB 线，点击「连接 WiFi 设备」输入 IP 地址连接
3. 或勾选「扫描局域网」自动发现网络设备

**无线配对**（Android 11+）：
1. 手机进入「无线调试」，选择「使用二维码配对」
2. 工具生成 QR 码，手机扫描即可配对

### 设备控制

1. 选择设备后点击「设备控制」打开控制窗口
2. 左侧显示实时屏幕画面，可直接点击/滑动操作
3. 右侧显示已安装应用列表，支持双击启动、右键菜单管理
4. 底部工具栏提供按键模拟、输入注入、广播发送等功能

### 文件管理

1. 选择设备后点击「文件管理」打开管理窗口
2. 左侧目录树导航，右侧显示文件列表
3. 右键菜单支持上传、下载、删除、重命名等操作

### APK 安装

1. 选择设备后点击「APK 安装」打开安装窗口
2. 点击「选择 APK」或拖拽 APK 文件到窗口
3. 自动解析并显示 APK 信息
4. 勾选安装选项后点击「安装」

## 技术栈

| 项目 | 技术 |
|------|------|
| 框架 | .NET 8 WinForms |
| APK 解析 | [ApkReader](https://www.nuget.org/packages/ApkReader/) 2.0.1.1 |
| QR 码生成 | [QRCoder](https://www.nuget.org/packages/QRCoder/) 1.8.0 |
| ADB | Android Platform Tools (内嵌) |
| 配色 | 深蓝 #167CE8 / 青绿 #2DD4BF / 背景 #F0F2F5 |

## 项目结构

```
AdbHelper/
├── MainForm.cs               # 主界面（设备列表、网络扫描、ADB 环境）
├── AdbToolboxForm.cs         # ADB 工具箱（设备信息、应用管理、快捷操作）
├── DeviceControlForm.cs      # 设备控制（屏幕镜像、触摸交互、按键模拟）
├── FileManagerForm.cs        # 文件管理（目录浏览、文件传输、批量操作）
├── ApkInstallForm.cs         # APK 安装（解析、安装、启动）
├── AdbPairForm.cs            # 无线配对（QR 码生成）
├── AdbConnectForm.cs         # WiFi 连接
├── AdbHelpForm.cs            # 帮助文档
└── IDeviceBound.cs           # 设备绑定接口
```

## 常见问题

<details>
<summary><b>设备列表为空？</b></summary>

1. 确保手机已开启「USB 调试」（设置 → 开发人员选项）
2. 检查 USB 线是否支持数据传输（非仅充电线）
3. 手机弹出授权对话框时需点击「允许」
4. 部分品牌（OPPO/小米/vivo）需额外开启「USB 安装」权限
</details>

<details>
<summary><b>屏幕镜像不显示？</b></summary>

1. 部分设备需在「开发人员选项」中开启「USB 调试（安全设置）」
2. 屏幕息屏或锁屏状态下画面为黑屏，会自动检测
3. 检查设备是否授权了调试权限
</details>

<details>
<summary><b>触摸操作无效？</b></summary>

- 工具会自动检测设备支持的注入方式（`input` 优先，降级 `sendevent`）
- 如两种方式均无权限，部分操作可通过 `am broadcast` 降级执行
- 小米/OPPO 等设备需在「开发人员选项」中开启「USB 调试（安全设置）」
</details>

<details>
<summary><b>WiFi 连接失败？</b></summary>

1. 确保手机和电脑在同一局域网
2. 先通过 USB 连接一次，再切换到 WiFi 模式
3. 防火墙可能阻止 ADB 端口（默认 5555）
</details>

## 参考手册

详细的 ADB 命令参考请参见 [ADB 参考手册](ADB参考手册.md)。

## 许可证

本项目采用 [MIT License](LICENSE.txt) 开源。

> **免责声明**：本工具仅供学习和合法用途使用。使用者需自行确保对所连接设备拥有合法权限，并遵守相关法律法规。作者不对因使用本工具产生的任何后果承担责任。

---

**© 2026 蜂云 FONERY** — 让 ADB 操作更简单高效。