Qt 之 pro 配置詳解

阿新 • • 發佈：2019-01-20

簡述

使用Qt的時候，我們經常會對pro進行一系列繁瑣的配置，為方便大家理解、查詢，現將常用的配置進行整理。

配置

註釋

以“#”開始，到這一行結束。
快捷鍵：Ctrl + /

CONFIG

指定編譯器選項和專案配置，值由qmake內部識別並具有特殊意義。

以下配置值控制編譯標誌：

選項	說明
release	專案以release模式構建。如果也指定了debug，那麼最後一個生效。
debug	專案以debug模式構建。
debug_and_release	專案準備以debug和release兩種模式構建。
debug_and_release_target	此選項預設設定。如果也指定了debug_and_release，最終的debug和release構建在不同的目錄。
build_all	如果指定了debug_and_release，預設情況下，該專案會構建為debug和release模式。
autogen_precompile_source	自動生成一個.cpp檔案，包含在.pro中指定的預編譯標頭檔案。
ordered	使用subdirs模板時，此選項指定應該按照目錄列表的順序處理它們。
precompile_header	可以在專案中使用預編譯標頭檔案的支援。
warn_on	編譯器應該輸出儘可能多的警告。如果也指定了warn_off，最後一個生效。
warn_off	編譯器應該輸出儘可能少的警告。
exceptions	啟用異常支援。預設設定。
exceptions_off	禁用異常支援。
rtti	啟用RTTI支援。預設情況下，使用編譯器預設。
rtti_off	禁用RTTI支援。預設情況下，使用編譯器預設。
stl	啟用STL支援。預設情況下，使用編譯器預設。
stl_off	禁用STL支援。預設情況下，使用編譯器預設。
thread	啟用執行緒支援。當CONFIG包括qt時啟用，這是預設設定。
c++11	啟用c++11支援。如果編譯器不支援c++11這個選項，沒有影響。預設情況下，支援是禁用的。
c++14	啟用c++14支援。如果編譯器不支援c++14這個選項，沒有影響。預設情況下，支援是禁用的。

當使用debug和release選項時(Windows下預設的)，該專案將被處理三次：一次生成一個”meta”Makefile，另外兩次生成Makefile.Debug和Makefile.Release。

在後面的次數，build_pass和相應的debug或release新增到CONFIG選項。這使得它可以執行構建特定任務。

例如：

build_pass:CONFIG(debug, debug|release) {
    unix: TARGET = $$join(TARGET,,,_debug)
    else: TARGET = $$join(TARGET,,,d)
}

DEFINES

qmake新增這個變數的值作為編譯器C前處理器巨集(-D選項)。

例如：

DEFINES += USE_MY_STUFF

然後就可以在程式碼中使用：

#ifdef USE_MY_STUFF
    // TODO
#else
    // TODO
#endif

往往可以指定專案的特殊版本（比如：正式版、試用版）、對一些特殊功能模組（比如：加密狗）進行限制等。

DEPENDPATH

指定檢視解決依賴關係的目錄列表，當包含檔案時使用。

例如：

DEPENDPATH += . forms include qrc sources

DESTDIR

指定在何處放置目標檔案。

例如：

DESTDIR = ../../lib

FORMS

指定UI檔案（參考： Qt Designer Manual）在編譯前被uic處理。所有的構建這些UI檔案所需的依賴、標頭檔案和原始檔都會自動被新增到專案中。

例如：

FORMS = mydialog.ui \
        mywidget.ui \
        myconfig.ui

HEADERS

指定專案中所有的標頭檔案。

qmake會自動檢測是標頭檔案的類中是否需要moc，並增加適當的依賴關係和檔案到專案中，來生成和連結moc檔案。

例如：

HEADERS = myclass.h \
          login.h \
          mainwindow.h

INCLUDEPATH

指定編譯專案時應該被搜尋的#include目錄。

例如：

INCLUDEPATH = c:/msdev/include d:/stl/include

如果路徑包含空格，需要使用引號包含。

win32:INCLUDEPATH += "C:/mylibs/extra headers"
unix:INCLUDEPATH += "/home/user/extra headers"

LIBS

