174 lines
4.2 KiB
Markdown
174 lines
4.2 KiB
Markdown
# 快速调试命令
|
||
|
||
## 一键编译安装启动（推荐）
|
||
|
||
直接双击运行：
|
||
```
|
||
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. **查看历史日志**: 使用保存日志到文件
|