Qt之普通项目如何生成DLL（含源码+注释)

文章目录

一、示例图
二、普通项目需要改造的内容
三、源码（创建了一个TestDLL的项目，更改内容主要在pro文件和maindow.h文件）
- TestDLL.pro
- mainwindow.h
- mainwindow.cpp
- mainwindow.ui
总结

一、示例图

使用不同的编译模式编译，会在对应的编译目录下生成“TestDll”文件夹（在pro文件中添加“DESTDIR = ./TestDll”指定的生成目录），然后根据target指定（没有指定则默认和项目名一致）的名字生成对应的库名，如下图所示。
在这里插入图片描述

二、普通项目需要改造的内容

首先阐述一下此处的“普通项目”指的是通过Qt新建项目，可以直接运行的项目。
普通项目需要生成dll文件只需要在Qt的pro文件中将“TEMPLATE = app”更改为“TEMPLATE = lib“即可。
但是，通过第二点仅仅只能生成dll文件，若是要生成lib文件，则需要在外部类的声明位置使用Q_DECL_EXPORT/Q_DECL_IMPORT标记（当然 lib也可以通过 config += staticlib来生成，但是并不适用于此处）。
Q_DECL_EXPORT，用于导出类或函数，使得在动态链接库时中可以使用这些类或函数。
Q_DECL_IMPORT，用于导入类或函数，目的就是使用通过Q_DECL_EXPORT导出的类或函数。

三、源码（创建了一个TestDLL的项目，更改内容主要在pro文件和maindow.h文件）

TestDLL.pro

在pro文件中添加/更改的内容如下（注意下方的TEST_DLL_FLAG宏）：

# 将原先的app更新为lib
TEMPLATE = lib
# 定义测试库标记（为明确当前为普通项目的标记）
DEFINES += TEST_DLL_FLAG# 根据不同的编译模式生成不同的名字（通常来说debug模式下生成的文件以d结尾）
win32:CONFIG(release, debug|release): {
TARGET = TestDLL
}
else {
TARGET = TestDLLd
}
# 指定生成库的目录
DESTDIR = ./TestDll

完整内容如下：

#-------------------------------------------------
#
# Project created by QtCreator 2023-10-16T23:37:44
#
#-------------------------------------------------QT       += core gui
#生成DLL
TEMPLATE = lib	greaterThan(QT_MAJOR_VERSION, 4): QT += widgets# 定义测试库标记（为明确当前为普通项目的标记）
DEFINES += TEST_DLL_FLAG# 根据不同的编译模式生成不同的名字（通常来说debug模式下生成的文件以d结尾）
win32:CONFIG(release, debug|release): {
TARGET = TestDLL
}
else {
TARGET = TestDLLd
}# 指定生成库的目录
DESTDIR = ./TestDll# The following define makes your compiler emit warnings if you use
# any feature of Qt which has been marked as deprecated (the exact warnings
# depend on your compiler). Please consult the documentation of the
# deprecated API in order to know how to port your code away from it.
DEFINES += QT_DEPRECATED_WARNINGS# You can also make your code fail to compile if you use deprecated APIs.
# In order to do so, uncomment the following line.
# You can also select to disable deprecated APIs only up to a certain version of Qt.
#DEFINES += QT_DISABLE_DEPRECATED_BEFORE=0x060000    # disables all the APIs deprecated before Qt 6.0.0CONFIG += c++11SOURCES += \main.cpp \mainwindow.cppHEADERS += \mainwindow.hFORMS += \mainwindow.ui# Default rules for deployment.
qnx: target.path = /tmp/$${TARGET}/bin
else: unix:!android: target.path = /opt/$${TARGET}/bin
!isEmpty(target.path): INSTALLS += target

mainwindow.h

通过定义的TEST_DLL_FLAG宏区分是导出还是导入状态，当前为普通项目时，会识别到TEST_DLL_FLAG宏，则TEST_DLL_MODE 代表的内容为Q_DECL_EXPORT，反之为Q_DECL_IMPORT，正好对应导出和导入。

#ifndef MAINWINDOW_H
#define MAINWINDOW_H//! 定义库模式宏，为区分到处和导入的模式情况
//! 通常来说，哪个类需要在库外调用在哪个类的定义前方添加模式宏即可
#ifdef TEST_DLL_FLAG
#define TEST_DLL_MODE Q_DECL_EXPORT
#else
#define TEST_DLL_MODE Q_DECL_IMPORT
#endif#include <QMainWindow>namespace Ui {
class TEST_DLL_MODE MainWindow;
}class Q_DECL_EXPORT MainWindow : public QMainWindow
{Q_OBJECTpublic:explicit MainWindow(QWidget *parent = nullptr);~MainWindow();private:Ui::MainWindow *ui;
};#endif // MAINWINDOW_H

mainwindow.cpp

#include "mainwindow.h"
#include "ui_mainwindow.h"MainWindow::MainWindow(QWidget *parent) :QMainWindow(parent),ui(new Ui::MainWindow)
{ui->setupUi(this);
}MainWindow::~MainWindow()
{delete ui;
}

mainwindow.ui

<?xml version="1.0" encoding="UTF-8"?>
<ui version="4.0"><class>MainWindow</class><widget class="QMainWindow" name="MainWindow"><property name="geometry"><rect><x>0</x><y>0</y><width>400</width><height>300</height></rect></property><property name="windowTitle"><string>MainWindow</string></property><widget class="QWidget" name="centralWidget"><layout class="QHBoxLayout" name="horizontalLayout"><item><widget class="QLabel" name="label"><property name="font"><font><pointsize>35</pointsize></font></property><property name="text"><string>测试dll项目</string></property><property name="alignment"><set>Qt::AlignCenter</set></property></widget></item></layout></widget><widget class="QMenuBar" name="menuBar"><property name="geometry"><rect><x>0</x><y>0</y><width>400</width><height>23</height></rect></property></widget><widget class="QToolBar" name="mainToolBar"><attribute name="toolBarArea"><enum>TopToolBarArea</enum></attribute><attribute name="toolBarBreak"><bool>false</bool></attribute></widget><widget class="QStatusBar" name="statusBar"/></widget><layoutdefault spacing="6" margin="11"/><resources/><connections/>
</ui>