# adhc

**Repository Path**: qpcat/adhc

## Basic Information

- **Project Name**: adhc
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-23
- **Last Updated**: 2026-05-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# AdbHdc

一款专为鸿蒙和安卓设备打造的 VS Code 插件，提供设备连接、应用管理、文件传输、Ability 控制等完整功能。

![License](https://img.shields.io/badge/license-MIT-blue.svg)
![Version](https://img.shields.io/badge/version-1.0.0-green.svg)
![Platform](https://img.shields.io/badge/platform-HarmonyOS%20%7C%20Android-purple.svg)

## 📋 目录

- [功能特性](#-功能特性)
- [安装](#-安装)
- [🟣 鸿蒙设备管理](#-鸿蒙设备管理)
- [📱 安卓设备管理](#-安卓设备管理)
- [常用命令参考](#-常用命令参考)
- [项目结构](#-项目结构)
- [参与贡献](#-参与贡献)
- [许可证](#-许可证)

## ✨ 功能特性

### 鸿蒙设备
- 📱 **设备连接** - 实时显示已连接设备，支持刷新设备列表
- 🔑 **UUID 获取** - 一键获取设备唯一标识（64 位）
- 📦 **应用管理** - 安装、卸载、启用、禁用应用
- 🧹 **数据清理** - 清除应用数据和缓存
- 📁 **文件传输** - 双向文件传输（发送/接收）
- ⚙️ **系统操作** - 查看日志、重启设备、重启 HDC 服务
- 🚀 **Ability 控制** - 启动、停止应用，查看任务栈

### 安卓设备
- 🔗 **无线连接** - 支持 WiFi 无线调试连接
- 📱 **设备管理** - 实时查看已连接设备
- 📦 **应用管理** - 安装 APK、清除数据、强制停止
- ⚡ **快速命令** - 一键执行常用 ADB 命令
- 📁 **文件操作** - 查看文件列表、进程信息

## 📦 安装

### 方式一：从 VSIX 安装
1. 下载 `.vsix` 文件
2. 在 VS Code 中：扩展 → ⋯ → 从 VSIX 安装
3. 选择 `adhc-1.0.0.vsix` 文件

### 方式二：源码安装
```bash
# 克隆仓库
git clone https://gitee.com/qpcat/adhc.git

# 进入目录
cd adhc

# 安装依赖
npm install

# 编译
npm run compile

# 打包
npx vsce package

# 安装生成的 adhc-1.0.0.vsix
```

## 🟣 鸿蒙设备管理

### 设备连接

#### 设备列表
实时显示已连接的鸿蒙设备，点击 🔄 刷新设备 可更新设备状态。

#### 设备信息

| 功能 | 命令 | 说明 |
|------|------|------|
| 📋 版本 | `hdc -v` | 查看 HDC 版本 |
| 📱 设备 | `hdc list targets` | 列出所有已连接设备 |
| 🔑 UUID | `hdc shell bm get --udid` | 获取设备唯一标识（64 位） |

### 应用管理

#### 安装应用

| 功能 | 命令 | 操作 |
|------|------|------|
| 📥 安装 | `hdc app install` | 选择 HAP 文件安装 |
| 🔄 覆盖安装 | `hdc app install -r` | 覆盖已安装的同包名应用 |

#### 卸载应用
支持从下拉列表选择历史包名，或点击 ➕ 输入新包名，点击 🗑️ 卸载 执行。

#### 应用控制

| 功能 | 命令 | 说明 |
|------|------|------|
| 🚫 禁用 | `hdc shell bm disable -n 包名` | 禁用指定应用 |
| ✅ 启用 | `hdc shell bm enable -n 包名` | 启用已禁用应用 |
| 📊 信息 | `hdc shell bm dump -n 包名` | 查看应用详细信息 |

#### 清除数据与缓存

| 功能 | 命令 | 说明 |
|------|------|------|
| 🗑️ 清除数据 | `hdc shell bm clean -d -n 包名` | 清除应用所有数据 |
| 🧹 清除缓存 | `hdc shell bm clean -c -n 包名` | 清除应用缓存文件 |

### 文件传输

#### 发送文件到设备
1. 点击 📤 发送文件
2. 选择本地文件
3. 输入设备目标路径（如 `/storage/media/100/local/files/Docs/Download`）
4. 自动执行传输

#### 从设备接收文件
1. 点击 📥 接收文件
2. 输入设备上的文件路径
3. 选择电脑保存位置
4. 自动执行传输

### 系统操作

| 功能 | 命令 | 说明 |
|------|------|------|
| 📝 日志 | `hdc hilog` | 查看设备日志输出 |
| 🔄 重启 | `hdc shell reboot` | 重启鸿蒙设备 |
| ⛔ 终止 | `hdc kill` | 终止 HDC 服务进程 |
| 🔄 重启 HDC | `hdc start -r` | 重启 HDC 服务 |

### Ability 控制

| 功能 | 命令 | 说明 |
|------|------|------|
| 🚀 启动 | `hdc shell aa start -b 包名 -a Ability 名` | 启动指定 Ability |
| ⏹️ 停止 | `hdc shell aa force-stop 包名` | 强制停止应用 |
| 📋 任务栈 | `hdc shell aa dump -l` | 查看当前任务栈信息 |

## 📱 安卓设备管理

### 快速命令

- **连接设备** - 通过 WiFi 连接安卓设备
- **断开连接** - 断开当前连接
- **刷新设备** - 重新扫描设备列表
- **设备信息** - 查看设备详细信息
- **截图** - 截取设备屏幕
- **录屏** - 录制设备屏幕视频
- **重启设备** - 重启安卓设备

### 应用管理

- **安装应用** - 选择 APK 文件安装
- **卸载应用** - 输入包名卸载
- **清除数据** - 清除应用数据和缓存
- **启用/禁用** - 控制应用状态
- **查看包信息** - 获取应用详细信息

## 🔧 常用命令参考

```bash
# 安装应用
hdc app install ./app.hap

# 卸载应用
hdc app uninstall com.example.app

# 禁用/启用应用
hdc shell bm disable -n com.example.app
hdc shell bm enable -n com.example.app

# 清除数据/缓存
hdc shell bm clean -d -n com.example.app
hdc shell bm clean -c -n com.example.app

# 文件传输
hdc file send ./file.hap /data/
hdc file recv /data/file.hap D:\

# 启动 Ability
hdc shell aa start -b com.example.app -a EntryAbility

# ADB 无线连接
adb connect 192.168.1.100:5555
adb disconnect 192.168.1.100:5555
adb devices

# ADB 应用管理
adb install app.apk
adb shell pm clear com.example.app
adb shell am force-stop com.example.app
```

## 项目结构

```
adhc/
├── src/
│   ├── extension.ts              # 主入口文件
│   ├── providers/
│   │   ├── wifiAdbProvider.ts    # 安卓设备提供者
│   │   ├── harmonyOSProvider.ts  # 鸿蒙设备提供者
│   │   └── sidebarTreeProvider.ts # 侧边栏树提供者
│   └── webviews/
│       ├── wifiAdbWebview.ts     # 安卓设备 WebView
│       └── harmonyOSWebview.ts   # 鸿蒙设备 WebView
├── media/
│   ├── icon.svg                  # 插件图标
│   └── logo.jpg                  # 插件 Logo
├── package.json                  # 项目配置
├── tsconfig.json                 # TypeScript 配置
├── LICENSE                       # MIT 许可证
└── README.md                     # 项目文档
```

## 🤝 参与贡献

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

## 📄 许可证

本项目采用 [MIT 许可证](LICENSE)

```
MIT License

Copyright (c) 2026 AdbHdc

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
```

## 📧 联系方式

- 仓库地址：https://gitee.com/qpcat/adhc.git
- 问题反馈：请在 Gitee 仓库提交 Issue

---

**Enjoy coding! 🚀**