# utools-adb

**Repository Path**: fancy171101034/utools-adb

## Basic Information

- **Project Name**: utools-adb
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-09
- **Last Updated**: 2026-07-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# uTools ADB 工具

一个用于 uTools 的 ADB 工具插件。它把常用 Android 调试操作集中到一个窗口里，支持检测 ADB、识别设备、安装 APK、截图到桌面、执行常用命令和自定义命令。

![界面预览](public/demo.png)

## 功能

- 检测 `adb --version` 是否可用。
- 检测 `adb devices` 中可操作设备数量。
- 选择、拖入或通过 uTools 文件匹配安装 APK。
- 截图保存到电脑桌面。
- 通过 `scrcpy` 启动独立低延迟手机投屏窗口。
- 常用 ADB 操作：当前活动页、回到桌面、Wi-Fi 设置、系统设置、开发者选项。
- 输入框直接执行 `adb` 命令。
- 创建自定义按键，并保存到本地，下次打开仍然可见。
- ADB 不可用或设备为 0 时，禁用操作并提供处理引导。
- 左侧日志支持全选、复制和清理。
- 左右布局默认 3:7，中间分隔条可拖拽调整，右侧最小宽度 450px。

## 使用方式

1. 连接 Android 设备。
2. 打开手机开发者选项和 USB 调试。
3. 在手机授权弹窗中选择允许。
4. 打开 uTools，输入 `adb`、`安卓工具`、`安装apk` 或 `apk安装`。
5. 点击刷新，确认 ADB 可用且设备数量大于 0。
6. 使用右侧按钮或输入框执行 ADB 操作；点击“ADB 操作”旁的投屏图标可打开独立投屏窗口。

## APK 安装

支持三种入口：

- 点击插件内“安装 APK”选择本地 APK。
- 把 APK 文件拖到插件窗口内。
- 在系统里复制或选中 `.apk` 文件后打开 uTools，选择“安装到手机”。

## 自定义按键

在 ADB 操作区域点击“创建自定义”，填写名称、描述和命令。

要求：

- 命令必须以 `adb` 开头。
- 自定义按键会保存在本地。
- 内置按键不可编辑。
- 自定义按键可以右键编辑，编辑弹窗里可以删除。

示例：

```bash
adb shell getprop ro.serialno
adb shell wm size
adb shell dumpsys battery
```

## ADB 环境

插件会优先调用系统中可用的 `adb`，并兼容 macOS、Windows 和 Linux 常见安装位置。手机投屏依赖系统中可用的 `scrcpy`，请先安装并确保 uTools 进程可以访问。

常见路径：

- macOS: `/usr/local/bin/adb`
- macOS Apple Silicon: `/opt/homebrew/bin/adb`
- macOS Android SDK: `~/Library/Android/sdk/platform-tools/adb`
- Windows: `%LOCALAPPDATA%\Android\Sdk\platform-tools\adb.exe`
- Linux: `/usr/bin/adb`
- Linux Android SDK: `~/Android/Sdk/platform-tools/adb`

投屏依赖：

- macOS: `brew install scrcpy`
- Windows: 安装 scrcpy 后把 `scrcpy.exe` 所在目录加入 PATH
- Linux: 使用系统包管理器安装 `scrcpy`

如果终端能执行 `adb --version`，但插件显示 ADB 无效，请重新加载插件或重启 uTools，让 uTools 进程读取新的环境变量。

## 开发

```bash
npm install
npm run dev
```

uTools 开发模式入口在 `public/plugin.json`：

```json
{
  "development": {
    "main": "http://localhost:5173"
  }
}
```

## 构建

```bash
npm run build
```

构建产物输出到 `dist/`。