qmake 使用总结

qmake 是一种使用简单的makefile生成器,可以通过man qmake 和assistant来了解qmake的使用.

下面系统而简洁的介绍一下它的用法. 大体上掌握qmake的用法

1. 基本用法

qmake -project 生成.pro工程文件

qmake 生成makefile 文件

然后运行make生成可执行文件
举例:
一个工程,由main.cpp,widget.h,widget.cpp 构成,代码如下:

$ cat widget.h
#ifndef WIDGET_H
#define WIDGET_H
#include <QtGui/QWidget>
class Widget:public QWidget
{
    Q_OBJECT
public:
    Widget(QWidget * parent=0);
};
#endif // WIDGET_H

$ cat widget.cpp
#include <QDebug>
#include "widget.h"

Widget::Widget(QWidget *parent)
    :QWidget(parent)
{
	qDebug()<<"this is in class construct!"<<endl;
}

$ cat main.cpp 
#include <QtGui/QApplication>
#include "widget.h"
int main(int argc, char **argv)
{
    QApplication app(argc, argv);
    Widget w;
    w.show();
    app.exec();
}

对于一个小型工程,可以把头文件及体文件放在一个目录下,
对于大型工程,文件众多,需要报文件依据其功能放到不同的目录下,方便管理

2.将文件按目录分开存储

将main.cpp 放到src目录下,将widget.h,widget.cpp放到widget目录下,如图示:

tree
.
├── src
│   └── main.cpp
└── widget
    ├── widget.cpp
    └── widget.h

此时用qmake -project 生成.pro文件,qmake 生成makefile 文件仍然很好用.

加入我们进一步划分,把widget目录生成动态链接库,作为第三方库文件发布

3.生成动态链接库

qmake 的project 一次只能生成一个TEMPLE, TEMPLATE 默认是app,如何修改为TEMPLE = lib ? 当然手改是一种方法,但更好的办法是在命令行指定
查qmake -h,知按如下方式可行

qmake -project -t lib

注: qmake TEMPLATE=lib 并不能改变.pro 中的TEMPLATE值.
qmake 中-set 也不能改变,-set只能改变内部固有变量,内部固有变量可通过qmake -set query来得到,查看基本上我们用不到.另如在代码中添加debug信息,使用如下命令

qmake -project -t lib CONFIG+=debug
看一看该目录下的文件列表

$ tree
.
├── libwidget.so -> libwidget.so.1.0.0
├── libwidget.so.1 -> libwidget.so.1.0.0
├── libwidget.so.1.0 -> libwidget.so.1.0.0
├── libwidget.so.1.0.0
├── Makefile
├── widget.cpp
├── widget.h
└── widget.pro

4.使用第三方库

现在把目光集中到src目录下,在这里生成可执行文件

1. 使用第三方库时需要包含第三方库头文件,那如何指定头文件位置?

建议直接修改.pro文件, 查到INCLUDEPATH, 把第三方头文件位置加入

2. 与第三方库连接时要指明第三方库位置,如何指定?

建议直接修改.pro文件,添加LIBS += 描述行,本例为LIBS += -L…/widget -lwidget
-L后跟库路径
-l后跟库名称
这样就可以编译通过了.

3. 运行时需要加载第三方库,如何指定位置
   一种方式是把第三方库直接copy到/lib 或/usr/lib 目录下,这是库默认加载路径,当然
   ldconfig 命令还可以加载更多的寻找路径
   另一种方式在运行文件中指定第三方库的加载位置,即链接时加上"-Wl,-rpath"方法
   还有一种方法用LD_LIBRARY_PATH 环境变量指定第三方库加载位置
   为完整性这里给出在执行文件中指定第三方库的.pro 写法,参考示例:

$ cat src.pro
######################################################################
# Automatically generated by qmake (2.01a) ?? 11? 20 09:40:57 2019
######################################################################
CONFIG+=debug
TEMPLATE = app
TARGET = 
DEPENDPATH += ../widget
INCLUDEPATH += ../widget

# Input
SOURCES += main.cpp
LIBS += -L../widget -lwidget
#QMAKE_LFLAGS_RPATH = "-Wl,-rpath=../widget",该写法不行,不必深究
QMAKE_LFLAGS += "-Wl,-rpath=../widget"

qt 在pro中添加库和包含路径(简单记为)
LIBS += -L<path> -l<name>
INCLUDEPATH += <path>

另外也可以修改LIBPATH 变量，例如
LIBPATH += /opt/ffmpeg_build/lib
它等价于LIBS += -L<path>
两种方法都可以。
再补充一种方法,直接带路径的库名称，甚至还支持统配符.
例子:
LIBS+= /opt/ffmpeg_build/lib/*.so
注意: LIBS 只能大写，不能小写.小写的libs 无效.

有以上知识已经基本上够用,
研究方法,修改.pro, 查看Makefile 是否满足我们要求,辅以assistant 为参考
我们最好不要直接修改Makefile,因为此时的Makefile 是易变的(由pro生成的).

补充: qmake 中 .pro 中的功能增强语句 $${}

1. message 函数可输出pro中字符串信息
2. $${}可以引用.pro中定义的宏变量, 例如把路径定义成一个变量等,方便引用,如果不产生歧义{}不加也可以
3. $$() 用来引用环境变量.
4. qmake -d 可以输出大量debug 信息,可以参考.
   举例:

BASE_PATH= /opt/ffmpeg_build/lib
message(BASE_PATH=$${BASE_PATH})
message(PATH=$$(PATH)})
LIBS+=$${BASE_PATH}/libavcodec.a

5 修改LFLAGS 选项

这需要修改 QMAKE_LFLAGS 选项， 例如我曾经想修改LFLAGS选项添加 -no-pie 选项， 某些gcc 默认编译出的执行文件是pie格式， 不方便使用addr2line 查看代码地址，所以要添加-no-pie 选项
QMAKE_LFLAGS += -no-pie
测试通过

6 修改gcc 的cflags 或 c++flags

这需要修改QMAKE_CFLAGS 或者QMAKE_CXXFLAGS, 例如修改添加 -g3 选项以增加更多的调试信息,则如下示例:
QMAKE_CFLAGS+=-g3
QMAKE_CXXFLAGS+=-g3