rwadurian/backend/mpc-system/services/service-party-android/QUICK_DEBUG_COMMANDS.md

4.2 KiB
Raw Blame History

快速调试命令

一键编译安装启动(推荐)

直接双击运行:

build-install-debug.bat

单条命令版本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 中执行(注意:日志需要在另一个窗口查看):

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: 编译安装启动

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: 查看日志

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

或者查看所有日志并过滤:

adb logcat -v time | findstr /C:"MainViewModel" /C:"TssRepository" /C:"GrpcClient" /C:"Exception" /C:"Error"

保存日志到文件

:: 清除旧日志
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

快速重启应用(不重新编译)

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

调试技巧

1. 查看应用是否在运行

adb shell ps | findstr tssparty

2. 查看应用版本信息

adb shell dumpsys package com.durian.tssparty | findstr version

3. 清除应用数据(重置应用)

adb shell pm clear com.durian.tssparty

4. 查看应用崩溃日志

adb logcat -v time AndroidRuntime:E *:S

5. 查看特定标签日志

adb logcat -v time -s MainViewModel

6. 搜索日志中的关键词

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

set PATH=%PATH%;C:\Users\dong\AppData\Local\Android\Sdk\platform-tools

问题2: INSTALL_FAILED_UPDATE_INCOMPATIBLE

解决: 卸载旧版本

adb uninstall com.durian.tssparty

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

解决:

  1. 手机上会弹出"允许USB调试"提示,点击"允许"
  2. 如果没弹出重新连接USB并执行
adb kill-server
adb start-server
adb devices

问题4: 多个设备连接

解决: 指定设备

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. 查看历史日志: 使用保存日志到文件