跳到主要内容

用户库管理

用户库是用户自定义的功能模块集合，可以包含功能块、函数、数据类型等元素。用户库可以独立编译和打包，便于在不同项目之间共享和复用代码。

用户库的优势​

  • 代码复用：将常用逻辑封装为用户库，便于在多个项目中复用
  • 模块化管理：将相关功能组织在一起，提高代码可维护性
  • 便于分享：可以导出用户库并分享给其他开发者
  • 版本管理：支持独立的版本控制和更新

创建用户库​

操作步骤​

  1. 在左侧工程树中找到用户库节点
  2. 在用户库节点上鼠标右键，选择新建用户库选项
创建用户库
  1. 点击新建用户库按钮后，打开新建用户库界面弹窗
新建用户库界面
  1. 输入用户库信息：
    • 名称：用户库的标识名称
    • 描述：用户库的说明信息（可选）
    • 版本：用户库的版本号
    • 开发语言：用户库的开发语言，（如ST、C、C++等）默认是ST
    • 发行类别：用户库导出时为二进制还是源码，默认是二进制
  2. 点击保存按钮创建用户库
用户库列表 创建用户库确认

用户库编辑​

编辑用户库​

点击用户库列表中的编辑图标编辑图标，进入用户库编辑界面：

用户库编辑界面

删除用户库​

点击用户库列表中的删除图标删除图标，确认后删除用户库。

注意

删除用户库后，相关的功能块、函数和数据类型将被移除，请谨慎操作。

导出用户库​

用户库可以独立编译、打包，便于分发和共享。

操作步骤​

  1. 在左侧项目面板中，找到要导出的用户库模块
  2. 点击用户库模块，进入用户库详情界面
  3. 点击导出按钮
  4. 选择导出文件的存放路径
  5. 指定导出文件名（如 test_st_user_lib.zip）
  6. 点击确认完成导出
导出用户库

导出文件说明​

导出的用户库文件为ZIP压缩包，包含：

  • 用户库的元数据信息
  • 所有功能块和函数的二进制代码（若是选择发行类别为源码，则包含源代码文件）

模块接口设置​

新建数据类型​

在用户库中可以定义自定义数据类型，用于特定的业务逻辑。

  1. 在用户库详情界面，点击新建类型按钮
  2. 在新建数据类型界面弹窗中，选择数据类型类型（如结构体、枚举、派生等）
  3. 输入数据类型名称（如 MotorStatus），以及类型类别（如结构体、枚举、派生等）
  4. 点击添加按钮创建数据类型
新建数据类型

数据类型分类​

类型说明
结构体由多个不同类型的元素组成的复合类型
枚举包含一组命名常量的类型
派生为现有类型创建新名称
数组相同类型元素的有序集合

用户库结构​

典型的用户库包含以下元素：

用户库
├── 数据类型 (TYPE)
|   ├── MotorStatus
|   ├── ControlMode
|   └── Configuration
├── POU (FUNCTION_BLOCK/FUNCTION)
│   ├── MotorControl
│   ├── PIDController
│   └── DataLogger
└──  内部实现 （多用于C/C++库）
    ├── Calculate
    └── ConvertUnits

注意事项​

注意
  1. 命名规范：用户库名称应清晰表达其用途，避免与系统库重名
  2. 版本管理：建议遵循语义化版本控制（如 v1.0.0）
  3. 依赖管理：确保用户库的依赖项在目标项目中可用
  4. 导出备份：定期导出用户库作为备份
  5. 权限设置：注意用户库的访问权限和可见性
提示
  • 使用有意义的名称命名用户库和其中的元素
  • 添加详细的注释和文档说明
  • 在导出前进行测试，确保功能正常
  • 遵循模块化设计原则，保持用户库的独立性

通过以上内容，您可以在WasomeCodeX_AI中灵活地创建、编辑和管理用户库。