qmake的使用簡介
下面是qmake的簡單介紹和使用要領,更為詳細的信息請參閱手冊
qmake的介紹
手寫Makefile是比較困難並且容易出錯的,尤其是需要給不同的平台和編譯器組合寫幾個Makefile。使用qmake,開發者創建一個簡單的“項目”文件並且運行qmake生成適當的Makefile。qmake會注意所有的編譯器和平台的依賴性,可以把開發者解放出來只關心他們的代碼。Trolltech公司使用qmake作為Qt庫和Qt所提供的工具的主要連編工具。
qmake也注意了Qt的特殊需求,可以自動的包含moc和uic的連編規則。
qmake概念
qmake是用來為不同的平台的開發項目創建makefile的Trolltech開發一個易於使用的工具。qmake簡化了makefile的生成,所以為了創建一個makefile只需要一個只有幾行信息的文件。qmake可以供任何一個軟件項目使用,而不用管它是不是用Qt寫的,盡管它包含了為支持Qt開發所擁有的額外的特征。
debug_and_release_target
qmake基於一個項目文件這樣的信息來生成makefile。項目文件可以由開發者生成。項目文件通常很簡單,但是如果需要它是非常完善的。不用修改項目文件,qmake也可以為為Microsoft Visual Studio生成項目。
QMAKESPEC環境變量
舉例來說,如果你在Windows下使用Microsoft Visual Studio,然后你需要把QMAKESPEC環境變量設置為win32-msvc。如果你在Solaris上使用gcc,你需要把QMAKESPEC環境變量設置為solaris-g++。
在qt/mkspecs中的每一個目錄里面,都有一個包含了平台和編譯器特定信息的qmake.conf文件。這些設置適用於你要使用qmake的任何項目,請不要修改它,除非你是一個專家。例如,假如你所有的應用程序都必須和一個特定的庫連接,你可以把這個信息添加到相應的qmake.conf文件中。
qmake的介紹
手寫Makefile是比較困難並且容易出錯的,尤其是需要給不同的平台和編譯器組合寫幾個Makefile。使用qmake,開發者創建一個簡單的“項目”文件並且運行qmake生成適當的Makefile。qmake會注意所有的編譯器和平台的依賴性,可以把開發者解放出來只關心他們的代碼。Trolltech公司使用qmake作為Qt庫和Qt所提供的工具的主要連編工具。
qmake也注意了Qt的特殊需求,可以自動的包含moc和uic的連編規則。
qmake概念
qmake是用來為不同的平台的開發項目創建makefile的Trolltech開發一個易於使用的工具。qmake簡化了makefile的生成,所以為了創建一個makefile只需要一個只有幾行信息的文件。qmake可以供任何一個軟件項目使用,而不用管它是不是用Qt寫的,盡管它包含了為支持Qt開發所擁有的額外的特征。
debug_and_release_target
qmake基於一個項目文件這樣的信息來生成makefile。項目文件可以由開發者生成。項目文件通常很簡單,但是如果需要它是非常完善的。不用修改項目文件,qmake也可以為為Microsoft Visual Studio生成項目。
QMAKESPEC環境變量
舉例來說,如果你在Windows下使用Microsoft Visual Studio,然后你需要把QMAKESPEC環境變量設置為win32-msvc。如果你在Solaris上使用gcc,你需要把QMAKESPEC環境變量設置為solaris-g++。
在qt/mkspecs中的每一個目錄里面,都有一個包含了平台和編譯器特定信息的qmake.conf文件。這些設置適用於你要使用qmake的任何項目,請不要修改它,除非你是一個專家。例如,假如你所有的應用程序都必須和一個特定的庫連接,你可以把這個信息添加到相應的qmake.conf文件中。
項目(.pro)文件
一個項目文件是用來告t訴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需要:應用程序所要連接的資源文件。
LIBS - 包含要鏈接到項目(project)的庫列表文件/ 路徑。用-l (library) 和 -L(library path)。
一個項目文件是用來告t訴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需要:應用程序所要連接的資源文件。
LIBS - 包含要鏈接到項目(project)的庫列表文件/ 路徑。用-l (library) 和 -L(library path)。
你只需要使用那些你已經有值的系統變量,例如,如果你不需要任何額外的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 - 編譯器會輸出盡可能少的警告信息。
debug_and_release : The project is built in both debug and release modes.
debug_and_release_target: The project is built in
both debug and release modes. TARGET is built into
both the debug and release directories.
build_all : If debug_and_release is specified, the project is built in both debug and release modes by default.
下面這些選項定義了所要連編的庫/應用程序的類型:
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庫的類型了。
qmake的使用
編程需要使用makefile,我想大家都應該知道吧。不過在Windows下很多朋友因為長期使用IDE已經不太了解它底層的編譯過程了,建議大家稍微看一下有關這方面的資料。有關makefile的寫法,建議大家到網上去查找有關資料。Linux相關的工具是autoconf/automake
這里我們就介紹一下Trolltech提供的qmake。
Qt中就自帶了qmake,一般在$QTDIR/qmake下就是。當然編譯好的二進制程序都放在$QTDIR/bin下了。
有一個比較重要的環境變量QMAKESPEC,是用來表明操作系統和編譯器的,一般我們用的都是linux-g++。
下面就寫個簡單的例子:
SOURCES = hello.cpp main.cpp
HEADERS = hello.h
CONFIG += qt warn_on release
我們假設你的應用程序是有main.cpp、hello.h、hello.cpp三個文件構成。上述文件內容就是hello.pro文件的內容。這四個文件在同一目錄下。
生成makefile:
qmake -o Makefile hello.pro
這樣就會生成這個項目的Makefile了。
qmake還可以為visual studio生成dsp文件:
qmake -t vcapp -o hello.dsp hello.pro
QT編譯錯誤:
執行qmake-arm時出現錯誤
QMAKESPEC has not been set, so configuration cannot be deduced.
Error processing project file: XXXXX.pro
處理辦法:
這是因為QMAKESPEC變量沒有設置好,在.bash_profile文件里加入一行:
export QMAKESPEC=/home/satellite/qt-everywhere-opensource-src-4.7.3/mkspecs/linux-g++(即是linux-g++的路徑)。