extensions-repo/user-guide/files/C-C++开发.md

C-C++开发

• 1.环境准备
• 2.C/C++项目(工程)操作
• 3.编辑、构建、调试、运行配置

1.环境准备

1.1 通过开发环境快速部署安装

• 点击帮助菜单中的“打开开发环境快速部署”子菜单，选择C/C++选项进行安装，将安装系统软件源中的编译调试工具和C/C++基础支持插件
• 具体可参考开发环境快速部署章节

1.2 手动安装

1.2.1 安装C/C++基础支持插件

• 编辑支持：Kylin Clangd插件(该插件为C/C++提供补全、导航和检查等语法功能，kylinideteam.vscode-clangd)

  • 插件安装方法如下，或参考如何检索和安装插件章节，其他插件安装方法类似，不再赘述
    • 启动IDE基础平台
    • 点击活动栏中的插件图标，调出插件视图
    • 在插件视图中找到KYLIN-IDE推荐的插件，选择Kylin-IDE(KylinCode)插件分类->C语言支持
    • 点击Kylin Clangd进行安装

• 调试支持：C/C++ Debug(gdb)插件 或 Kylin Native Debug插件

  • C/C++ Debug(gdb)插件（kylinideteam.cppdebug）
    • 优点：调试功能体验优于Kylin Native Debug
    • 缺点：插件体积大，下载慢，最好直接从仓库下载；仅支持X86和ARM架构
  • Kylin Native Debug插件（kylinideteam.debug）
    • 优点：支持架构多，包括X86、ARM、LoongArch等；插件体积小，下载快
    • 缺点：调试功能相比C/C++ Debug插件略有不足
  • 建议X86、ARM架构优先使用C/C++ Debug(gdb)插件；其他架构使用Kylin Native Debug插件；资源受限条件下使用Kylin Native Debug插件

• 项目创建

  • Kylin Project Manager插件（kylinideteam.project-manager）：提供基础项目创建功能，提供项目操作列表以方便执行配置、构建、调试、运行等操作

• CMake工程支持

  • CMake Tools插件（ms-vscode.cmake-tools）：推荐使用的开源插件，自动配置CMake项目的编辑、构建、调试，通过菜单方便操作
  • CMake插件（twxs.cmake）：推荐使用的开源插件，CMake Tools插件依赖插件，安装CMake Tools插件后，会自动下载安装该插件
  • CMake IntelliSence插件（kylinideteam.cmake-intellisence）：自研插件，对CMake语法支持更佳

• 若开发Qt工程，请参考Qt开发支持章节

1.2.2 安装系统软件依赖

• 安装clangd（Kylin Clangd代码编辑插件依赖）
  • 命令举例：apt install clangd或yum install clang-tools-extra
  • 建议尽量安装较新版本，功能更强。目前系统默认安装clangd-10，可以手动安装更新版本，例如sudo apt install clangd-11
• 安装编译构建工具
  • 命令举例：apt install build-essential cmake ninja-build或yum install gcc gcc-c++ cmake ninja-build
• 安装gdb（调试插件依赖）
  • 命令举例：apt install gdb或yum install gdb

2.C/C++项目(工程)操作

2.1 已有项目

• 对于已有项目，在IDE基础平台中中打开项目文件夹
  • 点击文件主菜单 -> 打开文件夹

2.1 新建项目

• 安装Kylin Project Manager插件(安装方法见上文)
• 新建项目方法见项目管理章节

3.编辑、构建、调试、运行配置

• 编辑支持需要了解Kylin Clangd插件和系统软件clangd的基本配置方法，具体见如下章节
  • 任意C/C++工程，如何使跳转等编辑功能正常工作（clangd）
• 项目的构建、调试、运行配置请参考以下章节
  • 如何配置工程的构建、调试、运行
• C/C++ Debug(gdb)插件 和 Kylin Native Debug插件的launch.json具体如何配置，见插件readme
  • 在最左侧点击插件图标，打开插件视图，在列表中找到插件条目，点击插件条目即可查看插件readme