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

# 快速入门

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

<Info>
  本指南适用于**主机**设置路径。如果您直接在开发套件上运行 VS Code，请改为参阅[在设备上运行扩展](./setup-on-device/on-device) — 套件已完成烧录和配置，因此本向导不适用。
</Info>

## 前提条件

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

<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 主机上允许 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 步 — 运行入门向导

在 Home 页面点击 **Get Started** 启动设置向导。

<img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/stepper_get_started_button.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=d1f3b2cbab0a7459fa5d97751c48ce2b" alt="Home 页面上的 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-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/stepper_devkit_selection.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=da77813c3c05b4cffe9d961cd607bbdc" 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-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/stepper_osvariant_selection.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=027a845642a20a270f01d92295fa4250" 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-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/stepper_sdk_selection.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=540e5f7ea8ee52528b5f0efbfec02af9" 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-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/stepper_sw_selection.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=06f7c767074312f1398171359e9c7751" alt="向导 — 主机工具选择" width="1920" height="1140" data-path="Tools/QVSCE/images/stepper_sw_selection.png" />

    <CardGroup cols={2}>
      <Card title="主机软件" icon="terminal">
        GCC 工具链和调试器。
      </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-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/stepper_software_downloads.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=0e546bd9405e5b54a765415366a7c96c" 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 工具（GCC 工具链、调试器） |
    | Extensions | VS Code 扩展（C/C++、CMake Tools 等） |
  </Accordion>
</AccordionGroup>

***

## 第 2 步 — 激活设备

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

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

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

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

***

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

打开 **Dashboard → Downloads → Operating System 标签页**，点击开发套件对应镜像旁的 **Flash & Setup Device**。

<img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/dashboard_downloads_os.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=180bb5c2191d2d14f1f8b23aa60cb627" alt="下载 — 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-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/projects_recent.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=5682c7acb2720404cc054602c75df7a2" alt="Projects — 最近的项目" width="332" height="226" data-path="Tools/QVSCE/images/projects_recent.png" />

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

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

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

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

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

  <Card title="Select a Connected Device" icon="microchip">
    选择要作为目标的已连接设备。
  </Card>
</CardGroup>

<img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/status_bar_buttons.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=883ee243e36acdfa17551e9520c7415a" alt="VS Code 状态栏 — Build、Deploy、Run、Refresh Device 和设备选择按钮" width="1548" height="1016" data-path="Tools/QVSCE/images/status_bar_buttons.png" />

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