C/C++ 通用 Makefile

C/C++ 通用 Makefile Generic Makefile for C/C++ Program ================================================== Keywords: Makefile, make, Generic, C/C++ Author:   whyglinux (whyglinux AT hotmail DOT com) Date:     2006-03-04 ================================================== 本文提供了一個用於對 C/C++ 程式進行編譯和串連以產生可執行程式的通用 Makefile。 在使用 Makefile 之前，只需對它進行一些簡單的設定即可；而且一經設定，即使以後對來源程式檔案有所增減一般也不再需要改動 Makefile。因此，即便是一個沒有學習過 Makefile 書寫規則的人，也可以為自己的 C/C++ 程式快速建立一個可工作的 Makefile。 這個 Makefile 可以在 GNU Make 和 GCC 編譯器下正常工作。但是不能保證對於其它版本的 Make 和編譯器也能正常工作。 如果你發現了本文中的錯誤，或者對本文有什麼感想或建議，可通過 whyglinux AT hotmail DOT com 郵箱和作者聯絡。 此 Makefile 的使用方法如下： 程式目錄的組織 盡量將自己的來源程式集中在一個目錄中，並且把 Makefile 和來源程式放在一起，這樣用起來比較方便。當然，也可以將來源程式分類存放在不同的目錄中。 在程式目錄中建立一個名為 Makefile 的文字檔，將後面列出的 Makefile 的內容複寫到這個檔案中。（注意：在複製的過程中，Makfile 中各命令前面的 Tab 字元有可能被轉換成若干個空格。這種情況下需要把 Makefile 命令前面的這些空格替換為一個 Tab。） 將當前工作目錄切換到 Makefile 所在的目錄。目前，這個 Makefile 只支援在目前的目錄中的調用，不支援目前的目錄和 Makefile 所在的路徑不是同一目錄的情況。 指定可執行檔 程式編譯和串連成功後產生的可執行檔在 Makefile 中的 PROGRAM 變數中設定。這一項不可為空。為自己程式的可執行檔起一個有意義的名子吧。 指定來源程式 要編譯的來源程式由其所在的路徑和檔案的副檔名兩項來確定。由於標頭檔是通過包含來使用的，所以在這裡說的來源程式不應包含標頭檔。 程式所在的路徑在 SRCDIRS 中設定。如果來源程式分布在不同的目錄中，那麼需要在 SRCDIRS 中一一指定，並且路徑名之間用空格分隔。 在 SRCEXTS 中指定程式中使用的檔案類型。C/C++ 程式的副檔名一般有比較固定的幾種形式：.c、.C、.cc、.cpp、.CPP、.c++、.cp、或者.cxx（參見 man gcc）。副檔名決定了程式是 C 還是 C++ 程式：.c 是 C 程式，其它副檔名表示 C++ 程式。一般固定使用其中的一種副檔名即可。但是也有可能需要使用多種副檔名，這可以在 SOURCE_EXT 中一一指定，各個副檔名之間用空格分隔。 雖然並不常用，但是 C 程式也可以被作為 C++ 程式編譯。這可以通過在 Makefile 中設定 CC = $(CXX) 和 CFLAGS = $(CXXFLAGS) 兩項即可實現。 這個 Makefile 支援 C、C++ 以及 C/C++ 混合三種編譯方式： 如果只指定 .c 副檔名，那麼這是一個 C 程式，用 $(CC) 表示的編譯命令進行編譯和串連。 如果指定的是除 .c 之外的其它副檔名（如 .cc、.cpp、.cxx 等），那麼這是一個 C++ 程式，用 $(CXX) 進行編譯和串連。 如果既指定了 .c，又指定了其它 C++ 副檔名，那麼這是 C/C++ 混合程式，將用 $(CC) 編譯其中的 C 程式，用 $(CXX) 編譯其中的 C++ 程式，最後再用 $(CXX) 串連程式。 這些工作都是 make 根據在 Makefile 中提供的程式檔案類型（副檔名）自動判斷進行的，不需要使用者幹預。 指定編譯選項 編譯選項由三部分組成：預先處理選項、編譯選項以及串連選項，分別由 CPPFLAGS、CFLAGS與CXXFLAGS、LDFLAGS 指定。 CPPFLAGS 選項可參考 C 預先處理命令 cpp 的說明，但是注意不能包含 -M 以及和 -M 有關的選項。如果是 C/C++ 混合編程，也可以在這裡設定 C/C++ 的一些共同的編譯選項。 CFLAGS 和 CXXFLAGS 兩個變數通常用來指定編譯選項。前者僅僅用於指定 C 程式的編譯選項，後者僅僅用於指定 C++ 程式的編譯選項。其實也可以在兩個變數中指定一些預先處理選項（即一些本來應該放在 CPPFLAGS 中的選項），和 CPPFLAGS 並沒有明確的界限。 串連選項在 LDFLAGS 中指定。如果只使用 C/C++ 標準庫，一般沒有必要設定。如果使用了非標準庫，應該在這裡指定串連需要的選項，如庫所在的路徑、庫名以及其它聯結選項。 現在的庫一般都提供了一個相應的 .pc 檔案來記錄使用庫所需要的先行編譯選項、編譯選項和串連選項等資訊，通過 pkg-config 可以動態提取這些選項。與由使用者顯式指定各個選項相比，使用 pkg-config 來訪問庫提供的選項更方便、更具通用性。在後面可以看到一個 GTK+ 程式的例子，其編譯和串連選項的指定就是用 pkg-config 實現的。 編譯和串連 上面的各項設定好之後儲存 Makefile 檔案。執行 make 命令，程式就開始編譯了。 命令 make 會根據 Makefile 中設定好的路徑和檔案類型搜尋來源程式檔案，然後根據檔案的類型調用相應的編譯命令、使用相應的編譯選項對程式進行編譯。 編譯成功之後程式的串連會自動進行。如果沒有錯誤的話最終會產生程式的可執行檔。 注意：在對程式編譯之後，會產生和來源程式檔案一一對應的 .d 檔案。這是表示依賴關係的檔案，通過它們 make 決定在來源程式檔案變動之後要進行哪些更新。為每一個來源程式檔案建立相應的 .d 檔案這也是 GNU Make 推薦的方式。 Makefile 目標（Targets） 下面是關於這個 Makefile 提供的目標以及它所完成的功能： make 編譯和串連程式。相當於 make all。 make objs 僅僅編譯器產生 .o 目標檔案，不進行串連（一般很少單獨使用）。 make clean 刪除編譯產生的目標檔案和依賴檔案。 make cleanall 刪除目標檔案、依賴檔案以及可執行檔。 make rebuild 重新編譯和串連程式。相當於 make clean && make all。 關於這個 Makefile 的實現原理不準備詳細解釋了。如果有興趣的話，可參考文末列出的“參考資料”。 Makefile 的內容如下：###############################################################################<br />#<br /># Generic Makefile for C/C++ Program<br />#<br /># Author: whyglinux (whyglinux AT hotmail DOT com)<br /># Date: 2006/03/04<br /># Description:<br /># The makefile searches in <SRCDIRS> directories for the source files<br /># with extensions specified in <SOURCE_EXT>, then compiles the sources<br /># and finally produces the <PROGRAM>, the executable file, by linking<br /># the objectives.<br /># Usage:<br /># $ make compile and link the program.<br /># $ make objs compile only (no linking. Rarely used).<br /># $ make clean clean the objectives and dependencies.<br /># $ make cleanall clean the objectives, dependencies and executable.<br /># $ make rebuild rebuild the program. The same as make clean && make all.<br />#==============================================================================<br />## Customizing Section: adjust the following if necessary.<br />##=============================================================================<br /># The executable file name.<br /># It must be specified.<br /># PROGRAM := a.out # the executable name<br />PROGRAM :=<br /># The directories in which source files reside.<br /># At least one path should be specified.<br /># SRCDIRS := . # current directory<br />SRCDIRS :=<br /># The source file types (headers excluded).<br /># At least one type should be specified.<br /># The valid suffixes are among of .c, .C, .cc, .cpp, .CPP, .c++, .cp, or .cxx.<br /># SRCEXTS := .c # C program<br /># SRCEXTS := .cpp # C++ program<br /># SRCEXTS := .c .cpp # C/C++ program<br />SRCEXTS :=<br /># The flags used by the cpp (man cpp for more).<br /># CPPFLAGS := -Wall -Werror # show all warnings and take them as errors<br />CPPFLAGS :=<br /># The compiling flags used only for C.<br /># If it is a C++ program, no need to set these flags.<br /># If it is a C and C++ merging program, set these flags for the C parts.<br />CFLAGS :=<br />CFLAGS +=<br /># The compiling flags used only for C++.<br /># If it is a C program, no need to set these flags.<br /># If it is a C and C++ merging program, set these flags for the C++ parts.<br />CXXFLAGS :=<br />CXXFLAGS +=<br /># The library and the link options ( C and C++ common).<br />LDFLAGS :=<br />LDFLAGS +=<br />## Implict Section: change the following only when necessary.<br />##=============================================================================<br /># The C program compiler. Uncomment it to specify yours explicitly.<br />#CC = gcc<br /># The C++ program compiler. Uncomment it to specify yours explicitly.<br />#CXX = g++<br /># Uncomment the 2 lines to compile C programs as C++ ones.<br />#CC = $(CXX)<br />#CFLAGS = $(CXXFLAGS)<br /># The command used to delete file.<br />#RM = rm -f<br />## Stable Section: usually no need to be changed. But you can add more.<br />##=============================================================================<br />SHELL = /bin/sh<br />SOURCES = $(foreach d,$(SRCDIRS),$(wildcard $(addprefix $(d)/*,$(SRCEXTS))))<br />OBJS = $(foreach x,$(SRCEXTS), /<br /> $(patsubst %$(x),%.o,$(filter %$(x),$(SOURCES))))<br />DEPS = $(patsubst %.o,%.d,$(OBJS))<br />.PHONY : all objs clean cleanall rebuild<br />all : $(PROGRAM)<br /># Rules for creating the dependency files (.d).<br />#---------------------------------------------------<br />%.d : %.c<br /> @$(CC) -MM -MD $(CFLAGS) $<<br />%.d : %.C<br /> @$(CC) -MM -MD $(CXXFLAGS) $<<br />%.d : %.cc<br /> @$(CC) -MM -MD $(CXXFLAGS) $<<br />%.d : %.cpp<br /> @$(CC) -MM -MD $(CXXFLAGS) $<<br />%.d : %.CPP<br /> @$(CC) -MM -MD $(CXXFLAGS) $<<br />%.d : %.c++<br /> @$(CC) -MM -MD $(CXXFLAGS) $<<br />%.d : %.cp<br /> @$(CC) -MM -MD $(CXXFLAGS) $<<br />%.d : %.cxx<br /> @$(CC) -MM -MD $(CXXFLAGS) $<<br /># Rules for producing the objects.<br />#---------------------------------------------------<br />objs : $(OBJS)<br />%.o : %.c<br /> $(CC) -c $(CPPFLAGS) $(CFLAGS) $<<br />%.o : %.C<br /> $(CXX) -c $(CPPFLAGS) $(CXXFLAGS) $<<br />%.o : %.cc<br /> $(CXX) -c $(CPPFLAGS) $(CXXFLAGS) $<<br />%.o : %.cpp<br /> $(CXX) -c $(CPPFLAGS) $(CXXFLAGS) $<<br />%.o : %.CPP<br /> $(CXX) -c $(CPPFLAGS) $(CXXFLAGS) $<<br />%.o : %.c++<br /> $(CXX -c $(CPPFLAGS) $(CXXFLAGS) $<<br />%.o : %.cp<br /> $(CXX) -c $(CPPFLAGS) $(CXXFLAGS) $<<br />%.o : %.cxx<br /> $(CXX) -c $(CPPFLAGS) $(CXXFLAGS) $<<br /># Rules for producing the executable.<br />#----------------------------------------------<br />$(PROGRAM) : $(OBJS)<br />ifeq ($(strip $(SRCEXTS)), .c) # C file<br /> $(CC) -o $(PROGRAM) $(OBJS) $(LDFLAGS)<br />else # C++ file<br /> $(CXX) -o $(PROGRAM) $(OBJS) $(LDFLAGS)<br />endif<br />-include $(DEPS)<br />rebuild: clean all<br />clean :<br /> @$(RM) *.o *.d<br />cleanall: clean<br /> @$(RM) $(PROGRAM) $(PROGRAM).exe<br />### End of the Makefile ## Suggestions are welcome ## All rights reserved ###<br />############################################################################### 下面提供兩個例子來具體說明上面 Makefile 的用法。 例一　Hello World 程式 這個程式的功能是輸出 Hello, world! 這樣一行文字。由 hello.h、hello.c、main.cxx 三個檔案組成。前兩個檔案是 C 程式，後一個是 C++ 程式，因此這是一個 C 和 C++ 混編程式。/* File name: hello.h<br /> * C header file<br /> */<br />#ifndef HELLO_H<br />#define HELLO_H<br />#ifdef __cplusplus<br />extern "C" {<br />#endif<br /> void print_hello();<br />#ifdef __cplusplus<br />}<br />#endif<br />#endif /* File name: hello.c<br /> * C source file.<br /> */<br />#include "hello.h"<br />#include <stdio.h><br />void print_hello()<br />{<br /> puts( "Hello, world!" );<br />} /* File name: main.cxx<br /> * C++ source file.<br /> */<br />#include "hello.h"<br />int main()<br />{<br /> print_hello();<br /> return 0;<br />} 建立一個新的目錄，然後把這三個檔案拷貝到目錄中，也把 Makefile 檔案拷貝到目錄中。之後，對 Makefile 的相關項目進行如下設定：PROGRAM := hello # 設定運行程式名<br />SRCDIRS := . # 來源程式位於目前的目錄下<br />SRCEXTS := .c .cxx # 來源程式檔案有 .c 和 .cxx 兩種類型<br />CFLAGS := -g # 為 C 目標程式包含 GDB 可用的調試資訊<br />CXXFLAGS := -g # 為 C++ 目標程式包含 GDB 可用的調試資訊 由於這個簡單的程式只使用了 C 標準庫的函數（puts），所以對於 CFLAGS 和 CXXFLAGS 沒有過多的要求，LDFLAGS 和 CPPFLAGS 選項也無需設定。 經過上面的設定之後，執行 make 命令就可以編譯器了。如果沒有錯誤出現的話，./hello  就可以運行程式了。 如果修改了來源程式的話，可以看到只有和修改有關的源檔案被編譯。也可以再為程式添加新的源檔案，只要它們的副檔名是已經在 Makefile 中設定過的，那麼就沒有必要修改　Makefile。 例二　GTK+ 版 Hello World 程式 這個 GTK+ 2.0 版的 Hello World 程式可以從下面的網址上得到：http://www.gtk.org/tutorial/c58.html#SEC-HELLOWORLD。當然，要編譯 GTK+ 程式，還需要你的系統上已經安裝好了 GTK+。 跟第一個例子一樣，單獨建立一個新的目錄，把上面網頁中提供的程式儲存為 main.c 檔案。對 Makefile 做如下設定：PROGRAM := hello # 設定運行程式名<br />SRCDIRS := . # 來源程式位於目前的目錄下<br />SRCEXTS := .c # 來源程式檔案只有 .c 一種類型<br />CFLAGS := `pkg-config --cflags gtk+-2.0` # CFLAGS<br />LDFLAGS := `pkg-config --libs gtk+-2.0` # LDFLAGS 這是一個 C 程式，所以 CXXFLAGS 沒有必要設定——即使被設定了也不會被使用。 編譯和串連 GTK+ 庫所需要的 CFLAGS 和 LDFLAGS 由 pkg-config 程式自動產生。 現在就可以運行 make 命令編譯、./hello 執行這個 GTK+ 程式了。 參考資料： Multi-file projects and the GNU Make utility Author: George Foot http://www.elitecoders.de/mags/cscene/CS2/CS2-10.html GNU Make Manual http://www.gnu.org/software/make/manual/