QT 多目录多工程配置

客官°小女子只卖身不卖艺 2022-06-18 08:06 254阅读 0赞

# 写在前面 #

因为项目中我们需要把模块分的比较明确，这样既方便大家分工合作，也方便日后模块重复使用。昨天初次摸索了一下，碰到了BUG。解决了后，决定把这种开发方式和大家分享一下。

# 1. 新建工程 #

新建工程时，我们选择 Other Project -> Subdirs Project 。这个工程即建立一个完整的父工程，在父工程下包含很多子工程，而每个子工程可以当作一个模块进行看待。我将这个工程命名为multi\_project。  
![这里写图片描述][20170401095131751]  
![这里写图片描述][20170401095543749]

## 1.1 添加子工程 ##

一般情况下，会自动弹出一个创建子工程的窗口，如果不小心关掉了也没事，我们通过这样的方式继续创建。我们右击父工程的标题，选择 New Subproject…  
![这里写图片描述][20170401100119366]

## 1.2 作为库函数功能的子工程 ##

一般我们很多子工程中，只有少部分是启动工程，大部分是作为库函数引用进来的，我们最好先创建作为库函数性质的子工程，然后在创建作为启动项目的子工程。作为库函数的子工程请选择 Library -> C++ Library  
![这里写图片描述][20170401100434356]  
它有三个类型选项，这里我们以 Shared Library为例。我将本子工程的名称命名为 CustomWidget  
![这里写图片描述][20170401100520170]

## 1.3 pro文件参数说明 ##

我们打开 新建的子工程的 .pro文件，这里有些知识要和大家说明下。

TARGET = CustomWidget # 指定目标文件的名称。默认情况下包含的项目文件的基本名称。
    TEMPLATE = lib  # 模板告诉qmake为这个应用生成哪种文件。

在本部分 `TEMPLATE = lib` 表明将会生成lib文件，`TARGET = CustomWidget` 表示生成的文件名叫这个。即本模块生成的文件名将会叫 `CustomWidget.lib` （在Windows下）  
据说在Linux下会生成 `libCustomWidget.so` 。

我们在这个工程的 .pro文件中加入一行

DESTDIR = ../bin #指定在何处放置目标文件。

下面两图试着编译了一下这个工程，来帮助大家理解DESTDIR的用处，我们在多工程多文件组织时有必要用到这个东西。  
![这里写图片描述][20170401101844766]  
![这里写图片描述][20170401101906845]

## 1.4 建立应用程序子函数 ##

这里是相当于建立个可执行APP，需要建立什么类型大家根据自己需要进行选择。我这里建立Qt Widgets Application。我将该工程命名为application，我将后面的自动生成ui Form的选项去掉了，打算用代码控制布局。  
![这里写图片描述][20170401102152845]

## 1.5 修改APP工程的依赖关系 ##

我们同样在app工程下添加一句`DESTDIR = ../bin` 确保生成的文件在同一个文件夹  
但APP工程将会用到lib工程的一些内同容，所以我们要将它作为静态库文件引入进来。  
我们在APP工程的头文件下加入如下几行

DESTDIR = ../bin
    
    win32{
       #表示Windows环境的特殊设置，这个大括号不能单独放在下一行，否则编译会报错
    LIBS += ../bin/CustomWidget.lib
    }
    
    unix {
       #表示linux环境的特殊设置，这个大括号不能单独放在下一行，否则编译会报错
    LIBS += ../bin/libCustomWidget.so
    }

## 1.6 更改父工程的 pro 文件 ##

按照教程来做的话，父工程的pro文件内应该只有这几行。

TEMPLATE = subdirs
    
    SUBDIRS += \     CustomWidget \     application

我们在后面加上一行，如下方所示。

TEMPLATE = subdirs
    
    SUBDIRS += \
        CustomWidget \
        application
    
    CONFIG += ordered

该字段的涵义是：**使用subdirs模板时，此选项指定应该按照目录列表的顺序处理它们。**  
这样能保证lib工程在应用程序工程前执行（因为app工程里用到了lib工程的编译结果，所以必须有先后的编译顺序），如果新建顺序错了，可以在这里手动更改上方 `SUBDIRS` 内的顺序，将lib工程放在前边。

## 1.7 目前状态 ##

到目前为止，工程应该是这样的状态。  
![这里写图片描述][20170401103102237]

# 2.编写简易的自定义库 #

## 2.1 增加一个继承 QLabel 的类 ##

我们右击 CustomWidget工程名，选择 Add New。然后再选择`C++ -> C++ Class`

![这里写图片描述][20170401104215689]

新建完成后，可以完善我们的类。

这里有一点需要注意，我们看到列表中有个customwidget\_global.h文件。文件内容如下“

// customwidget_global.h
    
    #ifndef CUSTOMWIDGET_GLOBAL_H
    #define CUSTOMWIDGET_GLOBAL_H
    
    #include <QtCore/qglobal.h>
    
    #if defined(CUSTOMWIDGET_LIBRARY)
    # define CUSTOMWIDGETSHARED_EXPORT Q_DECL_EXPORT
    #else
    # define CUSTOMWIDGETSHARED_EXPORT Q_DECL_IMPORT
    #endif
    
    #endif // CUSTOMWIDGET_GLOBAL_H

