extensions-repo/user-guide/files/简介.md

1. Kylin-IDE和Kylin-Code

• Kylin-IDE：面向银河麒麟操作系统V10的IDE产品，支持X86、ARM、LoongArch架构
  • IDE基础平台-仓库链接
  • IDE基础平台-下载链接
• Kylin-Code：openKylin社区版本IDE，主要支持X86架构
  • IDE基础平台-仓库链接
  • IDE基础平台-下载链接

2. 支持平台

见支持的平台章节

3. 组成结构

• Kylin-IDE和Kylin-Code的组成结构相同，见下图，都包括IDE基础平台、插件管理器、插件仓库、插件，注意，IDE基础平台仅是其中一个组成部分
  • 
  • IDE基础平台：fork 自微软Visual Studio Code(VSCode)开源项目 Code OSS，仅提供基本图形界面和插件架构，开发功能需要插件配合
  • 插件管理器：分为在线插件管理器、离线插件管理器、插件依赖管理器
    • 在线插件管理器
      • 集成在IDE基础平台中，检索、浏览、安装、卸载插件市场中的插件。详细说明章节
    • 离线插件管理器
      • IDE基础平台集成了一部分功能，可以离线安装vsix插件文件；还有一部分功能以插件形式提供，可以预览、分类安装vsix插件文件集合。详细说明章节
    • 插件依赖管理器
      • 插件正常运行有时需要调用操作系统软件，这些操作系统软件称之为插件依赖
      • 不同架构、不同版本系统的插件依赖名称、版本可能不同，安装可能会给用户带来困惑
      • 为简化操作，可以使用本插件来处理插件依赖的检查和安装
      • 仅对KylinIdeTeam适配开发的插件有效（配置了depends.json文件）
      • 详细说明章节
  • 插件仓库
    • 目前默认接入OpenVSX插件市场
    • 在openKylin社区extensions-repo仓库提供插件汇总和手动下载链接
  • 插件
    • IDE基础平台仅提供基本图形界面和插件架构，多种编程语言的编辑、编译、调试等功能需要安装插件和插件依赖来完成
    • 安装和管理：使用插件管理器检索、安装、管理插件；使用插件依赖管理器管理插件依赖
    • KylinIdeTeam目前开发适配了一批插件以满足一般开发需求，见插件列表章节 。请优先使用我们开发适配的插件，检索方法见下文

3.1 OpenVSX插件市场使用注意

• OpenVSX插件市场是一个开源插件市场，所有开发者都可以申请上传插件，插件数量较多。但并不是其中的所有插件都能正常使用，需要用户甄别
• 我们提供了一种检索方式，能够在OpenVSX插件市场中检索到我们开发适配的插件，这些插件满足基本开发需求，并经过了我们的测试，请优先使用我们开发适配的插件
  • 检索方法见下图：点击插件视图中的插件筛选器图标，选择Kylin-IDE(或KylinCode)插件分类
  • 
• 同时，这些插件在openKylin社区extensions-repo仓库提供插件汇总和手动下载链接

4. 桌面应用模式与远程开发模式

• 桌面应用模式：与常见IDE一样，IDE基础平台以桌面应用软件形式安装运行
  • 上文"1. Kylin-IDE和Kylin-Code"给出的IDE基础平台下载链接即为这种模式
• 远程开发模式：类似微软闭源插件remote-ssh功能，IDE基础平台以远端服务形式安装运行，用户在本地通过SSH连接开发远程机器上的代码，体验和本地开发大体一致
  • 远程开发模式需要插件（插件名称：Kylin remote development，插件ID：remote-dev，插件发布者xhafei）和服务端配合实现，插件会引导用户安装服务端
  • 服务端下载地址：https://gitee.com/mcy-kylin/kylin-ide-server/releases
  • 详细见远程开发章节

5. 使用方法

5.1 桌面应用模式

• 安装IDE基础平台
  • Kylin-Code IDE基础平台
    • 安装方式一：openKylin系统1.0版本已预装Kylin-Code
    • 安装方式二：在openKylin系统的软件商店中找到Kylin-Code进行安装
    • 安装方式三：下载安装包，然后后执行：sudo dpkg -i .deb
  • Kylin-IDE IDE基础平台
    • 根据平台下载安装包，然后后执行：sudo dpkg -i .deb
• 下载安装插件依赖管理器
  • 插件名称：extension dependency，发布者：KylinIdeTeam
  • 安装方式一：通过在线插件检索，从OpenVSX插件市场中安装，见下图：点击插件视图中的插件筛选器图标，选择Kylin-IDE(KylinCode)插件分类->插件管理器
    • 
  • 安装方式二：或手动在openKylin的extensions-repo仓库中找到并下载安装插件
• 下载安装插件
  • 安装方式一：通过在线检索，从OpenVSX插件市场中安装，方法见上文
  • 安装方式二：或手动在openKylin的extensions-repo中找到并下载安装插件
  • Kylin-IDE（KylinCode）插件分类菜单检索到的插件是KylinIdeTeam开发、适配的插件
  • 根据开发需求选择检索分类
• 使用插件依赖管理器检查、安装插件依赖
  • 点击菜单中的帮助->打开插件依赖管理器进入插件依赖管理器页面
  • 详细见插件依赖管理章节
• 开始开发工作
  • 如果是新手，可以安装Kylin Project Manager插件（项目创建管理插件），创建简单项目，在此基础上进行开发。详细见项目管理章节
  • 也可以打开一个项目文件夹，开始编辑工作（已安装对应编程语言的支持插件和依赖）；配置task.json、launch.json，运行和调试
    • 以C语言为例，详细见C-C++开发章节
• 卸载

  //卸载kylin-ide命令如下:
  sudo dpkg -r kylin-ide
  
  //卸载kylin-code命令如下：
  sudo dpkg -r kylin-code
  
  //将配置目录、已安装插件文件全部删除
  sudo dpkg -P xxxx
  

5.2 远程开发模式

• 按照桌面应用模式安装IDE基础平台、插件依赖管理器
• 下载安装远程开发插件（插件名称：Kylin remote development，插件ID：remote-dev，插件发布者xhafei）
  • 安装方式一：通过在线插件检索，从OpenVSX插件市场中安装
  • 安装方式二：或手动在openKylin的extensions-repo仓库中找到并下载安装插件
• 输入、配置远程机器的用户名、IP等信息，自动或根据提示安装服务端，输入远程SSH密码
• 在远程端下载安装插件依赖管理器
• 在远程端下载安装插件
• 在远程端使用插件依赖管理器检查、安装插件依赖
• 开始远程开发工作
• 卸载：卸载远程开发插件，卸载远程服务端
• 详细见远程开发章节