# 依赖库

# 功能介绍

示例说明:

介绍功能说明及使用场景。

依赖机制的意义是分解需求场景的复杂性,可以使得企业的软件资产充分复用、提升编程效率,扩展编程能力边界,也能促成新型团队协作关系。具体适用场景如下:

  • 低代码开发者可将复杂需求场景分解为多个应用进行开发、调试、运行,减少耦合、避免冲突。
  • 低代码开发者可复用已有应用的能力,避免重复开发,降低维护难度,提升编程效率。
  • 专业开发者可以封装传统编程能力,低代码开发者可将传统编程能力和低代码编程能力混合使用,不需要关注实现细节,促成混合团队开发。
  • 低代码开发者可自由组合多个应用的能力,封装成为新的能力,并对外提供复用。

# 概念说明

示例说明:

对于该功能中新引入的概念进行介绍,避免在未介绍相关概念的情况下提到未知概念造成认知偏差。

依赖库(Library):一组可被低代码应用依赖使用的编程能力;不可独立运行、不可编辑。按照产生方式的不同分为如下两类:

  • NASL依赖库:由低代码应用导出的依赖库,内容包含了该库所有的声明和实现,目前可以导出的内容有实体、数据结构、枚举、逻辑。NASL 库为应用提供了基本的分解复杂性和复用性的能力。
  • 扩展依赖库:由GPL语言开发的依赖库(目前支持Java语言和JavaScript语言开发),现有如freemarker、log-tool、base64等,企业现有SDK可以用这种方式便捷接入。

# 依赖库管理入口

示例说明:

介绍功能的入口,如何进入该功能的使用界面。

如下图所示,进入资产中心栏目下的依赖库页签。

image-20230324093531178

# 使用案例

示例说明:

给出标准的使用姿势,图文结合给出操作案例。

如该功能在tutorial中已给出操作案例,也可参见到上文中的tutorial,但仍需要确保所有该功能中涉及的配置项、属性、概念均得到介绍。

# 导出NASL依赖库

  1. 单击应用信息与操作栏目红框中按钮,并在弹出框中单击发布为依赖库

    image-20221111141137632

  2. 在弹窗中填写依赖库相关信息并选择需要导出的依赖库能力,单击发布按钮即可发布依赖库。

    • 库标识:必填,依赖库的标识字符。初次发布默认为应用标识,再次发布默认为上次发布的库标识,支持手动修改,支持字母数字和下划线,最长100字符。

    • 库名称:必填,依赖库的名称。支持输入中文,最长100字符。

    • 发布版本:必填,可根据需要调整主版本号、次版本号和修订号。

    • 描述:选填,依赖库相关描述。支持输入中文,最长500字符。

    • 库能力:必填,支持选择逻辑、数据结构、枚举、实体相关内容导出依赖库。

      • 勾选一项后,自动检查依赖链,勾选相关节点。
      • 暂不支持流程相关逻辑导出。
      • 库能力树节点不包含扩展依赖库能力和接口能力。若勾选的逻辑如果有调用其他依赖库或接口,支持一并关联导出。
      • 勾选的实体只带出数据源名称,不带数据库链接等信息,不支持跨应用数据共享。

    image-20230324144235439

# NASL依赖库导出到资产中心

应用发布为依赖库后,支持被所有拥有该应用授权开发权限的开发者引用,依赖库详情可在应用详情页的依赖库管理栏目查看。若需要将依赖库共享给租户内的所有开发者,可将依赖库导出到资产中心。

  1. 进入应用详情页的依赖库管理栏目。

    image-20230324150001056

  2. 单击导出到资产中心

    image-20230324150037083

  3. 在弹出框中二次确认,确认无误后单击确定按钮。

    image-20221111161741508

  4. 进入资产中心依赖库管理栏目查看发布结果,依赖库已成功发布到资产中心。

# 引入依赖库

其他应用在开发过程中,需要引入该依赖库,可按照如下操作流程:

  1. 单击应用信息与操作栏目红框中按钮,并在弹出框中单击依赖库管理

    image-20221111165239597

  2. 在弹窗中单击引入依赖库

    image-20221111165510870

  3. 选择需要引入的依赖库及版本,单击引入按钮。

    image-20230324144444370

  4. (可选)引入成功后,若对该依赖库不再依赖,可以在依赖库管理中单击移除来移除依赖库。

    image-20221111165801913

# 上传扩展依赖库

低代码开发者可通过封装传统编程能力开发扩展依赖库,并支持手动上传到资产中心,扩展依赖库的开发方式请参见扩展依赖库制作及使用说明

  1. 进入依赖库管理页面,单击手动上传按钮。

    image-20230324150322829

  2. 在弹窗中配置扩展依赖库相关选项,单击发布按钮。

    • 上传方式:支持usage.json上传和Jar包上传,其中usage.json支持粘贴导入。
    • 库标识:必填,依赖库的标识字符。支持手动修改,支持字母数字和下划线,最长100字符。
    • 库名称:必填,依赖库的名称。支持输入中文,最长100字符。
    • 库分类:选填,支持为依赖库配置资产分类。
    • 发布版本:必填,可根据需要调整主版本号、次版本号和修订号。
    • 描述:选填,依赖库相关描述。支持输入中文,最长500字符。

    image-20230324150349487

  3. 将jar包上传到Maven仓库,上传操作详情可参见Maven配置

# 注意事项

示例说明:

介绍功能操作过程中需要注意的点,如可能会对用户环境造成的影响或是一些难以通过页面交互get到的点等,可在本章节做统一描述。

  • 用户支持引入的依赖库范围:拥有授权开发权限的应用产出的依赖库、平台依赖库、租户依赖库。
  • 仅支持租户管理员操作依赖库删除操作。
上次更新: 2023年06月14日