在 Cursor 中运行 Android 项目指南
概述
Cursor 本身不支持直接运行 Android 应用 （不像 Android Studio 有内置的运行按钮），但你可以通过命令行工具来构建和运行项目。
前置要求
- ✅ Android SDK - 已配置（从
local.properties可以看到 SDK 路径） - ✅ Java JDK 11+ - 项目需要 Java 11
- ✅ Android 设备或模拟器 - 用于运行应用
方法 1：使用 Gradle 命令行（推荐）
步骤 1：检查设备连接
bash
# 检查是否有连接的设备或模拟器
adb devices如果没有设备，需要：
- 启动 Android 模拟器（通过 Android Studio 或命令行）
- 或连接真机并开启 USB 调试（详细步骤请查看 Android 真机 USB 调试指南）
步骤 2：构建并安装应用
在 Cursor 的终端中运行：
Windows (PowerShell):
powershell
# 构建 Debug APK
.\gradlew.bat assembleDebug
# 安装到设备
.\gradlew.bat installDebug
# 或者一步完成：构建并安装
.\gradlew.bat installDebugLinux/Mac:
bash
# 构建 Debug APK
./gradlew assembleDebug
# 安装到设备
./gradlew installDebug
# 或者一步完成：构建并安装
./gradlew installDebug步骤 3：启动应用
bash
# 启动应用的主 Activity
adb shell am start -n <package>/<activity>方法 2：使用 Android Studio（最简单）
虽然你在 Cursor 中编辑代码，但运行应用最简单的方式是：
- 在 Cursor 中编辑代码
- 打开 Android Studio
- 点击 "Run" 按钮（绿色播放图标）
Android Studio 会自动：
- 构建项目
- 安装到设备
- 启动应用
方法 3：使用 Cursor 的任务配置
你可以在 Cursor 中配置任务（Tasks），但我建议使用命令行脚本更简单。
常见问题
Q: 提示找不到 adb 命令？
A: 需要将 Android SDK 的 platform-tools 添加到 PATH：
powershell
# Windows PowerShell (临时)
$env:Path += ";D:\Android\SDK\platform-tools"Q: 提示找不到设备？
A:
- 检查模拟器是否启动：
adb devices - 检查 USB 调试是否开启（真机）- 详细步骤请查看 Android 真机 USB 调试指南
- 尝试重启 adb：
adb kill-server && adb start-server - 检查 USB 连接模式（选择"文件传输"而不是"仅充电"）
Q: 构建失败？
A:
- 检查网络连接（下载依赖）
- 清理构建：
.\gradlew.bat clean - 重新同步：
.\gradlew.bat --refresh-dependencies
Q: 可以在 Cursor 中看到界面预览吗？
A:
- ✅ 可以查看 HTML 预览：打开
layout_preview.html在浏览器中查看 - ❌ 不能像 Android Studio 那样实时预览 XML 布局
- ✅ 可以在 Android Studio 中打开项目查看布局预览
推荐工作流程
- 在 Cursor 中编辑代码 - 享受 AI 辅助编程
- 在 Android Studio 中运行和调试 - 使用专业的 Android 工具
- 使用 HTML 预览查看布局 - 快速查看界面效果
快速命令参考
bash
# 构建
.\gradlew.bat assembleDebug
# 安装
.\gradlew.bat installDebug
# 清理
.\gradlew.bat clean
# 查看设备
adb devices
# 启动应用
adb shell am start -n <package>/<activity>