188 lines
4.6 KiB
Markdown
188 lines
4.6 KiB
Markdown
# 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` → `⚡ 完整测试流程` |