readme.md · YaYa/qlpmsp

# 修订记录

| 修订状态 | 修订人 |  修订日期  | 修订简要概述                                                 | 更改单号 |
| :------: | :----: | :--------: | ------------------------------------------------------------ | :------: |
|  1.0.0   |  陈龙  | 2020-08-18 | 项目创立                                                     |          |
|  1.0.1   |  陈龙  | 2020-08-19 | 项目搭建，日志、插件、语言、主题等功能                       |          |
|  1.0.2   |  陈龙  | 2020-08-21 | 插件测试                                                     |          |
|  1.0.3   |  陈龙  | 2020-08-28 | 增加登录功能，整理并绘制程序框图、撰写说明文档               |          |
|  1.0.4   |  陈龙  | 2020-08-31 | 修改项目路径，区分代码、文档、发布程序、第三方依赖           |          |
|  1.0.5   |  陈龙  | 2020-09-10 | 编写开发日志，设计数据库，整理项目思路，检查并修复 bug       |          |
|  1.0.6   |  陈龙  | 2020-09-16 | 增加插件间关系，插件管理器嵌套等                             |          |
|  1.0.7   |  陈龙  | 2020-09-30 | 完善插件管理器嵌套功能，同步子插件独立日志系统，修改样式表   |          |
|  1.0.8   |  陈龙  | 2020-11-05 | 多级插件管理器界面及其他部分 bug 修复，优化架构、主题库、日志库等 |          |
|  1.0.9   |  陈龙  | 2020-12-11 | 更新样式表、优化插件管理器界面尺寸自适应功能                 |          |
|  1.1.0   |  陈龙  | 2020-12-23 | 1. 优化插件管理器：超长插件名过长显示省略号；<br>2. 修改 readme 文档： txt 改为 md ；<br>3. 优化底层库：<br>3.1  Udp 优化；<br>3.2 增加 FFT 支持；<br>3.3 绘图底层优化：可添加背景图片，优化缩进方式等；<br>3.4 用户系统优化<br>4. Qt 开发版本变更：5.5.0 ~ 5.14.2；<br>5. 增加 FFT 和 QLsCustomPlot 测试插件；<br>6. 数据库新增支持 Qt 自带的 SQLite ，可在配置文件中进行切换； |          |
|  1.1.1   |  陈龙  | 2020-12-25 | 将数据库和语言系统从外部引用整合进底层库                     |          |
|  1.1.2   |  陈龙  | 2021-01-07 | 1. 增加第三方控件库Form；<br>2. 修复Qt5的bug：插件界面太大时，初始加载最大化失效，需要移动一下才能恢复正常；<br>3. 创建QtCreator自定义模板qlsplugin，方便插件开发； |          |
|  1.1.3   |  陈龙  | 2021-01-15 | 1. 优化 TcpClient ；<br>2. 优化配置文件读取，设定配置文件格式为 UTF-8 ；<br>3. 优化日志库加载顺序，修复初始化阶段 ui 界面不打印日志问题。 |          |
|  1.1.4   |  陈龙  | 2021-03-15 | 1. 增加 MATLAB 2012 32&64bit 第三方环境 ；<br>2. 优化 QLsCustomPlot 绘图功能：光标划过曲线显示点的坐标；<br>3. 增加 CAN 驱动接口；<br> |          |
|  1.1.5   |  陈龙  | 2021-04-13 | 1. QLsCustomPlot 优化单击事件处理：右键单击不会打断单击事件;<br>2. 增加QLsAV库：支持音视频播放功能，基于 FFMPEG 和 SDL2 ;<br>3. 增加 QLsFunc 库：通用自定义功能模块;<br>4. 增加音视频测试插件；去掉QLsTest测试插件;<br> |          |
|  1.1.6   |  陈龙  | 2021-04-14 | 1. 升级 QLsFunc ：增加根据窗口标题获取进程 ID 功能；增加打开并嵌入 PPT 、 Word 功能;<br>2. 修改数据库 DAO 层：字段从 protected 移到 private ;<br>3. 优化插件管理架构：针对单一插件业务，却显示了主界面标题和插件管理器标签栏两个标题栏的情况，在插件配置文件中(例: ini/plugins/QCoreSystem.ini)中，新增配置项"pluginsManager/hideTabBar"，可隐藏插件管理器的标签栏;<br> |          |
|  1.1.7   |  陈龙  | 2021-04-15 | 1. 修改主控界面阴影边框的方式，从 QGraphicsDropShadowEffect 改为 QPainter 自绘。本次主要解决了 QLsAVWidget 中底部控制栏自动显隐时通过 QGraphicsDropShadowEffect 设置透明度没反应的冲突;<br>2. 优化 QLsFunc ：打开并嵌入 PPT 、 Word 时，增加 [只读][兼容模式]等打开方式的兼容性;<br> |          |
|  1.2.0   |  陈龙  | 2022-05-05 | 将编译模块从 qmake 重构为 cmake，除插件以外其他模块都适配完毕 |          |
|  1.2.1   |  陈龙  | 2022-06-13 | 1. 增加 settings 系统设置: 留出设置安装路径和工作路径接口; 规范各个模块路径及配置文件内容;<br>2. 引用 CPM-cmake 模块，可通过 cmake 联网自动下载并配置依赖库; 适配 av_player, av_widget 库; 适配 av_demo, plugin_test 测试插件;<br>3. 优化插件接口：去掉最小尺寸变化接口，去掉绑定信号槽变化接口，将插件配置信息接口改为元数据获取;<br>4. 优化 build 路径：将 cache, config, database, log 资源移到 ~/qlpmsp/ 路径下; cmake 插件动态库自动链接到 build/lib/${plugins_dir} ; 整理主题图标等资源文件，放到 build/resources/themes/ 下， 优化主题管理系统(目前只适配了主系统主题，剩下通过 DBus 通知子插件，使其适配主系统主题;); 语言包自动生成在 build/translations/ 下; |          |
|  1.2.2   |  陈龙  | 2023-10-27 | 1. 增加 OpenGL 渲染模块插件;<br>2. 默认主窗口不再无边框;<br>3. 优化最大化逻辑;<br>4. 升级 CPM 至 0.38.6; |          |

