daodaoshi/chick_mood
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
chick_mood/VSCODE_QUICK_START.md
ddshi c9410395a7 完成基础模型和数据库
2025-10-23 09:07:24 +08:00

4.6 KiB
Raw Blame History

VSCode Android 开发快速开始指南

📋 前置条件

  1. 安装VSCode扩展：

    • Android
    • Gradle for Java
    • Android iOS Emulator (可选)

  2. 环境准备：

    • Android SDK已安装
    • ADB设备已连接
    • 项目已在VSCode中打开

🚀 快速使用

1. 构建和运行应用

方法一：使用命令面板 (推荐)

  • Ctrl + Shift + P 打开命令面板
  • 输入 Tasks: Run Task
  • 选择任务：
    • 🔨 构建Debug版本 - 仅构建
    • 📱 构建并安装应用 - 构建并安装
    • ⚡ 完整测试流程 - 构建→安装→启动→检查

方法二：使用快捷键

  • Ctrl + Shift + B - 构建项目
  • F5 - 启动调试

方法三：使用终端

  • `Ctrl + `` 打开集成终端
  • 直接输入命令（参考 VSCODE_ANDROID_COMMANDS.md）

2. 调试应用启动

使用调试面板：

  • Ctrl + Shift + D 打开调试面板
  • 选择配置：
    • 🚀 启动应用并调试
    • 📱 安装并启动应用
    • 🐛 调试应用启动过程
  • 点击绿色播放按钮开始

查看调试信息：

  • 调试控制台：Ctrl + Shift + Y
  • 集成终端：Ctrl +

3. 常用任务列表

开发流程任务

🔨 构建Debug版本              # 仅构建APK
📱 构建并安装应用              # 构建并安装到设备
🚀 启动应用测试               # 启动已安装的应用
⚡ 完整测试流程               # 一键：构建→安装→启动→检查

调试任务

🐛 查看应用崩溃日志           # 查看最近的崩溃信息
清除日志缓存                  # 清空logcat缓存
🧪 运行单元测试               # 运行所有单元测试

维护任务

🧹 清理项目                   # 清理构建缓存
📱 卸载应用                   # 从设备卸载应用
📊 查看应用内存使用           # 监控内存使用情况
🔍 查看应用进程状态           # 查看应用运行状态

🎯 推荐工作流程

日常开发

  1. 修改代码
  2. Ctrl + Shift + P → Tasks: Run Task → 🔨 构建Debug版本
  3. 等待构建完成
  4. Ctrl + Shift + P → Tasks: Run Task → 📱 构建并安装应用
  5. 在设备上测试功能

问题调试

  1. 复现问题
  2. Ctrl + Shift + P → Tasks: Run Task → 🐛 查看应用崩溃日志
  3. 分析日志，定位问题
  4. 修复代码
  5. 重新构建测试

快速测试

  1. 一键测试：Ctrl + Shift + P → Tasks: Run Task → ⚡ 完整测试流程
  2. 这会自动执行：构建→安装→启动→检查日志

🔧 自定义配置

添加新任务

  1. 编辑 .vscode/tasks.json
  2. 在 tasks 数组中添加新任务配置
  3. 重启VSCode或重新加载窗口 (Ctrl+Shift+P → "Developer: Reload Window")

修改快捷键

  1. 编辑 .vscode/keybindings.json (如果不存在则创建)
  2. 添加自定义快捷键绑定

示例：添加快速日志查看快捷键

[
    {
        "key": "ctrl+shift+l",
        "command": "workbench.action.terminal.sendSequence",
        "args": {
            "text": "adb logcat -d | grep -E \"(PiyoMood|AndroidRuntime)\" | tail -20\u000D"
        }
    }
]

📱 设备连接检查

检查设备状态

# 在终端中运行
adb devices

如果设备未显示

  1. 确保USB调试已开启
  2. 检查USB连接
  3. 重启ADB服务：adb kill-server && adb start-server
  4. 重新授权设备

🚨 常见问题解决

构建失败

  1. 运行 🧹 清理项目 任务
  2. 检查网络连接（下载依赖）
  3. 查看构建错误信息

安装失败

  1. 运行 📱 卸载应用 任务
  2. 重新运行 📱 构建并安装应用
  3. 检查设备存储空间

调试无响应

  1. 检查设备连接状态
  2. 重启VSCode
  3. 重启ADB服务

💡 实用技巧

批量操作

  • 可以在终端中同时运行多个命令
  • 使用 && 连接命令：./gradlew build && adb install -r ...

日志过滤

  • 应用相关：adb logcat | grep piyomood
  • 崩溃信息：adb logcat | grep -E "(FATAL|AndroidRuntime)"
  • 传感器：adb logcat | grep -i sensor

快速重启

  • 重启应用：adb shell am force-stop com.piyomood && adb shell monkey -p com.piyomood -c android.intent.category.LAUNCHER 1
  • 重启ADB：adb kill-server && adb start-server

📚 相关文件

  • VSCODE_ANDROID_COMMANDS.md - 完整命令参考
  • .vscode/tasks.json - VSCode任务配置
  • .vscode/launch.json - VSCode调试配置

祝你开发愉快！如有问题，请查看完整命令参考或联系开发团队。

快速测试快捷键: Ctrl + Shift + P → Tasks: Run Task → ⚡ 完整测试流程