其中这个`CUSTOMWIDGETSHARED_EXPORT` 字段需要注意，它是Qt 的宏，你新增的类，要在类的声明中加入该字段才能够生成在 lib文件里，我就是因为没有注意到这个问题，才调试了好长时间。

## 2.2 customLabel类 ##

头文件

#ifndef CUSTOMLABEL_H
    #define CUSTOMLABEL_H
    
    #include <QLabel>
    #include "customwidget_global.h"
    
    
    class CUSTOMWIDGETSHARED_EXPORT CustomLabel : public QLabel { 
        Q_OBJECT
    public:
        CustomLabel(QLabel *parent = 0);
    };
    
    #endif // CUSTOMLABEL_H

cpp文件

#ifndef CUSTOMLABEL_H
    #define CUSTOMLABEL_H
    
    #include <QLabel>
    #include "customwidget_global.h"
    
    
    #include "customlabel.h"
    
    CustomLabel::CustomLabel(QLabel *parent):
        QLabel(parent)
    {
        this->QLabel::setText(QObject::tr("这是一个自定义Label文件"));
    }

## 2.3 CustomWidget 类 ##

头文件

#ifndef CUSTOMWIDGET_H
    #define CUSTOMWIDGET_H
    
    #include "customwidget_global.h"
    
    #include <QWidget>
    #include "customlabel.h"
    
    class CUSTOMWIDGETSHARED_EXPORT CustomWidget :public QWidget { 
    
    public:
        CustomWidget(QWidget *parent =0);
        ~CustomWidget();
    private:
        CustomLabel * label1;
        CustomLabel * label2;
        QLayout * layout;
    };
    
    #endif // CUSTOMWIDGET_H

CPP文件

#include "customwidget.h"
    
    #include<QHBoxLayout>
    
    CustomWidget::CustomWidget(QWidget *parent):
        QWidget(parent)
    {
        label1 = new CustomLabel();
        label2 = new CustomLabel();
        label2->setText(QObject::tr("继承测试"));
    
        // 设置布局
        layout = new QHBoxLayout;
        layout->addWidget(label1);
        layout->addWidget(label2);
    
        // 将布局加入到widget
        this->setLayout(layout);
    
    }
    
    /**************************** * 析构函数用来释放空间 * *************************/
    CustomWidget::~CustomWidget(){
    
        if(label1 == NULL)
        {
            delete label1;
        }
        if(label2 == NULL)
        {
            delete label2;
        }
        if(layout == NULL)
        {
            delete layout;
        }
    
    }

# 3.APP 程序 #

## 3.1 MainWindow类实现 ##

头文件

#ifndef MAINWINDOW_H
    #define MAINWINDOW_H
    
    #include <QMainWindow>
    #include "../CustomWidget/customwidget.h"
    
    class MainWindow : public QMainWindow
    {
        Q_OBJECT
    
    public:
        MainWindow(QWidget *parent = 0);
        ~MainWindow();
    private:
        CustomWidget * widget;
    
    };
    
    #endif // MAINWINDOW_H

CPP文件

#include "mainwindow.h"
    
    MainWindow::MainWindow(QWidget *parent)
        : QMainWindow(parent)
    {
        widget = new CustomWidget();
        this->setCentralWidget(widget); // 设置widget
        this->setFixedSize(800,600);
        this->setWindowTitle(QObject::tr("这是测试窗口"));
    }
    
    MainWindow::~MainWindow()
    {
        if(this->widget == NULL)
        {
            delete widget;
        }
    }

## 3.2 编译运行 ##

我们编译运行，可以看到效果如下图所示。  
![这里写图片描述][20170401110559240]  
如此，我们便实现了在多个子工程中分模块编写。通过建立多个lib子工程，可以将模块话的任务分给更多的同伴来合作，谢谢大家

# 4. 示例工程分享 #

[下载链接][Link 1] 需要1下载积分，谢谢各位姥爷支持。

# 参考链接 #

pro文件里字段解释 [http://blog.csdn.net/liang19890820/article/details/51774724][http_blog.csdn.net_liang19890820_article_details_51774724]

[20170401095131751]: /images/20220618/58fccf8b34694b01b11cccb450abc40c.png
[20170401095543749]: /images/20220618/d4611a8cbd5b48e280d55d2a247cb0c5.png
[20170401100119366]: /images/20220618/3cb76c9abde741279c35c0ceeb2a94bd.png
[20170401100434356]: /images/20220618/197a2575c02a4b75ae666f750d527b66.png
[20170401100520170]: /images/20220618/f78c2326783f4bffbbd840f58d83a27f.png
[20170401101844766]: /images/20220618/6dc8b741676a4cf18e951a0d8333831e.png
[20170401101906845]: /images/20220618/d7b5292758b34090b0b662351e926d0d.png
[20170401102152845]: /images/20220618/e8e53a78d0e84a50a0a94986af23ff6a.png
[20170401103102237]: /images/20220618/d2e5794fefb14c7e8230d796d7edfc26.png
[20170401104215689]: /images/20220618/896d8e3835124750bbfa44bfd6433cee.png
[20170401110559240]: /images/20220618/c5c961b8c98d4b85a200fe55a0b027f4.png
[Link 1]: http://download.csdn.net/detail/jcq521045349/9801097
[http_blog.csdn.net_liang19890820_article_details_51774724]: http://blog.csdn.net/liang19890820/article/details/51774724