---

# 概述

## 标识

- 名称：Qt 插件管理系统
- 版本：QLSPMSP-1.2.2
- 作者：龙少 - ls56647426@foxmail.com
- 编译环境：Win10, Qt5.14.2(gcc_64), cmake 3.20.5, Ubuntu 16.04.3
- 编程语言：C++, Qt
- 创建时间：2020-08-18 15:17
- 最后修改时间：2023-10-27 22:41

## 功能

### 插件管理器

插件模块的加载、卸载；插件间关系、通信；管理插件的生存周期等等……

### 主题管理器

切换主题；与插件管理器配合，不同插件可拥有独自的主题，也可继承父插件的主题。

### 日志系统

单例日志系统，支持 6 种日志等级、日志输出方式（日志文件路径、Qt 窗口显示等）……

### 语言系统

单例语言管理，可切换软件界面语言，每次切换重启后生效。

### 用户系统

管理用户信息，如登录、注册、修改、找回以及插件内涉及用户操作的地方。

### 设置系统

设置软件的配置信息，如插件路径、日志路径、用户缓存路径、插件记录等等。  
<font color="red">界面暂未实现</font>

### 扩展插件

1. OpenGL 渲染模块插件
2. 音视频播放插件

---

# 项目组成

## 系统架构

<center>
    <img style="border-radius: 0.3125em; box-shadow: 0 2px 4px 0 rgba(34,36,38,.12), 0 2px 10px 0 rgba(34,36,38,.08);"
        src="https://gitee.com/ls56647426/qlpmsp/raw/master/doc/img/fwk.png">
    <br>
    <div style="border-bottom: 1px solid #d9d9d9; display: inline-block; color: #999999; padding: 2px;">
        系统架构图
    </div>
</center>

### 应用层

#### 主控系统

主控系统整体分为三部分：标题栏、插件界面、日志。

- 标题栏包含图标、标题、设置、最小化、最大化、关闭；

- 插件界面是一个插件管理器，其中插件管理界面与标签栏可设置显隐；

- 在配置文件`../config/plugins/xxx.ini`中，配置内容为：

````
    [pluginsManager]
    # 隐藏标签栏为否
    hideTabBar=0
    # 显示插件管理器界面为是
    show=1
    ````

- 最底端为日志界面，可通过设置日志级别，显示符合各个等级的日志记录。

#### 扩展插件

扩展插件可通过插件管理器，嵌入到主控系统的界面上，通过插件管理进行加载和卸载。

### 应用框架层

应用框架层集成了一些系统功能的 UI 界面，应用层可通过应用框架层的界面显示、操作底层的各个功能。

#### 用户登录

- 用户功能可配置显隐，若隐藏则本系统无需使用用户功能直接使用。

