# 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. 添加自定义快捷键绑定

### 示例：添加快速日志查看快捷键
```json
[
    {
        "key": "ctrl+shift+l",
        "command": "workbench.action.terminal.sendSequence",
        "args": {
            "text": "adb logcat -d | grep -E \"(PiyoMood|AndroidRuntime)\" | tail -20\u000D"
        }
    }
]
```

---

## 📱 设备连接检查

### 检查设备状态
```bash
# 在终端中运行
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` → `⚡ 完整测试流程`