Page tree
Skip to end of metadata
Go to start of metadata

总览

活字格作为低代码开发平台,提供了强大的编程扩展能力,此教程旨在帮助快发者轻松快速的了解如何开发活字格的插件。

技能要求

开发活字格插件,对开发人员需要使用两种语言,C#和JavaScript。不过不用担心,开发活字格插件并不需要很深厚的技术能力,只要了解最基本的语法就完全够用。如果你不了解这两种语言或者之一,但是以前接触过其他编程语言如(Java,Python, C, C++)等,那么学习C#和JavaScript到可以开发活字格插件的程度大概几天就可以了。甚至不经过刻意的学习,只需要跟着教程示例代码尝试,也可以很快上手活字格插件开发。

  1. C#
    1. 用于定义插件类型及属性
    2. 如果编写服务端命令插件,需要编写执行逻辑
  2. JavaScript
    1. 用于实现单元格插件的渲染和交互逻辑
    2. 用于实现名称插件的执行逻辑

环境准备

开发活字格插件之前,需要下载并安装活字格设计器及集成开发环境。

插件开发只安装活字格设计器即可,不必须安装活字格服务器,推荐安装至默认路径。

集成开发环境,推荐免费下载安装 VisualStudio 2022 社区版

安装VisualStudio 2022 社区版步骤

  1. 打开链接https://visualstudio.microsoft.com/zh-hans/vs/community/,单击“下载Visual Studio按钮”。

  2. 下载后双击打开,看到以下界面, 勾选".Net 桌面开发",其他保持默认配置,单击Next即可。

    如果提示系统版本不支持,需要升级Windows。
    系统要求
    • Windows 11 版本 21H2 或更高版本:家庭版、专业版、专业教育版、专业工作站版、企业版和教育版
    • Windows 10 版本 1909 或更高版本:家庭版、专业版、教育版和企业版。

下载插件构建器

活字格插件构建器是一个开源项目,使用插件构建器构建活字格插件项目会获得以下好处:

  1. 自动添加活字格插件开发所需依赖,生成个工程开箱即用,直接找到对应的文件添加业务逻辑即可。
  2. 添加前端接口描述文件 (.d.ts)。编写js代码也可以显示方法智能提示。
  3. 支持前端JS代码热更新(不用重启活字格设计器,修改js文件后保存再刷新页面,即可应用最新变更)。
  4. 支持Cs代码热更新(编译插件工程后,不用重新安装插件,只需重启活字格设计器即可应用最新变更)。
  5. 自动打包(编译后自动在bin目录下生成打包好的 zip 插件包)。


下载活字格插件构建器步骤

  1. 打开https://gitee.com/grape-city-software/forguncy-plugin-project-creator, 单击最新的发行版。

  2. 打开发行版页面后单击下载 forguncyPluginBuilder.zip 文件。

  3. 解压缩后可以看到两个子文件夹。

  4. 在bin目录下找到 ForguncyPluginCreator.exe 文件,双击打开。

  5. 可以看到以下界面。

  6. 直接单击“确定”。
  7. 在“文档\HZG-Plugins\MyPlugin”目录下找到“MyPlugin.sln”文件,双击打开。

  8. 在VisualStudio 里找到并点击菜单 “生成->生成解决方案”。

  9. 编译成功后,打开活字格设计器,在单元格类型选择下拉列表中可以看到多了一个单元格类型“我的插件单元格”。恭喜你,第一个插件已经开发完成了。

  • No labels