> ## Documentation Index
> Fetch the complete documentation index at: https://dragonwingdocs.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 快速入门

> 在几分钟内从零开始，在您的 Qualcomm® 开发套件上运行应用程序。

## 前提条件

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

<CardGroup cols={2}>
  <Card title="安装 Visual Studio Code" icon="code" href="./setup/install-vscode">
    在 Ubuntu 或带 WSL 的 Windows 上安装 VS Code。
  </Card>

  <Card title="安装扩展" icon="puzzle-piece" href="./setup/install-extension">
    从 Qualcomm Software Center 下载 `.vsix` 并在 VS Code 中安装。
  </Card>

  <Card title="配置 udev 规则" icon="sliders" href="./setup/udev-rules">
    在 Linux 主机上为 ADB 和 EDL 允许 USB 访问。
  </Card>

  <Card title="USB 转发（WSL）" icon="usb" href="./setup/wsl-usb">
    使用 usbipd 将设备从 Windows 转发到 WSL。
  </Card>
</CardGroup>

<Check>
  继续之前，请确认 Qualcomm 扩展图标显示在 VS Code 活动栏中，且 **Home** 页面加载并显示 **Get Started** 按钮。
</Check>

***

## 第 1 步 — 运行入门向导

在主页上点击 **Get Started** 启动设置向导。

<img src="https://mintcdn.com/qualcomm-prod/ajmq44Q1W0vLtUT4/Tools/QVSCE/images/stepper_get_started_button.png?fit=max&auto=format&n=ajmq44Q1W0vLtUT4&q=85&s=ee9cd330a690de36a5589f7974e10e2a" alt="主页上的 Get Started 按钮" width="858" height="427" data-path="Tools/QVSCE/images/stepper_get_started_button.png" />

向导通过 5 个步骤配置您的主机和开发套件：

<AccordionGroup>
  <Accordion title="步骤 1 — 开发套件" icon="server" defaultOpen="true">
    选择您要面向的开发套件。如果设备已通过 USB 连接，扩展会检测并预先选中它。您也可以选择尚未实际连接的套件。

    <img src="https://mintcdn.com/qualcomm-prod/ajmq44Q1W0vLtUT4/Tools/QVSCE/images/stepper_devkit_selection.png?fit=max&auto=format&n=ajmq44Q1W0vLtUT4&q=85&s=04d5bc4ee5c1cdcd27d25678abec9ced" alt="向导 — 开发套件选择" width="1920" height="1140" data-path="Tools/QVSCE/images/stepper_devkit_selection.png" />

    <Tip>
      **Qualcomm Device Cloud** 支持 — 在云端托管设备上开发和调试 — 即将推出。
    </Tip>

    <Warning>
      设备未显示？请检查 USB 线缆，运行 `lsusb`，并确认已配置 [udev 规则](./setup/udev-rules)和 [WSL USB 转发](./setup/wsl-usb)。
    </Warning>
  </Accordion>

  <Accordion title="步骤 2 — 操作系统" icon="circle-half-stroke">
    为所选开发套件选择目标操作系统。使用内联下拉菜单选择 **Variant** 和 **Version**。所选设备显示在右上角。

    <img src="https://mintcdn.com/qualcomm-prod/ajmq44Q1W0vLtUT4/Tools/QVSCE/images/stepper_osvariant_selection.png?fit=max&auto=format&n=ajmq44Q1W0vLtUT4&q=85&s=45e6bb5c79333c3df9e169f49cf4c95d" alt="向导 — 操作系统选择" width="1920" height="1140" data-path="Tools/QVSCE/images/stepper_osvariant_selection.png" />
  </Accordion>

  <Accordion title="步骤 3 — SDK" icon="box">
    向导会列出适用于所选开发套件和操作系统的 SDK。使用内联下拉菜单选择版本。系统会预先选中适用于您主机架构（x86\_64 或 arm64）的最新版本。

    <img src="https://mintcdn.com/qualcomm-prod/ajmq44Q1W0vLtUT4/Tools/QVSCE/images/stepper_sdk_selection.png?fit=max&auto=format&n=ajmq44Q1W0vLtUT4&q=85&s=43f3db63fc227e61bab50a3a7c8b8f20" alt="向导 — SDK 选择" width="1920" height="1140" data-path="Tools/QVSCE/images/stepper_sdk_selection.png" />

    <Note>
      如需在初始设置后更改 SDK 版本，请前往 **Dashboard → Downloads → SDK 选项卡**。
    </Note>
  </Accordion>

  <Accordion title="步骤 4 — 主机工具" icon="wrench">
    选择要安装到主机上的开发工具：

    <img src="https://mintcdn.com/qualcomm-prod/ajmq44Q1W0vLtUT4/Tools/QVSCE/images/stepper_sw_selection.png?fit=max&auto=format&n=ajmq44Q1W0vLtUT4&q=85&s=b12e15af3e98fb91c38aa13c38b85479" alt="向导 — 主机工具选择" width="1920" height="1140" data-path="Tools/QVSCE/images/stepper_sw_selection.png" />

    <CardGroup cols={2}>
      <Card title="主机软件" icon="terminal">
        ADB、GCC 工具链和调试器。ADB 为必选项，无法取消选择。
      </Card>

      <Card title="VS Code 扩展" icon="puzzle-piece">
        C/C++ IntelliSense、CMake Tools 以及其他增强编辑器功能的扩展。
      </Card>
    </CardGroup>

    <Tip>
      如不确定，请保留默认选项。之后可从 **Dashboard → Downloads** 添加更多工具。
    </Tip>

    <Warning>
      部分工具需要提升权限。请留意 **VS Code 终端**中的 `sudo` 密码提示（如被隐藏，请通过 **View → Terminal** 打开）。
    </Warning>
  </Accordion>

  <Accordion title="步骤 5 — 下载" icon="download">
    点击 **Download & Install**，获取并安装前面步骤中选定的所有内容。进度分为四个部分显示：**Operating System**、**SDK**、**Tools** 和 **Extensions**。

    <img src="https://mintcdn.com/qualcomm-prod/ajmq44Q1W0vLtUT4/Tools/QVSCE/images/stepper_software_downloads.png?fit=max&auto=format&n=ajmq44Q1W0vLtUT4&q=85&s=84c637446174ef368318e51fd4c731a2" alt="向导 — 下载与安装" width="1920" height="1140" data-path="Tools/QVSCE/images/stepper_software_downloads.png" />

    <Tip>
      如果磁盘上已有相关文件，可使用 **Install from archive**（操作系统）或 **Install from zip**（SDK）跳过下载。
    </Tip>

    <Warning>
      下载期间**请勿关闭 VS Code** — 中断的安装可能损坏工具链。请留意终端中的 `sudo` 提示。
    </Warning>

    安装完成后，所有软件都会显示在 **Dashboard → Downloads** 中：

    | 选项卡              | 内容                              |
    | ---------------- | ------------------------------- |
    | Operating System | 适用于您开发套件的操作系统镜像 — 可直接从此处烧录      |
    | SDKs             | 主机端库和头文件 — 安装后配置设备              |
    | Tools            | CLI 工具（ADB、GCC 工具链、调试器）         |
    | Extensions       | VS Code 扩展（C/C++、CMake Tools 等） |
  </Accordion>
