在 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 installDebug

Linux/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: 提示找不到设备？

检查模拟器是否启动：adb devices
检查 USB 调试是否开启（真机）- 详细步骤请查看 Android 真机 USB 调试指南
尝试重启 adb：adb kill-server && adb start-server
检查 USB 连接模式（选择"文件传输"而不是"仅充电"）

Q: 构建失败？

检查网络连接（下载依赖）
清理构建：.\gradlew.bat clean
重新同步：.\gradlew.bat --refresh-dependencies

Q: 可以在 Cursor 中看到界面预览吗？

✅ 可以查看 HTML 预览：打开 layout_preview.html 在浏览器中查看
❌ 不能像 Android Studio 那样实时预览 XML 布局
✅ 可以在 Android Studio 中打开项目查看布局预览

快速命令参考

bash 复制代码

# 构建
.\gradlew.bat assembleDebug

# 安装
.\gradlew.bat installDebug

# 清理
.\gradlew.bat clean

# 查看设备
adb devices

# 启动应用
adb shell am start -n <package>/<activity>

在 Cursor 中运行 Android 项目指南

在 Cursor 中运行 Android 项目指南

概述

前置要求

方法 1：使用 Gradle 命令行（推荐）

步骤 1：检查设备连接

步骤 2：构建并安装应用

步骤 3：启动应用

方法 2：使用 Android Studio（最简单）

方法 3：使用 Cursor 的任务配置

常见问题

Q: 提示找不到 adb 命令？

Q: 提示找不到设备？

Q: 构建失败？

Q: 可以在 Cursor 中看到界面预览吗？

推荐工作流程

快速命令参考