基础功能

NeuSAR Creator 提供了一系列的基础基于这些基础功能组成或直接实现了 NeuSAR Creator 强大的功能环境。主要功能域分为以下几个：

• 主题
• 设置
• 快捷键绑定
• 命令面板
• 任务系统
• 编辑器
• 运行
• 设备管理
• kit 管理
• sdk 安装
• 开发配置
• 工程管理操作

主题

NeuSAR Creator 可以修改用户界面中的主题，以适合您的工作环境。 打开主题选择框：

1. 点击 File
2. 点击 Preferences
3. 点击 Color Theme 弹出主题选择框

在选择框中点击想要的主题

设置

您可以根据自己的喜好通过其各种设置来配置 NeuSAR Creator：包括 NeuSAR Creator 编辑器、用户界面和功能行为等，几乎每个部分都有可以修改的选项。

设置编辑器

若要修改用户设置，你将使用设置编辑器查看和更改 NeuSAR Creator 设置。

1. 点击 File
2. 点击 Preferences
3. 点击Open Settings(UI)弹出设置编辑器，也可以使用键盘快捷键 （Ctrl+，）打开设置编辑器。

打开设置编辑器时，可以搜索并发现要查找的设置。当您使用搜索栏进行搜索时，它不仅会显示并突出显示与您的条件匹配的设置，还会过滤掉不匹配的设置。这使得查找设置变得快速而简单。 NeuSAR Creator 为设置提供了几个不同的作用域。打开工作区时，将至少看到以下两个作用域：

• User Settings - 全局应用于打开的任何 NeuSAR Creator 实例的设置。
• Workspace Settings - 设置存储在工作区内，并且仅在工作区打开时应用。

快捷键绑定

NeuSAR Creator 支持从键盘执行大多数任务，并支持更新它们。

快捷键编辑器

NeuSAR Creator 使用“键盘快捷键”编辑器提供丰富而简单的键盘快捷键编辑体验。它列出了所有带和不带键绑定的可用命令，您可以使用可用操作轻松更改/删除/重置其键绑定。

1. 点击 File
2. 点击 Preferences
3. 点击 Open Keyboards Shortcuts 弹出快捷键编辑器

它的顶部还有一个搜索框，可帮助您查找命令或键绑定。

命令面板

组合键 Ctrl+Shift+P 会显示命令面板，从这里，您可以访问 NeuSAR Creator 的所有功能，包括最常见操作的键盘快捷键。

任务系统

命令系统扩展了从命令行运行自动执行任务的能力。NeuSAR Creator 支持将对应的的任务配置为运行脚本或启动进程，从而在 NeuSAR Creator 中使用现有工具，而无需输入任何命令行或编写新代码。在工作区文件中通过 tasks.json 文件配置任务信息。 打开 tasks.json:

task 的属性具有以下语义：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "echo",
            "type": "shell",
            "command": "echo Hello"
        }
    ]
}

编辑器

键盘快捷方式

编写代码时能够将手放在键盘上对于提高工作效率至关重要。NeuSAR Creator 编辑器具有一组丰富的默认键盘快捷方式，并允许自定义它们。

保存

默认情况下，编辑器需要一个显式操作来将更改保存到磁盘 Ctrl+S。 同时编辑器也支持配置的延迟后或焦点离开编辑器时保存您的更改。启用此选项后，无需显式保存文件。打开“自动保存”的最简单方法是使用“File>Auto Save”开关，该开关在延迟后打开和关闭保存。

查找和替换

NeuSAR Creator 允许您在当前打开的文件中快速查找文本和替换。按 Ctrl+F 在编辑器中打开查找文件，搜索结果将在编辑器，概览标尺和小地图中突出显示。 如果当前打开的文件中有多个匹配的结果，则可以按 Enter 和 Shift+Enter，在查找输入框聚焦时导航到下一个或上一个结果。

格式化

NeuSAR Creator 有两种格式化操作 :

• 文件格式化 (Shift+Alt+F) - 格式化当前文件。
• 选中格式化 (Ctrl+K Ctrl+F) - 格式化当前选中文本。

运行

NeuSAR Creator 支持调试操作，并且可以调试 c++ 代码。

断点调试

1.AP运行环境需要支持gdb；

2.将编译后的成果物中的debug.tgz进行解压，解压后得到{应用程序}.sym；

3.将{应用程序}.sym复制到运行环境的/opt/{应用程序}/bin下，注意：此.sym需要与本次编译的可执行程序bin文件一同编译出，以保持二者一致。

4.开启调试视图：

在NeuSAR Creator 侧面的活动栏中选择调试图标（也可以使用键盘快捷键 Ctrl+Shift+D），调试视图显示与运行和调试相关的所有信息，并具有一个包含调试命令和配置设置的顶栏。

