如何在VSCode安装完毕后配置 Android 开发模拟器

酷晨吖_3720

酷晨吖_3720

2026-06-30

531人浏览

原创

vscode本身不支持直接安装或创建android模拟器,avd必须通过android studio安装sdk后由emulator可执行文件驱动;vscode仅能通过adb连接已启动的模拟器,需正确配置android_home和platform-tools路径,并手动刷新设备列表。

如何在vscode安装完毕后配置 android 开发模拟器

VSCode 本身不支持直接安装或创建 Android 模拟器

模拟器(AVD)不是 VSCode 的功能组件,它由 emulator 可执行文件驱动,而该文件属于 Android SDK 的 emulator 子目录,必须通过 Android Studio 安装完整 SDK 后才能获得。VSCode 插件无法下载系统镜像、生成 AVD 配置文件(~/.android/avd/xxx.avd/),也不能启动图形化模拟器界面。

你真正需要的是:先用 Android Studio 完成 AVD 创建和首次启动,再让 VSCode 通过 ADB 连接已运行的设备。

  • Android Studio 必须安装(哪怕只用来初始化模拟器)
  • 确保已安装对应 API 级别的 system-images(例如 system-images;android-34;google_apis;x86_64)
  • 不要尝试在 VSCode 里“新建 AVD”——所有相关插件(如 Android Tools for VS Code)调用的仍是 Android Studio 生成的配置

必须手动配置 ANDROID_HOME 和 platform-tools 路径

VSCode 的 Android 插件(如 Android Tools for VS Code 或官方 Android Development)依赖环境变量定位 ADB 和 emulator。如果路径错,adb devices 就会报 command not found 或连接超时。

关键路径示例(macOS/Linux):

export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/emulator

Windows 用户需在系统环境变量中设置 ANDROID_HOME,并在 Path 中添加:%ANDROID_HOME%\platform-tools 和 %ANDROID_HOME%\emulator。

  • platform-tools 提供 adb,用于设备通信
  • emulator 目录提供 emulator 命令,但 VSCode 不调用它来启动模拟器(仅部分插件支持“启动 AVD”菜单项,本质仍是 shell 调用)
  • 插件设置页里填的 adb.path 必须指向 adb 文件本身(如 /path/to/platform-tools/adb),不是目录

连接已启动的模拟器:adb connect 不适用,要用 adb devices 自动识别

模拟器启动后(无论用 Android Studio 还是命令行 emulator -avd Pixel_4_API_34),VSCode 并不会自动刷新设备列表。你得手动触发设备发现,或依赖插件的“Refresh Devices”按钮。

android-agent
android-agent

通过USB或网络使用GPT‑4o视觉控制真实Android手机,执行打开应用、输入、点击和自动化脚本等任务。

下载

常见错误现象:

  • adb devices 输出为空,但模拟器窗口已打开 → 检查 adb server 是否被第三方工具(如夜神、雷电)占用了 5037 端口
  • 设备显示为 offline → 模拟器尚未完成 boot,等 2–3 分钟再试;或执行 adb kill-server && adb start-server
  • 设备显示为 unauthorized → 模拟器弹出授权对话框没点“Allow”,或 USB 调试未开启(对模拟器通常无需此步,但某些镜像有例外)

Flutter 用户注意:flutter devices 依赖同一套 ADB,若它不显示设备,说明底层连接已断,不必单独排查 Flutter。

调试 Android 应用仍需外部构建,VSCode 不提供 Run 按钮

即使模拟器连上了、Logcat 能看了,VSCode 也无法一键编译 APK 并安装。它没有 Gradle Daemon 管理、APK 签名逻辑或 AndroidManifest.xml 变更监听能力。

最小可行流程(终端内执行):

./gradlew assembleDebug
adb install -r app/build/outputs/apk/debug/app-debug.apk
adb logcat *:S ActivityManager:I MyApp:D

插件能帮你做的是:

  • 点击 Logcat 输出中的日志行跳转到对应 Kotlin/Java 文件
  • 右键设备选择“Install APK”(需手动指定路径)
  • 用 Android Tools for VS Code 的 “Run on Device” 命令(本质是执行上述 adb install)

真正的瓶颈不在模拟器连接,而在构建链路——VSCode 没有 Android Studio 那套构建上下文感知能力,build.gradle.kts 里的 applicationId、compileSdk 错了,它不会提示你应用根本启不来。

相关专题

更多
vscode是什么_vscode怎么安装配置
vscode是什么_vscode怎么安装配置

VS Code(Visual Studio Code)是一款免费、开源的跨平台代码编辑器,由微软开发和维护。它被广泛用于软件开发和编程,支持多种编程语言和框架。VS Code 同时提供了丰富的功能和扩展性,使开发者可以高效地编写、编辑和调试代码。

2023.06.30

1335

18

vscode怎么运行代码
vscode怎么运行代码

vscode是一个运行于MacOS X、Windows和Linux之上的,针对于编写现代Web和云应用的跨平台源代码编辑器;vscode免费而且功能强大,对JavaScript和NodeJS的支持非常好,自带很多功能,例如代码格式化,代码智能提示补全、Emmet插件等。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.21

2812

3

vscode使用的框架介绍
vscode使用的框架介绍

VSCode是一款跨平台代码编辑器,它基于Electron框架和Monaco Editor构建。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1949

12

vscode一般用来写什么语言
vscode一般用来写什么语言

VSCode是一款功能强大的代码编辑器,支持多种编程语言和文件格式。它内置对 JavaScript、Python、Java、C++、TypeScript、HTML/CSS、Go 等语言的支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.14

1727

8

vscode可以写什么语言
vscode可以写什么语言

vscode是一款强大的代码编辑器,支持多种编程语言的开发。通过安装扩展,可以为 JavaScript/TypeScript、Python、Java、C#、PHP、Go、Ruby、Rust、HTML/CSS 等语言提供智能代码补全、调试和格式化等功能。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

2607

12

vscode中文设置方法
vscode中文设置方法

方法一:在设置页面中,搜索“locale”,并选择“zh-cn”。方法二:按“Ctrl Shift P”快捷键,输入“Configure Display Language”,将语言修改为“zh-cn”。如果上述方法无效,可考虑安装中文插件。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1818

14

vscode用途介绍
vscode用途介绍

Visual Studio Code(VSCode)是一款由 Microsoft 开发的多功能文本编辑器,适用于各种编程语言。作为一款开源软件,VSCode 拥有代码高亮、自动补全、调试、Git 集成等强大功能,成为程序员不可或缺的工具。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1242

10

vscode和visualstudio的区别
vscode和visualstudio的区别

Visual Studio是一款功能强大的集成开发环境(IDE),适用于专业开发人员进行复杂项目的构建。而VSCode则是一款轻量级的代码编辑器,更适合各种规模的项目开发。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

1116

8

vscode设置中文界面不生效解决方法
vscode设置中文界面不生效解决方法

vscode设置中文界面不生效解决方法:安装中文语言包、通过命令面板设置语言、检查 locale.json 设置、重新安装中文语言包、检查 VSCode 版本和更新、排除插件冲突、检查系统语言设置、查看 VSCode 日志和错误消息、重置 VSCode 设置、查看官方文档和社区支持。想了解更多vscode的相关内容,可以阅读本专题下面的文章。

2024.03.15

474

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程