SARibbon构建说明

提示

你不需要编译SARibbon，只需把SARibbon.h和SARibbon.cpp（这两个文件位于src目录下）引入你的工程即可

此文会详细介绍如何构建SARibbon为动态库，如果你不熟悉C++的构建，你只需把SARibbon.h和SARibbon.cpp引入你的工程即可使用

SARibbon采用QWindowkit作为无边框窗口方案，同时也支持简单的无边框设置。如果你需要操作系统原生的窗口特性，如Windows 7及以后版本的贴边处理，或Windows 11的Snap Layout效果，建议启用QWindowkit库。该库还能有效解决多屏幕移动问题。

启用QWindowkit后，你将能实现如下效果：

若要启用QWindowkit，需先编译该库。

注意

作为SARibbon项目的子模块，如果你在git clone时没有使用--recursive参数，需执行submodule update命令：

git submodule update --init --recursive

关于安装位置

通过CMake构建完成后，使用install命令可以安装所有依赖。引用库时，只需通过find_package命令，即可将所有依赖和预定义宏等配置一并引入，这是目前最推荐的做法。

然而，在程序开发过程中，可能会遇到不同编译器（如MSVC、MinGW）和不同Qt版本的编译问题。如果使用默认的安装位置（Windows下为C:\Program Files），则只能安装一个版本的库

为了区分不同编译器和Qt版本，SARibbon默认使用本地安装。本地安装会根据编译器和Qt版本生成一个安装文件夹，文件夹命名格式为bin_qt{version}_[MSVC/GNU]_x[64/86]

通过CMake的SARIBBON_INSTALL_IN_CURRENT_DIR选项可以配置是否根据编译器和Qt版本安装到本地，该选项默认为ON，即会根据编译器和Qt版本生成一个本地文件夹进行安装