指定連結到專案中的庫列表。如果使用Unix -l (library) 和 -L (library path) 標誌，在Windows上qmake正確處理庫（也就是說，將庫的完整路徑傳遞給連結器），庫必須存在，qmake會尋找-l指定的庫所在的目錄。

例如：

win32:LIBS += c:/mylibs/math.lib
unix:LIBS += -L/usr/local/lib -lmath

如果路徑包含空格，需要使用引號包含路徑。

win32:LIBS += "C:/mylibs/extra libs/extra.lib"
unix:LIBS += "-L/home/user/extra libs" -lextra

MOC_DIR

指定來自moc的所有中間檔案放置的目錄（含Q_OBJECT巨集的標頭檔案轉換成標準.h檔案的存放目錄）。

例如：

unix:MOC_DIR = ../myproject/tmp
win32:MOC_DIR = c:/myproject/tmp

OBJECTS_DIR

指定所有中間檔案.o（.obj）放置的目錄。

例如：

unix:OBJECTS_DIR = ../myproject/tmp
win32:OBJECTS_DIR = c:/myproject/tmp

QT

指定專案中使用Qt的模組。預設情況下，QT包含core和gui，以確保標準的GUI應用程式無需進一步的配置就可以構建。

如果想建立一個不包含Qt GUI模組的專案，可以使用“ -=”操作符。

下面一行將構建一個很小的Qt專案：

QT -= gui # 僅僅使用core模組

如果要建立一個介面，裡面用到XML及網路相關的類，那麼需要包含如下模組：

QT += core gui widgets xml network

如果你的專案是一個Qt Designer外掛，使用值uiplugin指定專案構建成庫，但特定的Qt Designer外掛支援，請參考：Building and Installing the Plugin。

RCC_DIR

指定Qt資源編譯器輸出檔案的目錄（.qrc檔案轉換成qrc_*.h檔案的存放目錄）。

例如：

unix:RCC_DIR = ../myproject/resources
win32:RCC_DIR = c:/myproject/resources

RESOURCES

指定資原始檔 (qrc) 的名稱，參考：Qt之資源系統

例如：

RESOURCES += Resource/resource.qrc

RC_FILE

指定應用程式資原始檔的名稱。這個變數的值通常是由qmake或qmake.conf處理，很少需要進行修改。

例如：

RC_FILE += myapp.rc

RC_ICONS

僅適用於Windows，指定的圖示應該包含在一個生成的.rc檔案裡。如果RC_FILE 和RES_FILE變數都沒有設定這才可利用。

例如：

RC_ICONS = myapp.ico

SOURCES

指定專案中所有原始檔。

例如：

SOURCES = myclass.cpp \
          login.cpp \
          mainwindow.cpp

TARGET

指定目標檔案的名稱。預設情況下包含的專案檔案的基本名稱。

例如：

TEMPLATE = app
TARGET = myapp
SOURCES = main.cpp

上面專案會生成一個可執行檔案，Windows下為myapp.exe，Unix下為myapp。

TEMPLATE

模板變數告訴qmake為這個應用程式生成哪種makefile。

可供使用的選項：

選項	說明
app	建立一個用於構建應用程式的Makefile（預設）。
lib	建立一個用於構建庫的Makefile。
subdirs	建立一個用於構建目標子目錄的Makefile，子目錄使用SUBDIRS變數指定。
aux	建立一個不建任何東西的Makefile。如果沒有編譯器需要被呼叫來建立目標，比如你的專案使用解釋型語言寫的，使用此功能。注：此模板型別只能用於Makefile-based生成器。特別是，它不會工作在vcxproj和Xcode生成器。
vcapp	僅適用於Windows。建立一個Visual Studio應用程式專案。
vclib	僅適用於Windows。建立一個Visual Studio庫專案。

例如：

TEMPLATE = lib
SOURCES = main.cpp
TARGET = mylib

TRANSLATIONS

指定包含使用者介面翻譯文字的翻譯(.ts)檔案列表。

例如：

TRANSLATIONS += Resource/myapp_zh.ts \
                Resource/myapp_en.ts

UI_DIR

指定來自uic的所有中間檔案放置的目錄（.ui檔案轉化成ui_*.h檔案的存放目錄）。

例如：

unix:UI_DIR = ../myproject/ui
win32:UI_DIR = c:/myproject/ui