- 在`~/qlpmsp/config/qlpmsp.ini`中，配置内容为：

```
    [login]
    # 登陆功能设为启动
    enable=true
    ```

- 用户登录界面包含登录、记住密码、自动登录、注册账号、找回密码、修改密码等功能。

<center>
    <img style="border-radius: 0.3125em; box-shadow: 0 2px 4px 0 rgba(34,36,38,.12), 0 2px 10px 0 rgba(34,36,38,.08);"
        src="https://gitee.com/ls56647426/qlpmsp/raw/master/doc/img/login.png">
    <br>
    <div style="border-bottom: 1px solid #d9d9d9; display: inline-block; color: #999999; padding: 2px;">
        用户登录界面
    </div>
</center>

#### 插件管理器

#### 设置

### 驱动层

#### 数据库连接池

#### 主题管理系统

#### 插件管理系统

#### 语言管理系统

#### 日志系统

#### 设置系统

### 数据

#### 数据库

#### 主题

#### 插件

#### 语言包

#### 日志

#### 配置文件

## 源码目录

```
qlpmsp/
├─code/                         # 代码
│  ├─bin/                       # 生成的库、可执行程序：.dll .a .exe
│  │  └─debug/ & release/       # 调试版本 & 发布版本
│  │     ├─cache/               # 缓存
│  │     ├─databases/           # 本地数据库
│  │     │  └─sqlite/           # 本地 SQLite 数据库
│  │     ├─icon/                # 图标库
│  │     ├─ini/                 # 配置文件
│  │     ├─language/            # 语言包
│  │     ├─log/                 # 日志库
│  │     ├─plugins/             # 插件库
│  │     └─themes/              # 主题样式表
│  ├─inc/                       # 引用(常用底层实现)
│  │  ├─Check/                  # 校验
│  │  ├─Controls/               # 绘图
│  │  ├─FFT/                    # FFT 支持(离散傅立叶变换的快速算法)
│  │  ├─Form/                   # 自定义/第三方 控件
│  │  ├─QLsAV/                  # 音视频播放
│  │  ├─QLsFunc/                # 自定义功能模块
│  │  ├─SerialPort/             # 串口
│  │  ├─Tcp/                    # Tcp
│  │  │  ├─TcpClient/           # 客户端
│  │  │  └─TcpServer/           # 服务器端
│  │  ├─Udp/                    # Udp
│  │  │  └─UdpClient/           # 客户端
│  │  └─USBtoCANBUS/            # CAN 驱动接口
│  ├─lib/                       # .o 文件
│  │  └─debug & release         # 调试版本 & 发布版本
│  └─src/                       # 源文件
│     ├─AppFramework/           # 应用框架层(UI 界面)
│     │  ├─dllQLsLoginAppfwk    # 登录界面
│     │  └─dllQLsPluginsManagerAppfwk/      # 插件管理系统 应用框架层
│     ├─CoreSystem/             # 主系统(Qt 插件管理系统)
│     ├─DevBase/                # 驱动层(设备底层)
│     │  ├─dllQLsDBManager      # 数据库
│     │  │  ├─Dao/              # 数据访问对象(Data Access Object)层
│     │  │  ├─Pojo/             # 实体类映射(Plain Old Java Object)层
│     │  │  ├─Service/          # 服务层
│     │  │  ├─QLsDBConnPool     # 数据库连接池
│     │  │  └─QLsSpecification  # 数据库 sql 语句命令封装
│     │  ├─dllQLsLanguagesManager           # 语言管理系统
│     │  ├─dllQLsLog/           # 自定义日志库接口
│     │  ├─dllQLsPluginsManager/            # 插件管理系统 底层
│     │  ├─dllQLsThemesManager/             # 日志管理系统
│     │  └─dllQsLog/            # QsLog 第三方日志库
│     └─Plugins/                # 应用层(插件)
│        └─pluginCustomPlotTest # FFT 和 QLsCustomPlot 联合测试插件
├─doc/                          # 文档
├─exe/                          # 程序
└─third/                        # 第三方依赖
   ├─ffmpeg/                    # ffmpeg库
   ├─FFT/                       # fftw 第三方依赖库
   ├─MATLAB/                    # MATLAB 环境
   ├─MySQL/                     # 数据库
   ├─SDL2/                      # SDL2库
   └─插件模板/                  # 插件模板
         └─qlsplugin            # QtCreator自定义插件模板
```

---

YaYa/qlpmsp

简介

发行版

贡献者

近期动态

YaYa/qlpmsp .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

YaYa/qlpmsp