新的介绍内容：

TASKING winIDEA Debug Extension for Visual Studio Code是一款专为Visual Studio Code设计的调试扩展工具，旨在帮助开发者在winIDEA工作空间中进行高效调试。通过此扩展，您可以轻松地在Visual Studio Code中使用winIDEA的强大功能，提升开发效率。

快速设置：

首次使用时，请按照"TASKING winIDEA入门指南"进行初始设置。如果安装扩展后指南未自动打开，您可以从欢迎页面或命令面板（Ctrl Shift p -> 欢迎：打开指南 -> TASKING winIDEA入门）中打开。指南将引导您完成必要组件的安装、打开示例工作空间，并尽快开始调试。

安装winIDEA：

要使此扩展正常工作，您需要安装winIDEA。要自动安装最新版本的winIDEA，请执行以下步骤：

1. 点击“运行和调试”选项卡
2. 点击winIDEA配置标题，打开下拉菜单
3. 点击三个点，并选择“下载最新版本的winIDEA”

此命令也可以从命令面板中调用。每当有更新可用或您尝试打开工作空间时，系统将提示您安装最新版本。

使用自定义winIDEA版本：

如果您希望使用已安装的winIDEA版本，可以设置扩展使用它：

1. 点击“运行和调试”选项卡
2. 点击winIDEA配置标题，打开下拉菜单
3. 点击三个点，并选择“选择自定义winIDEA安装路径”
4. 使用对话框导航到winIDEA安装目录，并选择winIDEA.exe

此命令也可以从命令面板中调用。

打开工作空间：

创建新工作空间：

1. 打开winIDEA配置视图
2. 如果已打开，当前winIDEA工作空间需先关闭
3. 如果您想创建一个空白工作空间：
   1. 点击“新建工作空间”按钮
   2. 按照新工作空间配置向导进行操作
   3. 将为您的硬件配置一个空白工作空间并打开
4. 如果您想从winIDEA示例工作空间开始：
   1. 点击“打开示例工作空间”按钮
   2. 选择适合您的目标示例
   3. 示例将被克隆并打开

打开现有winIDEA工作空间：

1. 打开winIDEA配置视图
2. 如果已打开，当前winIDEA工作空间需先关闭
3. 点击“选择工作空间”按钮
4. 选择您的winIDEA工作空间.xjrf文件
5. 系统将自动生成并打开一个为您的winIDEA工作空间配置的VS Code工作空间

您也可以直接在VSCode中打开.xjrf文件，并选择将其转换为VSCode工作空间。

开始调试：

要选择启动配置，请打开“运行和调试”选项卡，并使用左上角的下拉菜单。默认情况下，将提供两个启动配置：

1. winIDEA下载：此配置将下载配置的程序文件到目标，重置它并开始调试。
2. winIDEA重置：此配置仅重置目标，加载符号文件并开始调试，不下载程序文件。

您可以向.code-workspace文件中添加其他启动配置。您可以更改的其他参数包括：

• stopOnEntryAt：在开始调试时，运行程序直到此函数。
• verifyDownload：下载后验证程序。
• loadSymbolsOnly：设置为true以重置目标而不下载。

构建示例：

使用VS Code CMake的示例可以通过CMake Tools扩展进行构建。CMake和Ninja将自动安装和设置，您只需设置编译器文件夹的路径。

Linux使用：

• 要使用通过snap安装的winIDEA，请将自定义安装设置为true，并将winIDEA路径设置为全局。
• 第一次启动winIDEA可能会因wine设置时间过长而超时，再次打开工作空间应可解决此问题。

调试功能：

winIDEA配置视图：

此视图包含winIDEA中所有可用的切换和配置窗口，组织在树视图中。点击保存按钮保存，点击X按钮保存并关闭工作空间，如果您想打开不同的工作空间。

标题栏中的下拉菜单列出了一些有用的命令，如打开日志、打开扩展设置、打开符号浏览器等。

