Skip to content

how to build cn

Jump to bottom
czyt1988 edited this page Feb 17, 2024 · 1 revision

此文会详细介绍如何构建和引入SARibbon

准备工作

SARibbon使用了QWindowkit作为无边框方案，同时也支持简单的无边框方案，如果你需要操作系统原生的窗口支持，如windows7以后的贴边处理，windows11的最大化按钮悬停的效果，建议开启QWindowkit库，QWindowkit库还能较好解决多屏幕移动问题

如果你要依赖QWindowkit库，需要先编译QWindowkit库，QWindowkit库作为SARibbon项目的submodules，如果在git clone时没有附带--recursive参数，需要执行submodule update命令:

git submodule update --init --recursive

编译QWindowkit库(如果不开启跳过此步)

QWindowkit库只提供了cmake的编译方式，必须使用cmake

为了简单，在src/SARibbonBar/3rdparty下提供了一个CMakeLists.txt文件，已经对此库的必要配置进行了设置，直接调用src/SARibbonBar/3rdparty/CMakeLists.txt文件编译即可

使用Qt Creator和使用visual studio构建和安装基本一样

使用Qt Creator构建和安装QWindowkit库

使用qt creator编译QWindowkit库，直接用qt creator打开src/SARibbonBar/3rdparty/CMakeLists.txt文件

点击运行（Ctrl+R）

切换到项目模式（Ctrl+5）

build步骤选择install

再点击运行（Ctrl+R）

这时你会在SARibbon根目录下看到形如bin_qt5.14.2_Debug_x64这样的安装目录，这里自动把QWindowkit库安装在此目录下

此时完成QWindowkit库的编译和安装

使用visual studio构建和安装QWindowkit库

使用visual studio编译QWindowkit库，用visual studio打开->CMake，选择src/SARibbonBar/3rdparty/CMakeLists.txt文件

选中CMake菜单->全部生成

选中CMake菜单->安装

这时你会在SARibbon根目录下看到形如bin_qt5.14.2_Debug_x64这样的安装目录，这里自动把QWindowkit库安装在此目录下

此时完成QWindowkit库的编译和安装

构建SARibbonBar库

SARibbonBar库提供cmake和qmake两种方式构建，推荐使用cmake

基于CMake构建SARibbonBar库

vs下基于cmake的构建

点击文件->打开->Cmake 选中CMakeLists.txt

将会形成如下的构建树

直接点击CMake菜单->全部生成

全部生成完成后，CMake菜单->安装->SARibbon

这时候你会看到源码的根目录下多出一个文件夹,文件夹命名方式为bin_qt{version}_[Debug/Release]_x[64/86]（前提是你没有改变CMAKE_INSTALL_PREFIX）

qtcreator下基于cmake的构建

点击文件->打开文件或项目选中CMakeLists.txt，加载完成后形成如下的构建树

点击运行按钮

运行结束，会弹出例子窗口，点击左侧边栏的项目标签，Build的步骤，选中install

再次点击运行按钮，这时候你会看到源码的根目录下多出一个文件夹,文件夹命名方式为bin_qt{version}_[Debug/Release]_x[64/86]（前提是你没有改变CMAKE_INSTALL_PREFIX）

使用SARibbon的所有内容都在这个文件夹下

基于QMake构建SARibbonBar

qmake构建SARibbonBar只需使用Qt Creator打开SARibbon.pro文件即可

注意，如果使用Qt Creator打开SARibbon.pro文件过程报错，那么你的账户没有足够的写权限，因为qmake过程会在当前目录下执行mkdir等命令，没有足够权限，会报qmake错误

使用SARibbonBar库

基于cmake引入SARibbonBar库

首先要通过cmake编译并执行安装，在自己的工程按照如下步骤执行：

  1. 指定SARibbonBar的安装目录，把安装目录下的lib/cmake/SARibbonBar位置设置给SARibbonBar_DIR变量
set(SARibbonBar_DIR "C:\src\Qt\SARibbon\bin_qt5.14.2_MSVC_x64\lib\cmake\SARibbonBar")
  1. 使用find_package找到SARibbonBar的Config文件，这个函数实际上是调用lib/cmake/SARibbonBar/SARibbonBarConfig.cmake文件，这里会把需要include的路径、预定义的宏，和需要添加的库给指定好，此时SARibbonBar_INCLUDE_DIR就是SARibbonBar的include文件路径
find_package(SARibbonBar)
  1. 最后调用target_link_libraries添加SARibbonBar库到自己的工程中,这里${myapp_target_name}是自己工程的target名字
target_link_libraries(${myapp_target_name} PUBLIC
    SARibbonBar
)

基于qmake引入SARibbonBar库

qmake的编译过程会在SARibbon下生成bin_qt{Qt version}_{MSVC/GNU}_x{32/64}文件夹，库文件和dll文件都在此文件夹下，importSARibbonBarLib.pri会自动把这个文件夹下的库引用进来

步骤如下：

  1. 先在你的工程中建立一个3rdparty文件夹，再把整个SARibbon文件夹拷贝过去

SARibbon内部已经有几个pri文件可以很方便的让你把工程引入到自己目录中，./importSARibbonBarLib.pri文件就是用于引入SARibbon库的

  1. 在自己的Qt工程pro文件中加入如下语句即可
include($$PWD/3rdparty/SARibbon/importSARibbonBarLib.pri)

此时你的工程目录结构大致如下：

|-[you-project-dir]
|  |-you-project.pro
|  |-[3rdparty]
|     |-[SARibbon](直接把SARibbon完整复制过来)
|        |-importSARibbonBarLib.pri
|        |-SARibbonBar.pri
|        |-common.pri
|        |-[bin_qtx.x.x_{MSVC/GNU}_x{32/64}]
|        |-[src]
|        |   |-[SARibbonBar]

importSARibbonBarLib.pri、SARibbonBar.pri、common.pri这三个文件是引入工程的关键文件

Qt6.0版本后已经放弃qmake，建议使用cmake来管理工程

Clone this wiki locally