Qt开源控件库（qt-material-widgets）的编译及使用

项目简介

qt-material-widgets是一个基于 Qt 小部件的 Material Design 规范实现。

项目地址

项目地址： qt-material-widgets

本地构建环境

Win11 家庭中文版

VS2019

Qt5.15.2 (MSVC2019)

本地构建流程

克隆后的目录结构如图：

直接使用Qt Creator打开.pro（因为我要用在VS项目中，因此这里Kit选择MSVC2019）：

直接跑release版本：

报错： libcomponents.a does not exists.

这是因为.a是Linux的库文件格式，在Windows平台上对应的.lib文件格式，生成的库文件名称也有稍许区别。

这里打开examples.pro，将libcomponents.a 改成components .lib，重新编译即可：

可以看到示例程序如下：

实际应用

如何在自己的项目中，使用qt-material-widgets控件库？

通过上面编译可以知道，控件库主要来源于components这个静态库项目，参考examples项目使用控件库的方式：

①添加.h头文件

②添加.lib库文件

头文件

打开components项目目录：

将.h文件单独复制出来（注意只需复制.h即可，无需复制_p.h）。

这个库使用pimpl模式实现，可以隐藏实现细节（所有私有的非虚成员），且可减少代码依赖和编译时间，具体介绍可见：

这里单独新建了一个目录（后续直接将该目录拷贝到自己项目的3方库路径下即可）：

include里面的目录结构尽量和components里面的保持一致：

lib目录中拷贝components项目生成的components.lib：

直接将该目录拷贝到自己项目（这里以我的HelloQt5_15_2项目为例）的3方库路径下：

个人习惯用VS2019 + Qt VS Tools开发，在VS2019中打开我的HelloQt5_15_2项目：

配置附件包含目录：

配置库目录：

添加静态库文件：

在控件中使用控件库控件（这里以使用autocomplete为例）：

因为上面添加了头文件附件包含目录，这这里直接包含autocomplete控件头文件即可使用：

#include "mainwidget.h"
#include "ui_mainwidget.h"

#include "qtmaterialautocomplete.h"

MainWidget::MainWidget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::MainWidget)
{
    ui->setupUi(this);

    QtMaterialAutoComplete*  pAutocomplete = new QtMaterialAutoComplete(this);
    pAutocomplete->move(100, 100);
    QStringList states =
    { "Alabama"
    , "Alaska"
    , "American Samoa"
    , "Arizona"
    , "Arkansas"
    , "California"
    , "Colorado"
    , "Connecticut"
    , "Delaware"
    , "District of Columbia"
    , "Florida"
    , "Georgia"
    , "Guam"
    , "Hawaii"
    , "Idaho"
    , "Illinois"
    , "Indiana"
    , "Iowa"
    , "Kansas"
    , "Kentucky"
    , "Louisiana"
    , "Maine"
    , "Maryland"
    , "Massachusetts"
    , "Michigan"
    , "Minnesota"
    , "Mississippi"
    , "Missouri"
    , "Montana"
    , "Nebraska"
    , "Nevada"
    , "New Hampshire"
    , "New Jersey"
    , "New Mexico"
    , "New York"
    , "North Carolina"
    , "North Dakota"
    , "Northern Marianas Islands"
    , "Ohio"
    , "Oklahoma"
    , "Oregon"
    , "Pennsylvania"
    , "Puerto Rico"
    , "Rhode Island"
    , "South Carolina"
    , "South Dakota"
    , "Tennessee"
    , "Texas"
    , "Utah"
    , "Vermont"
    , "Virginia"
    , "Virgin Islands"
    , "Washington"
    , "West Virginia"
    , "Wisconsin"
    , "Wyoming"
    };

    pAutocomplete->setDataSource(states);
}

MainWidget::~MainWidget()
{
    delete ui;
}

编译运行验证：

注意事项

①在Windows上编译，需手动修改下examples.pro中对静态库文件的引用

②手动拷贝头文件时只需拷贝.h即可（无需拷_p.h），同时目录结构尽量哈components项目目录保持一致。

③编译控件库的版本，应和实际使用控件库的项目的编译器版本对应。如：VS2019(MSVC2019)编译的components.lib，无法放在VS2015 (MSVC2015)中使用，因为库文件和项目的版本不一致。

总结

综上，本文通过简单示例，详细介绍了自己克隆并编译开源控件库，然后应用在自己的项目中的完整流程及注意事项。

通过该开源控件库项目，可学到动态库项目的编译和使用以及pimpl设计模式在项目中的实际应用，相信对实际工作会有一定的帮助。