qmake奇淫技巧之字符串宏定义

阅读本文大概需要3.3分钟

我们平时在软件开发过程中需要定义一些宏，以便在代码中调用，这样每次不需要修改代码，只需要修改外部编译命令就可以得到想要的参数，非常方便

比如我们想在软件介绍中显示软件版本，让别人知道当前使用的软件是那个版本，一般会怎么做呢？

• 直接在代码中写死，版本号是多少
• 从外部配置读取显示
• 编译的时候通过编译条件读取，然后代码中读取对应变量值

今天看看平时使用最多的 Qt Creator 是怎么处理的

随便打开 Qt Creator的关于软件可以看到

通过阅读源码就可以很清楚的知道，Qt Creator是通过在 Pro 配置文件中定义宏，然后在源代码中直接读取显示的

下面来简单说说如何实现，主要包含下面几个过程

1. 在 pro文件中定义字符串宏
2. 宏定义字符串
3. 在源码中直接调用

感兴趣的朋友可以下载 Qt Creator 源码详细查看，墙裂学习 C++ 的朋友去读读源码，真的可以让你学到很多意想不到的知识

pro 定义字符串宏

我们打开源码 qtcreator.pri文件，就可以看到关于版本号的定义

QTCREATOR_VERSION = 4.4.1

上面 QTCREATOR_VERSION 变量定义了一个版本号，在其他配置文件中也可以直接读取该变量

但是，仅仅定义一个变量是不够的，在源码中是无法读取到的，直接编译会报错

宏定义字符串

宏定义就是这样一个简单语句

DEFINES += QTCREATOR_VERSION=\"\\\"$$QTCREATOR_VERSION\\\"\"

在搞清楚上述语法之前，必须要知道反斜杠转义的知识 反斜杠转义

\\（对反斜杠转义）
\[（对中括号转义）
\{（对花括号转义）
\.（对点转义）

说明

• 第一个反斜杠+引号(首尾成对)，表示要对引号转义，告诉 qmake里面是一个字符串；
• 第二个反斜杠对(2个连续反斜杠)，也是转义，表示对反斜杠本身进行转义，最终在 makefile中变成一个反斜杠
• 第三个反斜杠+引号是对引号进行转义，表示里面最终是一个字符串

因此，上述语句最终会生成一个字符串，后面我们直接可以使用该字符串宏

在源码中直接调用

#include "Widget.h"
#include <QApplication>

#include <QDebug>

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);

    qDebug() << APP_NAME << QTCREATOR_VERSION;

    return a.exec();
}


debug out

QtCreator 4.4.1

很轻松就可以定义字符串宏在代码中使用，这个技巧还是很方便的

总结

在定义字符串宏的时候一定要注意，你要定义的字符串是否包含空格，如果没有空格，还可以简单这样写

DEFINES += APP_NAME=\\\"QtCreator\\\"

这是为什呢？我们通过 makefile 文件可以发现，如果你的字符串包含空格，那么处理后会是这个样子

-DAPP_NAME=\"QtCreator -D\" 

qmake在处理时后面多加了一个 -D,进而出现错误

<command-line>:0:10: warning: missing terminating " character

正确的 makefile文件处理过程

DEFINES = -DUNICODE -DQTCREATOR_VERSION="\"4.4.1\"" -DAPP_NAME=\"QtCreator\"
......

后续关于 Qt Creator源码分析会有一个系列进行总结，尽请关注

Qt Creator 代码是开源的，感兴趣的可以直接去下载阅读