5.调试配置：

（1）点击在运行视图中的调试配置按钮创建 launch.json 文件，就会创建一个选择对应的调试配置模板生成调试配置文件。

NeuSAR Creator 将调试配置信息保留在位于工作区（项目根文件夹）的配置信息文件夹或用户设置或工作区设置中的 launch.json 文件中，推荐使用：Launch over SSH。

（2）Launch.json 说明：

{
  // Use IntelliSense to learn about possible attributes.
  // Hover to view descriptions of existing attributes.
  "version": "0.2.0",
  "configurations": [
      {
          "type": "gdb", //调试配置类型通常为 gdb
          "request": "launch", //请求类型配置。 可以是 "launch" 或者 "attach"
          "name": "Launch Program (SSH)", //配置名称;将显示在启动配置下拉菜单中。
          "target": "bin/{应用名称}", //bin文件路径（重点配置项）
          "cwd": "/",               //默认按此配置
          "ssh": { 
              "host": "127.0.0.1", //AP运行环境主机地址（重点配置项）
              "cwd": "/opt/{应用名称}", //可执行程序路径（重点配置项）
              "user": "root", //用户名称
              "password": "",
              "sourceFileMap": { 
                  
              }
          },
          "valuesFormatting": "parseText" //设置显示变量值的方式。'disabled' - 按原样显示值， 'parseText' - 解析调试器将文本输出到结构中， 'prettyPrinters' - 启用调试器自定义漂亮的打印机（如果有的话）
      }
  ]
}

6.断点设置

可以通过单击编辑器边距或在当前行上使用 F9 来启用/禁用断点。更精细的断点控制（启用/禁用/重新应用）可以在“运行”视图的“断点”部分中完成。

编辑器边距中的断点通常显示为红色填充的圆圈。

禁用的断点具有填充的灰色圆圈。

当调试会话启动时，无法向调试器注册的断点将更改为灰色空心圆。

如果调试器支持中断不同类型的错误或异常，则这些错误或异常也将在“断点”视图中可用。

7.调试操作

调试前需要杀死正在运行的应用程序；

在“调试”启动视图上选择“运行和调试”，或按 F5，NeuSAR Creator 将尝试运行当前调试配置；

一旦开始调试, 一个调试工具栏将会出现在调试视图之中。

调试操作	快捷键
Continue / Pause	F5
Step Over	F10
Step Into	F11
Step Out	Shift+F11
Restart	Ctrl+Shift+F5
Stop	Shift+F5

设备管理

可配置设备相关信息：

设备信息	描述
Host	设备名称(自行设置，没有要求)
IP	设备的 IP 地址
User	此设备的用户名
Password	此设备的密码

kit 管理

可配置 kit 相关信息(通过设备管理)

kit 信息	描述
Name	Kit 名(自行设置，没有要求)
CompileDevice	选择现有编译设备
Compiler	填写编译器地址或者点击文件图标弹出下图并选择已选编译设备的路径
DeployDevice	填写成果物部署地址

sdk 安装

1. 单击弹框按钮
2. 单击 select 按钮选择安装包路径
3. 选择目标设备（设备管理中已配置设备）
4. 输入安装目标路径或者点击文件图标弹出下图并选择已选目标设备的路径
5. 单击 OK 按钮

开发配置

1. 点击 Develop Config 下的所需的工程
2. 点击 tool-chain 选择目标设备
3. Build Arguments 和 Clean Arguments 内容属于执行命令的参数,默认已填写好，无需更改
4. Build Directory 内容为当前设备所在的工程路径,默认已填写好，无需更改
5. Build Steps 和 Clean Steps 下的 Working Directory 路径为选定此设备工作的路径，自行填写或者点击文件图标弹出下图选择已选目标设备的路径，无要求限制
6. 选择是否开启 GENERAL
7. 增加 Deploy 配置
8. 输入 RootPath、NeuName、Version，选择启动方式 Reboot
9. 选择 Active、选择 Container、输入 Version、选择 SwcApplications
10. 添加发布文件
11. 选择 Target File Path 为当前设备要操作的目标文件所在的路径，也可点击文件图标弹出下图选择目标设备的路径
12. 选择 Remote Directory 为当前设备要操作的远程目标机器所在的路径，也可点击文件图标弹出下图选择目标设备的路径
13. 点击 Submit 按钮

工程管理操作

1. 左上角选择要实施编译部署清理的配置选项（ap 名称+kit 名称）
2. 最后可通过点击编译、清理、部署、暂停按钮进行相关操作并可在输出框查看相关信息