在VSCode中运行Google AR Core项目时./gradlew run提示任务不存在

问题原因 #

Android Gradle项目采用模块化结构，run任务默认不存在于根项目中——Android项目的运行相关逻辑都在app（或对应功能模块）下，且Android项目通常不使用run任务，而是通过安装APK到设备+启动Activity的流程完成运行。

解决办法 #

1. 直接执行模块安装+启动命令

在项目根目录执行以下命令，完成APK安装并启动主Activity：

./gradlew app:installDebug && adb shell am start -n com.google.ar.core.augmentedfaces/.MainActivity

注：如果包名或主Activity路径有修改，需要对应调整com.google.ar.core.augmentedfaces/.MainActivity部分，可查看app/src/main/AndroidManifest.xml里的package属性和主Activity的android:name确认。

2. 查看项目可用任务

执行以下命令列出所有Gradle任务，找到app模块下的Android相关任务（比如installDebug、uninstallDebug等）：

./gradlew tasks

你可以根据需要单独执行这些模块任务，再手动通过adb启动应用。

3. 使用VSCode Android插件简化操作

安装VSCode的「Android Extension Pack」插件，安装完成后：

• 点击左侧栏的Android图标
• 选择已连接的设备（或启动模拟器）
• 右键点击app模块，选择「Run App」即可自动完成安装和启动

4. 自定义根项目run任务（可选）

如果想让根项目支持./gradlew run，可以在根目录的build.gradle文件中添加自定义任务：

task run(type: Exec) {
    // 先完成app模块的Debug包安装
    dependsOn ':app:installDebug'
    // 启动主Activity
    commandLine 'adb', 'shell', 'am', 'start', '-n', 'com.google.ar.core.augmentedfaces/.MainActivity'
}

保存后，再执行./gradlew run即可正常运行项目。

补充说明 #

Android Studio能直接运行是因为它自动帮你完成了「选择模块→选择设备→执行安装任务→启动Activity」的完整流程，并非调用根项目的run任务。

内容的提问来源于stack exchange，提问作者Archiee