如何在VS Code中把GitHub上的Kotlin项目运行到Android模拟器

1. 确认必备工具就绪 #

• 已安装Android SDK（若之前配置Kotlin环境时未安装，可通过VS Code的Android Extension Pack引导完成安装）
• VS Code中已安装以下插件：
  • Android Extension Pack（包含Android调试、模拟器管理等核心工具）
  • Kotlin（提供语法高亮、代码支持）
• 已创建可用的Android模拟器（可通过VS Code左侧「Android」面板创建，或使用avdmanager命令创建）

2. 导入GitHub项目 #

• 打开VS Code，点击左侧「源代码管理」图标，选择「克隆存储库」
• 输入GitHub项目的HTTPS/SSH地址，选择本地存储路径完成克隆
• 克隆完成后，点击「打开文件夹」，选中刚克隆的项目文件夹

3. 配置Android SDK路径 #

• 打开项目根目录下的local.properties文件（无则新建）
• 添加配置：sdk.dir=你的Android SDK本地路径（示例：Windows下C:\\Users\\你的用户名\\AppData\\Local\\Android\\Sdk，Mac下/Users/你的用户名/Library/Android/sdk）

4. 构建项目 #

• 打开VS Code终端（快捷键Ctrl+），在项目根目录执行构建命令：

  # Mac/Linux
  ./gradlew assembleDebug
  
  # Windows
  gradlew.bat assembleDebug
  

• 等待终端显示BUILD SUCCESSFUL即为构建完成

5. 运行到模拟器 #

• 启动目标模拟器（通过VS Code左侧「Android」面板的「Emulators」列表点击启动按钮）
• 点击VS Code右上角「运行和调试」图标，选择「Android App」作为调试配置（无此选项时系统会自动生成launch.json，直接确认即可）
• 点击绿色「启动调试」按钮，项目将自动安装并启动到模拟器

常见问题处理 #

• 构建失败：先检查local.properties的SDK路径是否正确，再根据终端报错信息调整build.gradle中的依赖版本或配置
• 模拟器连接失败：重启模拟器和VS Code，或在终端执行adb devices确认设备是否被识别

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