關於qmake以及.pro文件的詳細介紹

qmake概念

介紹qmake

qmake是用來爲不同的平臺的開發項目創建makefile的Trolltech開發一個易於使用的工具。qmake簡化了makefile的生成，所以爲了創建一個makefile只需要一個只有幾行信息的文件。qmake可以供任何一個軟件項目使用，而不用管它是不是用Qt寫的，儘管它包含了爲支持Qt開發所擁有的額外的特徵。

qmake基於一個項目文件這樣的信息來生成makefile。項目文件可以由開發者生成。項目文件通常很簡單，但是如果需要它是非常完善的。不用修改項目文件，qmake也可以爲爲Microsoft Visual Studio生成項目。

qmake的概念

QMAKESPEC環境變量

舉例來說，如果你在Windows下使用Microsoft Visual Studio，然後你需要把QMAKESPEC環境變量設置爲win32-msvc。如果你在Solaris上使用gcc，你需要把QMAKESPEC環境變量設置爲solaris-g++。

在qt/mkspecs中的每一個目錄裏面，都有一個包含了平臺和編譯器特定信息的qmake.conf文件。這些設置適用於你要使用qmake的任何項目，請不要修改它，除非你是一個專家。例如，假如你所有的應用程序都必須和一個特定的庫連接，你可以把這個信息添加到相應的qmake.conf文件中。

項目(.pro)文件

一個項目文件是用來告訴qmake關於爲這個應用程序創建makefile所需要的細節。例如，一個源文件和頭文件的列表、任何應用程序特定配置、例如一個必需要連接的額外庫、或者一個額外的包含路徑，都應該放到項目文件中。

“#”註釋

你可以爲項目文件添加註釋。註釋由“#”符號開始，一直到這一行的結束。

模板

模板變量告訴qmake爲這個應用程序生成哪種makefile。下面是可供使用的選擇：

• app - 建立一個應用程序的makefile。這是默認值，所以如果模板沒有被指定，這個將被使用。

• lib - 建立一個庫的makefile。

• vcapp - 建立一個應用程序的Visual Studio項目文件。

• vclib - 建立一個庫的Visual Studio項目文件。

• subdirs - 這是一個特殊的模板，它可以創建一個能夠進入特定目錄並且爲一個項目文件生成makefile並且爲它調用make的makefile。

“app”模板

“app”模板告訴qmake爲建立一個應用程序生成一個makefile。當使用這個模板時，下面這些qmake系統變量是被承認的。你應該在你的.pro文件中使用它們來爲你的應用程序指定特定信息。

• HEADERS - 應用程序中的所有頭文件的列表。

• SOURCES - 應用程序中的所有源文件的列表。

• FORMS - 應用程序中的所有.ui文件（由Qt設計器生成）的列表。

• LEXSOURCES - 應用程序中的所有lex源文件的列表。

• YACCSOURCES - 應用程序中的所有yacc源文件的列表。

• TARGET - 可執行應用程序的名稱。默認值爲項目文件的名稱。（如果需要擴展名，會被自動加上。）

• DESTDIR - 放置可執行程序目標的目錄。

• DEFINES - 應用程序所需的額外的預處理程序定義的列表。

• INCLUDEPATH - 應用程序所需的額外的包含路徑的列表。

• DEPENDPATH - 應用程序所依賴的搜索路徑。

• VPATH - 尋找補充文件的搜索路徑。

• DEF_FILE - 只有Windows需要：應用程序所要連接的.def文件。

• RC_FILE - 只有Windows需要：應用程序的資源文件。

• RES_FILE - 只有Windows需要：應用程序所要連接的資源文件。

你只需要使用那些你已經有值的系統變量，例如，如果你不需要任何額外的INCLUDEPATH，那麼你就不需要指定它，qmake會爲所需的提供默認值。例如，一個實例項目文件也許就像這樣：

TEMPLATE = app
DESTDIR  = c:\helloapp
HEADERS += hello.h
SOURCES += hello.cpp 
SOURCES += main.cpp
DEFINES += QT_DLL
CONFIG  += qt warn_on release

注意換行符用'\'

如果條目是單值的，比如template或者目的目錄，我們是用“=”，但如果是多值條目，我們使用“+=”來爲這個類型添加現有的條目。使用“=”會用新值替換原有的值，例如，如果我們寫了DEFINES=QT_DLL，其它所有的定義都將被刪除。

“lib”模板

“lib”模板告訴qmake爲建立一個庫而生成makefile。當使用這個模板時，除了“app”模板中提到系統變量，還有一個VERSION是被支持的。你需要在爲庫指定特定信息的.pro文件中使用它們。

• VERSION - 目標庫的版本號，比如，2.3.1。

“subdirs”模板

“subdirs”模板告訴qmake生成一個makefile，它可以進入到特定子目錄併爲這個目錄中的項目文件生成makefile並且爲它調用make。

在這個模板中只有一個系統變量SUBDIRS可以被識別。這個變量中包含了所要處理的含有項目文件的子目錄的列表。這個項目文件的名稱是和子目錄同名的，這樣qmake就可以發現它。例如，如果子目裏是“myapp”，那麼在這個目錄中的項目文件應該被叫做myapp.pro。

CONFIG變量

配置變量指定了編譯器所要使用的選項和所需要被連接的庫。配置變量中可以添加任何東西，但只有下面這些選項可以被qmake識別。

下面這些選項控制着使用哪些編譯器標誌：

• release - 應用程序將以release模式連編。如果“debug”被指定，它將被忽略。

• debug - 應用程序將以debug模式連編。

• warn_on - 編譯器會輸出儘可能多的警告信息。如果“warn_off”被指定，它將被忽略。

• warn_off - 編譯器會輸出儘可能少的警告信息。

下面這些選項定義了所要連編的庫/應用程序的類型：

• qt - 應用程序是一個Qt應用程序，並且Qt庫將會被連接。

• thread - 應用程序是一個多線程應用程序。

• x11 - 應用程序是一個X11應用程序或庫。

• windows - 只用於“app”模板：應用程序是一個Windows下的窗口應用程序。

• console - 只用於“app”模板：應用程序是一個Windows下的控制檯應用程序。

• dll - 只用於“lib”模板：庫是一個共享庫（dll）。

• staticlib - 只用於“lib”模板：庫是一個靜態庫。

• plugin - 只用於“lib”模板：庫是一個插件，這將會使dll選項生效。

例如，如果你的應用程序使用Qt庫，並且你想把它連編爲一個可調試的多線程的應用程序，你的項目文件應該會有下面這行：

    CONFIG += qt thread debug

注意，你必須使用“+=”，不要使用“=”，否則qmake就不能正確使用連編Qt的設置了，比如沒法獲得所編譯的Qt庫的類型了。