2009年5月1日 星期五

qmake教學

在寫Unix程式時,需要透過Makefile使得在改寫程式碼時,要重新編譯會比較容易。
但是,好的Makefile確是非常難寫。
是的,Qt提供了qmake可以產生Makefile,而基本上,我們只要學會如何寫*.pro檔就可以很容易產生Makefile啦~

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

#」註釋

你可以為項目文件添加註釋。註釋由「#」符號開始,一直到這一行的結束。

TEMPLATE」模板

模板變數告訴qmake為這個應用程序生成哪種makefile。下面是可供使用的選擇:
app - 建立一個應用程序的makefile。這是預設值,所以如果TEMPLATE沒有被指定,這個將被使用。
lib - 建立一個函式庫的makefile。
vcapp - 建立一個應用程序的Visual Studio項目文件。
vclib - 建立一個函式庫的Visual Studio項目文件。
subdirs - 這是一個特殊的模板,它可以建立一個能夠進入特定目錄並且為一個項目文件生成makefile並且為它調用make的makefile。

app」模板

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

HEADERS - 應用程序中的所有*.h的列表。
SOURCES - 應用程序中的所有*.cpp的列表。
FORMS - 應用程序中的所有.ui文件(由Qt設計器生成)的列表。
LEXSOURCES - 應用程序中的所有lex源文件的列表。
YACCSOURCES - 應用程序中的所有yacc源文件的列表。
TARGET - 可執行應用程序的名稱。默認值為項目文件的名稱。(如果需要擴展名,會被自動加上。)
DESTDIR - 放置可執行程序目標的目錄。
DEFINES - 應用程序所需的額外的預處理程序定義的列表。(就好像gcc中的 -D)
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庫的類型了。

如果要使用Qt的網路以及多線程函式庫,可以指定
QT += network

在非 Qt 程序中使用 qmake
事實上,qmake非常好用,我們甚至想在非Qt程序中使用它。這也很容易。只要加入
CONFIG -= qt
那麼qmake就不會添加任何和Qt函式庫相關的header file以及lib之類的進來了。

參考資料:
qmake概念
qmake Command Reference

沒有留言: