> ## 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.

# 示例项目

> 探索、导入并试验与设备预装应用相匹配的示例应用程序。

## 概述

**Projects** 部分列出随已安装 SDK 附带的所有项目模板。这些模板与设备上预装的示例应用程序相对应 — 是新应用程序的绝佳起点。

## 导入项目

<Steps>
  <Step title="打开 Projects 部分">
    导航到 **Dashboard → Projects**，或点击扩展侧边栏中的 **Projects**。点击 **Create New Project** 打开项目创建对话框。

    填写必填字段：

    * **Project Path** — 项目创建所在的目录
    * **Project Name** — 新项目文件夹的名称
    * **SDK** — 选择目标 Qualcomm SDK 和开发套件
    * **Template** — 选择起始模板（例如 New C/C++ Application）

    准备好后点击 **Create**。

    <img src="https://mintcdn.com/qualcomm-prod/C3kDUdllcH5eq3jY/Tools/QVSCE/images/projects_new.png?fit=max&auto=format&n=C3kDUdllcH5eq3jY&q=85&s=c2c3b4e82f78bb50d143d917e2992947" alt="Projects — 创建新项目对话框" width="537" height="473" data-path="Tools/QVSCE/images/projects_new.png" />
  </Step>

  <Step title="浏览模板列表">
    扩展会显示适用于您活动 SDK 的所有模板。每张卡片显示项目名称、描述和源代码语言。

    <img src="https://mintcdn.com/qualcomm-prod/RietNfmN9gs2vaJw/Tools/QVSCE/images/projects_samples.png?fit=max&auto=format&n=RietNfmN9gs2vaJw&q=85&s=bd4e9649c41d0a3f41fadcdbf90794db" alt="Projects — 示例项目模板" width="750" height="230" data-path="Tools/QVSCE/images/projects_samples.png" />
  </Step>

  <Step title="导入模板">
    在所需模板上点击 **Import**。项目将被克隆到磁盘上。

    <img src="https://mintcdn.com/qualcomm-prod/RietNfmN9gs2vaJw/Tools/QVSCE/images/projects_samples_imported.png?fit=max&auto=format&n=RietNfmN9gs2vaJw&q=85&s=a13a8d49f120f941db52dce647b7c7b3" alt="Projects — 已导入的项目" width="655" height="235" data-path="Tools/QVSCE/images/projects_samples_imported.png" />

    <Note>
      VS Code 打开该文件夹时，您会看到两个对话框：**"Do you trust the authors?"** 和 **"Reset workspace configuration?"** — 请都选择接受。
    </Note>
  </Step>
</Steps>

## IntelliSense — 自动配置的工作区

打开项目后，扩展会**自动生成**一个 `.vscode/` 文件夹并打开工作区：

<img src="https://mintcdn.com/qualcomm-prod/RietNfmN9gs2vaJw/Tools/QVSCE/images/projects_workspace.png?fit=max&auto=format&n=RietNfmN9gs2vaJw&q=85&s=d4b59b23100024b49e5e2e7f83bb00fb" alt="Projects — 自动配置的工作区" width="303" height="228" data-path="Tools/QVSCE/images/projects_workspace.png" />

生成的文件包括：

* `c_cpp_properties.json` — 将 IntelliSense 指向 SDK 头文件
* `tasks.json` — 连接到 SDK 工具链的构建任务
* `launch.json` — 针对活动设备的调试配置

<img src="https://mintcdn.com/qualcomm-prod/RietNfmN9gs2vaJw/Tools/QVSCE/images/projects_samples_loaded.png?fit=max&auto=format&n=RietNfmN9gs2vaJw&q=85&s=1032747d671b7011833de101dcaa8a3d" alt="Projects — 已加载项目并启用 IntelliSense" width="673" height="181" data-path="Tools/QVSCE/images/projects_samples_loaded.png" />

<Tip>
  `.vscode/` 文件夹中的工作区配置文件为自动生成。未经检查请勿将其提交到您的仓库 — 它们包含特定于您主机的绝对路径。
</Tip>

## 最近的项目

之前打开过的项目可以从 Projects 部分的网格中访问。

<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" />

## 修改与试验

项目打开后，您可以完全访问源代码。进行任何更改，然后使用状态栏操作重新构建和部署。

## 额外的二进制依赖项

某些示例应用程序会在构建或运行时从云端拉取大型二进制资产（模型权重、测试向量、媒体文件）。这由随项目附带的**清单文件**驱动。当您构建或运行应用时，扩展会自动处理这些下载。

## 重置项目

如果您想还原所有更改并重新开始：

1. 在 **Projects** 部分右键点击该项目。
2. 选择 **Reset Project**。

<img src="https://mintcdn.com/qualcomm-prod/RietNfmN9gs2vaJw/Tools/QVSCE/images/projects_samples_reset.png?fit=max&auto=format&n=RietNfmN9gs2vaJw&q=85&s=8d4c290d20eff4578f08ceb49cf0a1ad" alt="Projects — 重置项目选项" width="699" height="196" data-path="Tools/QVSCE/images/projects_samples_reset.png" />

<Warning>
  \*\*Reset Project 不可逆。\*\*所有未提交的修改都将丢失。
  重置前请提交或备份您想保留的任何工作。
</Warning>