</AccordionGroup>

***

## 第 2 步 — 激活您的设备

导航至 **Device** 部分，点击已连接设备旁的 **Activate**。这会将其设置为用于构建和烧录的\_活动设备\_。

<img src="https://mintcdn.com/qualcomm-prod/RietNfmN9gs2vaJw/Tools/QVSCE/images/devices_available.png?fit=max&auto=format&n=RietNfmN9gs2vaJw&q=85&s=86c20a8929cc42318d85393ed1b54212" alt="可用设备列表" width="670" height="199" data-path="Tools/QVSCE/images/devices_available.png" />

<img src="https://mintcdn.com/qualcomm-prod/RietNfmN9gs2vaJw/Tools/QVSCE/images/devices_active.png?fit=max&auto=format&n=RietNfmN9gs2vaJw&q=85&s=22d4796b9b434d0a565d33420f4fc6fa" alt="已激活的设备" width="654" height="346" data-path="Tools/QVSCE/images/devices_active.png" />

<Note>
  对于运行 Ubuntu 操作系统的设备，请参阅 [Ubuntu 设备设置](./setup/install-vscode#ubuntu-device-setup)部分。
</Note>

***

## 第 3 步 — 烧录设备软件

打开 **Dashboard → Downloads → Operating System 选项卡**，点击适用于您开发套件的镜像旁的 **Flash & Setup Device**。

<img src="https://mintcdn.com/qualcomm-prod/C3kDUdllcH5eq3jY/Tools/QVSCE/images/dashboard_downloads_os.png?fit=max&auto=format&n=C3kDUdllcH5eq3jY&q=85&s=ef4dce200d2a521fba286a4ba371553d" alt="Downloads — Operating System 选项卡" width="1569" height="378" data-path="Tools/QVSCE/images/dashboard_downloads_os.png" />

<Warning>
  \*\*烧录期间请勿断开设备连接。\*\*烧录中断可能导致设备不稳定，可能需要重新上电 + 手动进入 EDL + 重新烧录才能恢复。
</Warning>

***

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

导航至 **Projects**，浏览示例项目或从 SDK 导入模板。打开项目后会自动配置 IntelliSense。

<img src="https://mintcdn.com/qualcomm-prod/RietNfmN9gs2vaJw/Tools/QVSCE/images/projects_recent.png?fit=max&auto=format&n=RietNfmN9gs2vaJw&q=85&s=135cdf6885aa499bfdf9a802b1a51e15" alt="Projects — 最近的项目" width="332" height="226" data-path="Tools/QVSCE/images/projects_recent.png" />

使用**状态栏按钮**来构建、部署、运行并选择目标设备：

<CardGroup cols={3}>
  <Card title="构建" icon="hammer">
    为活动设备交叉编译应用程序。
  </Card>

  <Card title="部署" icon="rocket">
    构建并将二进制文件推送到活动设备。
  </Card>

  <Card title="运行" icon="play">
    在设备上执行已部署的二进制文件。
  </Card>

  <Card title="刷新设备" icon="arrows-rotate">
    重新扫描已连接的设备。
  </Card>

  <Card title="选择已连接的设备" icon="microchip">
    选择要面向的已连接设备。
  </Card>
</CardGroup>

<img src="https://mintcdn.com/qualcomm-prod/C3kDUdllcH5eq3jY/Tools/QVSCE/images/status_bar_buttons.png?fit=max&auto=format&n=C3kDUdllcH5eq3jY&q=85&s=d61c51a239243b544eb62d961d4e973b" alt="VS Code 状态栏 — 构建、部署、运行、刷新设备和设备选择器按钮" width="1548" height="1016" data-path="Tools/QVSCE/images/status_bar_buttons.png" />

<Warning>
  默认情况下，**Deploy** 会将二进制文件安装到 `/usr/bin`，并覆盖设备上任何同名的现有二进制文件。
</Warning>