# oh_tools

**Repository Path**: Cooper0/oh_tools

## Basic Information

- **Project Name**: oh_tools
- **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-08-18
- **Last Updated**: 2026-08-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 堆栈解析工具

Tauri v2 桌面应用，面向 OpenHarmony/HarmonyOS 开发调试场景，集成堆栈解析、反汇编、HDC 设备操作、本地文件夹并发拷贝等功能。

## 功能概览

| 页面 | 功能 | 说明 |
|------|------|------|
| 文本解析 | 堆栈解行号 | 粘贴堆栈文本，自动提取库名/偏移/BuildId，从 unstrip 目录查找 ELF，调用 llvm-addr2line 解析（含内联帧） |
| 文件解析 | 批量堆栈解析 | 选择含堆栈的文本文件，解析后写回原文件或新文件 |
| 反汇编 | ELF 反汇编 | 选择 ELF 文件，调用 llvm-objdump + llvm-cxxfilt 生成带源码注释的汇编 |
| HDC 工具 | 设备操作 | 连接 HDC 服务器，刷新设备列表，执行预置命令（hilog/selinux/设备信息等），文件推送/拉取 |
| 文件夹拷贝 | 并发拷贝 | 多线程并发拷贝本地文件夹（SMB/本地），实时显示进度，可取消 |

## 技术栈

- **后端**: Rust + Tauri v2（async 命令 + spawn_blocking）
- **前端**: 纯 HTML/CSS/JS（无框架）
- **嵌入工具**: llvm-addr2line / llvm-objdump / llvm-cxxfilt / llvm-readelf（include_bytes! 编译期嵌入，运行时提取）
- **HDC**: hdc_lib_rs（内嵌 hdc 二进制 + libusb）
- **并发拷贝**: threadpool（遍历线程独立于线程池，边遍历边拷贝）

## 平台支持

- **Linux**: x86_64-unknown-linux-gnu（原生编译）
- **Windows**: x86_64-pc-windows-gnu（Linux 交叉编译，mingw 工具链）

## 编译

### 环境准备

```bash
# 1. 安装 Tauri v2 系统依赖（Linux）
sudo apt install -y libwebkit2gtk-4.1-dev libgtk-3-dev libglib2.0-dev librsvg2-dev libsoup-3.0-dev libjavascriptcoregtk-4.1-dev libayatana-appindicator3-dev

# 2. 安装 Tauri CLI
cargo install tauri-cli --version "^2.0"

# 3. 安装 Windows 交叉编译目标
rustup target add x86_64-pc-windows-gnu

# 4. 准备 llvm 工具二进制
./setup-llvm.sh
```

### 编译命令

```bash
./build.sh              # 编译 Linux release
./build.sh windows      # 交叉编译 Windows release
./build.sh all          # 同时编译 Linux + Windows
./build.sh all --debug  # 全部用 debug profile
./build.sh all --dist   # 编译并打包分发压缩包
./build.sh --help       # 帮助菜单
```

### 产物

| 平台 | 路径 | 说明 |
|------|------|------|
| Linux | `target/release/tauri_test` | 单一二进制，内嵌全部工具 |
| Windows | `target/x86_64-pc-windows-gnu/release/tauri_test.exe` | 需同目录放 `WebView2Loader.dll` |

## 堆栈格式支持

### 格式 A（Android/OpenHarmony 风格）
```
#00 pc 000a7d3c /system/lib/ld-musl-arm.so.1(get_meta+92)(e7f9c7b2f43af570ea0042af00f4d899)
```
- 支持函数名含嵌套括号的 C++ 签名（如 `WriteBinder(unsigned long, void*)+66`）
- BuildId 可选，有则校验，无则按 basename 查找

### 格式 B（带 0x 地址 + BuildId 标签）
```
#0 0x651a5c0fa0  (/data/storage/el1/bundle/libs/arm64/libijk.so+0x2c0fa0) (BuildId: 84383086df874d94fa191ddbbc25091cc14992c5)
```

## 项目结构

```
tauri_test/
├── src/                     # 前端（HTML/CSS/JS）
│   ├── index.html           # 五个 Tab 页面
│   ├── main.js              # 事件绑定、invoke 调用
│   └── styles.css           # 深色主题
├── src-tauri/               # Rust 后端
│   ├── resources/{linux,windows}/  # 嵌入的 llvm 工具
│   └── src/
│       ├── commands.rs      # async Tauri 命令
│       ├── stack_parser.rs  # 堆栈解析
│       ├── elf_resolver.rs  # ELF 查找 + BuildId 校验
│       ├── addr2line.rs     # 解行号（--inlines 保留内联帧）
│       ├── objdump.rs       # 反汇编
│       ├── bin_manager.rs   # 工具嵌入/提取/子进程管理
        │       ├── hdc_tool/        # HDC 设备操作
        │       ├── dir_copy/        # 并发文件夹拷贝
        │       ├── edge_hide.rs     # 窗口靠边吸附隐藏（仅 Windows）
        │       └── logger.rs        # 日志系统
├── build.sh                 # 编译脚本
├── setup-llvm.sh            # llvm 工具准备
└── plant.md                 # 设计文档与进展记录
```

## 测试

```bash
cd src-tauri
cargo test --lib     # 单元测试
cargo clippy --lib   # 代码检查
```

## 依赖

- [Tauri v2](https://v2.tauri.app/) — 桌面应用框架
- [hdc_lib_rs](https://gitee.com/Cooper0/hdc_lib_rs) — HDC 设备通信库
- [threadpool](https://crates.io/crates/threadpool) — 线程池
- [anyhow](https://crates.io/crates/anyhow) — 错误处理
- [regex](https://crates.io/crates/regex) — 正则表达式
- [log](https://crates.io/crates/log) + [env_logger](https://crates.io/crates/env_logger) — 日志系统，落盘到 exe 同目录