KDDockWidgets源码编译及安装

KDDockWidgets源码编译及安装

简介

​​KDDockWidgets​​​ 是由 ​​KDAB(官网)​​ 编写的 Qt Dock 小部件库，适用于替换 QDockWidget和实现 Qt 中缺少的高级功能。

功能特点：

提供 QDockWidget 不支持的高级对接

在 Windows 上调整本机窗口大小（即使使用自定义标题栏装饰也允许 Aero-snap）箭头下降指示器可实现出色的下降精度允许完全不同的、用户提供的、丢弃指示器类型在浮动窗口中嵌套停靠小部件并将该组停靠回主窗口停靠到任何主窗口，而不仅仅是父主窗口停靠到主窗口的中心，或者干脆去掉“中央小部件”的概念主窗口支持中心小部件中的可拆卸选项卡将标签栏中的任意标签分离到停靠区域支持1个以上主窗口支持关联，使一些停靠小部件只能停靠在某些主窗口上允许隐藏标题栏并只显示选项卡。允许通过标签栏拖动。公开内部助手小部件，以便用户可以自定义它们或提供他自己的

自定义选项卡小部件自定义标题栏自定义窗框自定义小部件分隔符

跨平台（macOS、Linux、Windows、WebAssembly、Wayland、X11/XCB、EGLFS 正在工作）有关平台特定信息，请参阅 README-Wayland.md 和 README-WASM.md。布局引擎遵守最小/最大尺寸限制和一些尺寸策略PySide2 绑定干净的代码库

不将 GUI 与状态与逻辑与动画混合强大的测试覆盖率，甚至 GUI 和 DnD 操作都经过测试。目前有 200 个测试。用于进行随机测试和查找错误的模糊器

延迟分隔符调整大小用鼠标重新排序标签部分布局保存/恢复，仅影响选定的子集双击标题栏最大化双击分隔符以平均分配在选项卡上显示关闭按钮允许使停靠小部件不可关闭和/或不可停靠标题栏上可选的最小化和最大化按钮FloatingWindows 可以是实用程序窗口或完全原生的

以上描述可以看到，KDDockWidgets的扩展功能是非常丰富的，操作有点类似VS。

github地址：​​附带编译好的版本，编译环境：Qt5.15.2+VS2019 64位 包含KDDockWidgets源码 以及编译好的debug和release版本 其中，源码编译区分了QtWidget和QtQuick两个版本。

本dll及demo编译环境： vs2019+Qt5.15.2 64bit。 32bit不能用！！！

dll分quick和QWidget版是不一样的，对应的include头文件也不一样，不能混用。

example目录下包含两个演示demo，每个demo下有个KDDockWidgets文件夹，可以在自己的项目中直接添加 KDDockWidgets.pri到自己的工程中即可使用。

​​点我下载​​

编译准备

在编译KDDockWidgets之前所需要做以下准备：

cmake，​​参考这里​​ninja，​​参考这里​​编译器，我这里使用VS2017进行编译，自行安装Qt，KDDockWidgets 需要Qt >= 5.9（如果启用 Python 绑定，则 >=5.12）。QtQuick 支持需要Qt >= 5.15。支持Qt 6

设置环境变量

注意，这一步非常关键，安装完上面的软件后必须要设置环境变量，否则在编译KDDockWidgets时无法正确引用。

右键我的电脑打开属性：

注意，如果想编译32位，那么环境变量配置就统一设置x86的路径，如果要编译64位，则统一设置x64路径，以下是配置32位的路径：

新建系统变量LIB，添加VS相关的环境变量

新建系统变量INCLUDE

在PATH中添加 cmake、ninja、Qt、VS等环境变量

同理，如果是64位，那么配置x64的环境变量，如下：

注：以上是我电脑的路径，根据自己的实际路径进行添加。

重点：设置完环境变量后双击运行一下这个脚本：

C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvarsall.bat

或者如果设置32位，那就双击运行vcvars32.bat

如果是64位，那就双击运行vcvars64.bat

开始编译

从github上下载源代码到本地

打开CMD终端 将目录切换到源码目录

然后输入：​​cmake . -G Ninja​​

然后输入：​​cmake --build .​​ 等待编译

执行完后会在bin目录下生成

这里编译会将源代码以及示例代码一起编译，在bin目录下生成示例程序，双击即可打开体验。最后执行安装命令：​​cmake --build . --target install​​

注意，这里只是编译了debug版本的库，默认会安装到C盘：

可以通过将选项传递​​-DCMAKE_INSTALL_PREFIX=/install/path​​给 cmake来更改安装位置

如：​​cmake -G Ninja -DCMAKE_INSTALL_PREFIX=xxx​​

根据官方提供的示例运行，体验还不错，功能比原生的QDockWidget更加丰富，若想在自己项目中使用KDDockWidgets，可以参照其示例进行修改。

编译KDDockWidgets Qt Quick示例

上面提到如果要使用Quick 那么Qt需要5.15版本以上，而且编译时默认关闭了编译QtQuick，所以如果需要编译运行Quick示例的话，需要修改编译文件，在根目录下找到​​CMakeLists.txt​​文件并打开，然后找到

option(${PROJECT_NAME}_QTQUICK "Build for QtQuick instead of QtWidgets" OFF)

将OFF改成ON即可

option(${PROJECT_NAME}_QTQUICK "Build for QtQuick instead of QtWidgets" ON)

然后删除之前的编译生成文件，重新编译源码，就会在bin目录下看到quick的示例：

可能会遇到的问题

以上步骤看起来很简单，但其实过程中遇到了很多的问题，主要都是环境变量引起的，比如：

还有其他lib引用错误等，其实都是环境变量的原因导致的，如果要编译32bit，那么所有的环境变量配置都需要32位的路径，Qt也需要安装32位的vs版本，64位同理，只要设置正确就不会有啥大问题了。

编译release版本

$ cmake -G Ninja -DCMAKE_BUILD_TYPE=Release $ cmake --build . $ cmake --build . --target install

注意，在重新编译之前，需要将之前编译生成的文件全部删除后再编。

已编译好的版本

附带编译好的版本，编译环境：Qt5.15.2+VS2019 64位

包含KDDockWidgets源码 以及编译好的debug和release版本

其中，源码编译区分了QtWidget和QtQuick两个版本，如果要使用qml的dockwidget功能的话就需要编译QtQuick库才行

这里包含了debug和release版本的库，其他三个是自带的示例。

注： 附带编译好的版本，编译环境：Qt5.15.2+VS2019 64位 包含KDDockWidgets源码 以及编译好的debug和release版本 其中，源码编译区分了QtWidget和QtQuick两个版本。

本dll及demo编译环境： vs2019+Qt5.15.2 64bit。 32bit不能用！！！

dll分quick和QWidget版是不一样的，对应的include头文件也不一样，不能混用。

example目录下包含两个演示demo，每个demo下有个KDDockWidgets文件夹，可以在自己的项目中直接添加 KDDockWidgets.pri到自己的工程中即可使用。

​

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。