# 快速调试命令

## 一键编译安装启动（推荐）

直接双击运行：
```
build-install-debug.bat
```

---

## 单条命令版本（PowerShell）

在 PowerShell 中执行：
```powershell
cd C:\Users\dong\Desktop\rwadurian\backend\mpc-system\services\service-party-android; .\gradlew.bat assembleDebug --no-daemon; if ($?) { adb uninstall com.durian.tssparty 2>$null; adb install app\build\outputs\apk\debug\app-debug.apk; if ($?) { adb shell am start -n com.durian.tssparty/.MainActivity; adb logcat -c; Write-Host "`n[SUCCESS] 应用已启动，开始监控日志...`n" -ForegroundColor Green; adb logcat -v time MainViewModel:D TssRepository:D GrpcClient:D TssNativeBridge:D AndroidRuntime:E *:S } else { Write-Host "[ERROR] 安装失败！" -ForegroundColor Red } } else { Write-Host "[ERROR] 编译失败！" -ForegroundColor Red }
```

---

## 单条命令版本（CMD）

在 CMD 中执行（注意：日志需要在另一个窗口查看）：
```cmd
cd C:\Users\dong\Desktop\rwadurian\backend\mpc-system\services\service-party-android && gradlew.bat assembleDebug --no-daemon && adb uninstall com.durian.tssparty 2>nul && adb install app\build\outputs\apk\debug\app-debug.apk && adb shell am start -n com.durian.tssparty/.MainActivity && adb logcat -c && echo 应用已启动！现在打开另一个终端运行: adb logcat -v time MainViewModel:D TssRepository:D GrpcClient:D *:S
```

---

## 分步执行（更清晰）

### 终端 1: 编译安装启动

```cmd
cd C:\Users\dong\Desktop\rwadurian\backend\mpc-system\services\service-party-android

:: 1. 编译
gradlew.bat assembleDebug --no-daemon

:: 2. 卸载旧版本
adb uninstall com.durian.tssparty

:: 3. 安装
adb install app\build\outputs\apk\debug\app-debug.apk

:: 4. 启动
adb shell am start -n com.durian.tssparty/.MainActivity

:: 5. 清除旧日志
adb logcat -c
```

### 终端 2: 查看日志

```cmd
:: 实时查看关键日志
adb logcat -v time MainViewModel:D TssRepository:D GrpcClient:D TssNativeBridge:D AndroidRuntime:E *:S
```

或者查看所有日志并过滤：
```cmd
adb logcat -v time | findstr /C:"MainViewModel" /C:"TssRepository" /C:"GrpcClient" /C:"Exception" /C:"Error"
```

---

## 保存日志到文件

```cmd
:: 清除旧日志
adb logcat -c

:: 开始录制日志（在后台）
start /B adb logcat -v time > android_debug_%date:~0,4%%date:~5,2%%date:~8,2%_%time:~0,2%%time:~3,2%.log

:: 操作应用（重现问题）

:: 停止录制（关闭 adb logcat 进程）
taskkill /F /IM adb.exe

:: 查看日志文件
dir android_debug_*.log
```

---

## 快速重启应用（不重新编译）

```cmd
adb shell am force-stop com.durian.tssparty && adb shell am start -n com.durian.tssparty/.MainActivity
```

---

## 调试技巧

### 1. 查看应用是否在运行
```cmd
adb shell ps | findstr tssparty
```

### 2. 查看应用版本信息
```cmd
adb shell dumpsys package com.durian.tssparty | findstr version
```

### 3. 清除应用数据（重置应用）
```cmd
adb shell pm clear com.durian.tssparty
```

### 4. 查看应用崩溃日志
```cmd
adb logcat -v time AndroidRuntime:E *:S
```

### 5. 查看特定标签日志
```cmd
adb logcat -v time -s MainViewModel
```

### 6. 搜索日志中的关键词
```cmd
adb logcat -v time | findstr "session_started"
adb logcat -v time | findstr "Exception"
adb logcat -v time | findstr "Error"
```

---

## 故障排除

### 问题1: adb: command not found

**解决**: 添加 Android SDK platform-tools 到 PATH
```cmd
set PATH=%PATH%;C:\Users\dong\AppData\Local\Android\Sdk\platform-tools
```

### 问题2: INSTALL_FAILED_UPDATE_INCOMPATIBLE

**解决**: 卸载旧版本
```cmd
adb uninstall com.durian.tssparty
```

### 问题3: 设备未授权 (device unauthorized)

**解决**:
1. 手机上会弹出"允许USB调试"提示，点击"允许"
2. 如果没弹出，重新连接USB并执行：
```cmd
adb kill-server
adb start-server
adb devices
```

### 问题4: 多个设备连接

**解决**: 指定设备
```cmd
adb devices
adb -s <设备序列号> install app\build\outputs\apk\debug\app-debug.apk
```

---

## 推荐工作流

1. **首次运行**: 使用 `build-install-debug.bat`
2. **代码修改后**: 使用 `build-install-debug.bat`
3. **仅重启应用**: 使用快速重启命令
4. **查看历史日志**: 使用保存日志到文件