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

# 示例项目

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

## 概述

**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-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/projects_new.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=0cfb5475123c7c78ba6124fcb28e6361" alt="Projects — 创建新项目对话框" width="537" height="473" data-path="Tools/QVSCE/images/projects_new.png" />
  </Step>

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

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

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

    <img src="https://mintcdn.com/qualcomm-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/projects_samples_imported.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=8a7da0c61e9f8646af0469f8a2e19658" 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-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/projects_workspace.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=8217b8cd1131a85bb5cb6ba3721a99fa" 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-staging/IpOQZ3a456y-ntjm/Tools/QVSCE/images/projects_samples_loaded.png?fit=max&auto=format&n=IpOQZ3a456y-ntjm&q=85&s=af0f5dabe06788038a8ff070e846d62f" 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-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" />

## 修改和试验

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

## 附加的二进制依赖

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

## 重置项目

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

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

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

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