如果未打开工作空间，此视图将包含按钮以打开或创建工作空间。使用：

• 打开工作空间以打开当前配置的工作空间文件，
• 选择工作空间以选择并打开现有的.xjrf工作空间文件，
• 新建工作空间以创建新工作空间，或
• 打开示例工作空间以从winIDEA示例工作空间中创建工作空间。

扩展设置：

要打开winIDEA扩展的设置，请在winIDEA配置视图中打开下拉菜单并选择“打开扩展设置”。这将列出所有全局设置（在用户标签下）和当前工作空间的设置（在工作空间标签下）。一些值得注意的设置包括：

• 命令行选项：在启动连接时将这些选项传递给winIDEA。
• 步进时刷新SFR：每当数据可能发生变化时，自动刷新SFR视图。这可能会对性能产生负面影响。
• 显示窗口：在vscode旁边显示winIDEA GUI。

其他选项将使用其他命令自动设置。

查看日志文件：

• 可以通过输出视图查看扩展的日志输出（视图 -> 打开视图 -> 输出），选择winIDEA调试。
• 未处理的异常将报告到输出视图，扩展主机。
• 可以通过命令面板打开winIDEA的日志输出：打开winIDEA日志。
• 可以通过命令面板打开调试适配器的日志输出：打开调试适配器日志。

SFRs视图：

此视图包含所有可用SFRs的列表。

注意：默认情况下，SFR视图不会在每次步进时更新！ 请确保刷新它以确保您获得最新值，或者将您要监控的SFRs移动到监视视图。您也可以在设置中启用自动刷新，但这可能会对性能产生负面影响。

• 要刷新所有值，请点击视图右上角的刷新图标。
• 点击一个组应会展开它，加载所有子项及其值。
• 要编辑SFR，请点击旁边的编辑图标。您也可以使用F2编辑最后选定的值。
• 右键点击 -> 添加到监视将添加所选SFR到监视视图，以便更轻松地监控。

会话浏览器视图：

列出所有配置的SMPs、它们的核心及其状态。点击一个核心以将调试焦点切换到它。

实时监视视图：

实时监视视图中的变量将每秒更新一次。要添加变量，请点击视图上的按钮，或右键点击变量/代码并选择“添加到实时监视”。

调试内存视图：

调试内存视图由TASKING Hex Editor扩展实现，应自动安装。要打开它，请使用“打开调试内存”命令，或使用任何视图中变量旁边的“查看二进制数据”按钮。

• 要转到特定内存位置，请使用内存视图标题栏中的“转到偏移”按钮，并输入所需偏移。
• 要转到内存中的特定变量，请使用变量旁边的“查看二进制数据”按钮，或使用内存视图标题栏中的“转到变量”按钮，并输入所需变量。下拉菜单将列出变量视图中可见的变量，因此请在使用前展开全局变量。

您还可以使用视图编辑调试内存：将您的更改写入内存视图，然后保存以将更改写入目标。

变量和核心寄存器视图：

全局变量、局部变量和寄存器列在变量视图中，允许监控、编辑、添加到监视视图和在调试内存中查看。

源文件：

在加载的脚本视图中查看所有加载的源文件。

符号：

使用命令面板（Ctrl Shift P）并启动TASKING winIDEA：浏览符号命令以查看所有加载的符号。该命令也可以从winIDEA配置视图的下拉菜单中运行。

硬件断点：

使用命令面板（Ctrl Shift P）并启动TASKING winIDEA：设置硬件断点命令。此命令仅在调试时可用。该命令也可以从winIDEA配置视图的下拉菜单中运行。

数据/遥测：

此扩展收集使用数据并将其发送给Microsoft，以帮助我们改进产品和服务。遥测的收集通过Visual Studio Code提供的相同设置进行控制：“telemetry.enableTelemetry”。阅读隐私声明以了解更多信息。