Skip to main content
本指南适用于主机设置路径。如果您直接在开发套件上运行 VS Code，请改为参阅在设备上运行扩展 — 套件已完成烧录和配置，因此本向导不适用。

​
前提条件

开始本指南前请完成以下设置步骤：

安装 Visual Studio Code

在 Ubuntu 或带 WSL 的 Windows 上设置 VS Code。

安装扩展

从 Qualcomm Software Center 下载 .vsix 并在 VS Code 中安装。

配置 udev 规则

在 Linux 主机上允许 EDL 的 USB 访问。

USB 转发（WSL）

使用 usbipd 将设备从 Windows 转发到 WSL。
继续之前，请确认 Qualcomm 扩展图标在 VS Code 活动栏中可见，且 Home 页面加载并显示 Get Started 按钮。

​
第 1 步 — 运行入门向导

在 Home 页面点击 Get Started 启动设置向导。 Home 页面上的 Get Started 按钮 向导通过 5 个步骤配置您的主机和开发套件：

第 1 步 — 开发套件

选择您要作为目标的开发套件。如果设备已通过 USB 连接，扩展会检测并预选它。您也可以选择尚未物理连接的套件。向导 — 开发套件选择
Qualcomm Device Cloud 支持 — 在云端托管设备上开发和调试 — 即将推出。
设备没有出现？请检查 USB 线缆、检查 lsusb，并确认已配置 udev 规则和 WSL USB 转发。
为所选开发套件选择目标操作系统。使用内联下拉菜单选择 Variant 和 Version。所选设备显示在右上角。向导 — 操作系统选择
向导会列出所选开发套件和操作系统可用的 SDK。使用内联下拉菜单选择版本。已预选适用于您主机架构（x86_64 或 arm64）的最新版本。向导 — SDK 选择
初始设置后要更改 SDK 版本，请转到 Dashboard → Downloads → SDK 标签页。
选择要在主机上安装的开发工具：向导 — 主机工具选择

主机软件

GCC 工具链和调试器。

VS Code 扩展

C/C++ IntelliSense、CMake Tools 及其他增强编辑器的扩展。
不确定时请保留默认设置。之后可以从 Dashboard → Downloads 添加更多工具。
某些工具需要提升的权限。请留意 VS Code 终端中的 sudo 密码提示（如被隐藏，请 View → Terminal）。
点击 Download & Install 获取并安装前面步骤中的所有内容。进度分四个部分显示：Operating System、SDK、Tools 和 Extensions。向导 — 下载与安装
如果磁盘上已有文件，可使用 Install from archive（操作系统）或 Install from zip（SDK）跳过下载。
下载期间请勿关闭 VS Code — 中断的安装可能会破坏工具链。请留意终端中的 sudo 提示。
安装后，所有软件都会出现在 Dashboard → Downloads 中：

​
第 2 步 — 激活设备

导航到 Device 部分，点击已连接设备旁的 Activate。这会将其设置为用于构建和烧录的_活动设备_。 可用设备列表 已激活的设备
对于运行 Ubuntu OS 的设备，请参阅 Ubuntu 设备设置部分。

​
第 3 步 — 烧录设备软件

打开 Dashboard → Downloads → Operating System 标签页，点击开发套件对应镜像旁的 Flash & Setup Device。 下载 — Operating System 标签页
烧录期间请勿断开设备连接。 中断的烧录可能使设备不稳定，恢复可能需要断电重启 + 手动进入 EDL + 重新烧录。

​
第 4 步 — 开发您的应用程序

导航到 Projects 浏览示例项目或从 SDK 导入模板。项目打开后 IntelliSense 会自动配置。 Projects — 最近的项目 使用状态栏按钮进行构建、部署、运行并选择目标设备：

Build

针对活动设备交叉编译应用程序。

Deploy

构建并将二进制文件推送到活动设备。

Run

在设备上执行已部署的二进制文件。

Refresh Device

重新扫描已连接的设备。

Select a Connected Device

选择要作为目标的已连接设备。
VS Code 状态栏 — Build、Deploy、Run、Refresh Device 和设备选择按钮
默认情况下，Deploy 将二进制文件安装到 /usr/bin，会覆盖设备上任何同名的现有二进制文件。