Reference from https://www.gnu.org/software/make/manual/html_node/Functions.html

• Syntax of Functions:		How to write a function call.
• Text Functions:		General-purpose text manipulation functions.
• File Name Functions:		Functions for manipulating file names.
• Conditional Functions:		Functions that implement conditions.
• Foreach Function:		Repeat some text with controlled variation.
• File Function:		Write text to a file.
• Call Function:		Expand a user-defined function.
• Value Function:		Return the un-expanded value of a variable.
• Eval Function:		Evaluate the arguments as makefile syntax.
• Origin Function:		Find where a variable got its value.
• Flavor Function:		Find out the flavor of a variable.
• Make Control Functions:		Functions that control how make runs.
• Shell Function:		Substitute the output of a shell command.
• Guile Function:		Use GNU Guile embedded scripting language.

Khi build một ứng dụng nào đó thì thường sẽ cần nhiều thư viện đi cùng, việc build từng lib đơn lẻ tỏ ra rất bất tiện khi ta cần build rất nhiều lib cùng một lúc, khi đó ta cần một script nào đó chỉ cần gõ một lệnh để build toàn bộ hệ thống.

Sau đây là một template đơn giản để ví dụ cho việc đó.

Link: https://github.com/eslinux/Utils/tree/master/build-app-template

Template for build app from list of library

#using command
make.sh build
make.sh clean component_name
make.sh cleanall


extpkgs       -> lib that no need to download
info          -> flag to mask the lib that was downloaded/uncompressed/builded
install       -> app install dir
patches       -> patch file for lib
script        -> compile script of lib
srcdir        -> download && extract to this folder
tools         -> utility script
make.sh       -> main build script
Makefile      -> no using
Readme.txt

Info Flag:
- .buildflag  -> lib was builded
- .unflag     -> lib package was uncompress
- .dlflag     -> lib package was downloaded

Before build you need to check some parameter in toos/Config file:
- ROOTFS_DIR
- TOOLCHAIN_DIR
- CROSS
- TOOLCHAIN_FILE (arm-toolchain.cmake)
- PREFIX (default is install folder)
- URL_SOURCE_DL


Add library build script in make.sh
- BASE_APPLIST

Current example that build for 2 lib that is: opencv and zlib

Bài viết liên quan:
+ Makefile (Part 1)

3. Khuôn dạng đầy đủ của Makefile
sum.h (giữ nguyên)
sum.c (giữ nguyên)
main.c (thêm #ifdef ... #endif)

 #include <stdio.h>  
 #include "sum.h"  
   
 int main(int argc, char **argv){  
        
      int x;  
      x= sum(1, 2);  
        
 #ifdef DEBUG  
      printf("x = %d \n", x);  
 #endif  
   
      return 1;  
 }  
   

Makefile

 .PHONY: all, install, clean  
   
 TARGET=sum  
   
 HDRS+= sum.h  
 CSRCS+= main.c sum.c  
 CPPSRCS+=  
   
 OBJSDIR=./build  
 OBJS:= $(patsubst %.cpp, $(OBJSDIR)/%.o, $(CPPSRCS))  
 OBJS+= $(patsubst %.c, $(OBJSDIR)/%.o, $(CSRCS))  
   
 CFLAGS += -I./include -DDEBUG -Wall -g  
 LDFLAGS += -L./lib -lm  
   
 CC:= gcc  
 CXX:= g++  
   
 all: ${TARGET}  
 ${TARGET} : $(OBJS)  
      @echo " [LINK] $@"  
      @mkdir -p $(shell dirname $@)  
      @$(CXX) $(OBJS) -o $@ $(LDFLAGS)  
        
 $(OBJSDIR)/%.o: %.c $(HDRS)  
      @echo " [CC]  $@"  
      @mkdir -p $(shell dirname $@)  
      @$(CC) -c $< -o $@ $(CFLAGS)  
   
 $(OBJSDIR)/%.o: %.cpp $(HDRS)  
      @echo " [CXX] $@"  
      @mkdir -p $(shell dirname $@)  
      @$(CXX) -c $< -o $@ $(CFLAGS)  

 install:
      cp -rf ${TARGET} /usr/local/bin   
    
 clean:  
      rm -rf ${OBJSDIR}/*.o  
      rm -rf ${TARGET}  
   

Giải thích:
3.1 all, install, clean, .PHONY 
+ all
Là target mặc định, khi bạn thực hiện lệnh make thì chương trình make sẽ tiến hành compile để tạo ra chương trình cuối cùng tương ứng với target này, trong ví dụ này là ${TARGET} tương ứng với sum; hai lệnh dưới đây là tương đương

 make  
 make all   

+ install, clean
Các target do người dùng tự định nghĩa, tương ứng với các câu lệnh:

 make install  #thực hiện action cp
 make clean    #thực hiện action rm 

+ .PHONY target
Target này có tác dụng chống xung đột cho chương trình make trong trường hợp trong thư mục source code có một file source nào đó trùng tên với các target trong Makefile, ví dụ all.c, install.c hay clean.c. Tốt nhất trong Makefile luôn dùng từ khóa này.

3.2 Phép gán: TARGET, CC, CXX, ...
Các từ in hoa như trên biểu diễn cho phép gán, có thể hiểu nó tương tự như #define trong C, nó giúp cho chương trình sáng sủa, dễ hiểu và rút ngắn Makefile đáng kể. Phép gán được thực hiện bằng các cách sau:
+ "=" gán cố định
+ ":=" tương tự như "="
+ "+=" phép gán nối dài (append), ví dụ khi viết hai dòng

 CSRCS+= main.c  
 CSRCS+= sum.c   
 => CSRCS = main.c sum.c   

Để lấy giá trị của phép gán thì dùng các cách sau:

 ${TARGET}   
 hoặc  
 $(CFLAGS)  

+ HDRS / CSRCS /CPPSRCS
Header , C source, C++ source file. Trong vd trên các file đều nằm trong folder gốc, nếu file nào nằm ở các thư mục con, bạn cũng cần chỉ đúng đường dẫn đễn file, vd:

  HDRS+= ./src/sum.h   
  CSRCS+= main.c \
          ./src/sum.c   
  CPPSRCS+=  

"\" là ký tự xuống dòng.

+ OBJSDIR / OBJS
Thư mục chứa các object / các object

+ CFLAGS / LDFLASG
Các flags chứa các options để pass vào cho compiler, xem lại tại đây (mục 7).
Chú ý -DDEBUG tương ứng với define DEBUG để pass vào source code, ví dụ trong main.c ở trên.

+ CC / CXX
Compiler để compile, trong vd này sử dụng gcc/g++ để chạy trên máy tính chứ không phải board nhúng, khi cross compiler thì bạn chỉ cần đặt đúng compiler tương ứng với platform cho board là được, vd:

 CC=arm-linux-gcc  
 CXX=arm-linux-g++  

3.3 Lệnh Shell
Lệnh Shell được đưa vào trong cặp khóa $( ) như dưới đây:

 OBJS:= $(patsubst %.cpp, $(OBJSDIR)/%.o, $(CPPSRCS))   
 mkdir -p $(shell dirname $@)   

3.4 Makefile tương đương: $<, $@, $*, $?, ...

Macro	Definition
$<	Source code hiện tại để compile, tương ứng với %.c và %.cpp, ví dụ: main.c, sum.c
$@	Target hiện tại tương ứng với $(OBJSDIR)/%.o, ví dụ: main.o, sum.o
$*	Tương tự $< nhưng không có suffix, ví dụ: main, sum
$?	Danh sách dependency tương ứng với %.c $(HDRS), ví dụ: tương ứng với main.o là main.c và sum.h

Được sử dụng trong đoạn Makefile chính:

 ${TARGET} : $(OBJS)   
    @echo " [LINK] $@"   
    @mkdir -p $(shell dirname $@)   
    @$(CXX) $(OBJS) -o $@ $(LDFLAGS)   
       
  $(OBJSDIR)/%.o: %.c $(HDRS)   
    @echo " [CC] $@"   
    @mkdir -p $(shell dirname $@)   
    @$(CC) -c $< -o $@ $(CFLAGS)   
     
  $(OBJSDIR)/%.o: %.cpp $(HDRS)   
    @echo " [CXX] $@"   
    @mkdir -p $(shell dirname $@)   
    @$(CXX) -c $< -o $@ $(CFLAGS)  

Bạn đọc có thể trace các macro bằng các dòng lệnh sau:

 @echo " [CC]  $@ $< $* $?"  
 @echo " [CXX]  $@ $< $* $?"  

Nguyên lý hoạt động:
Chỉ cần đoạn lệnh ngắn gọn trên là đủ để để compile tất cả các target được liệt kê trong OBJS thông qua ký tự đại diện "%"; compile main.o từ main.c, compile sum.o từ sum.c, tất nhiên có các dependency HDRS

3.5 Các ký tự khác
+ @ ở đầu các Action trong Makefile
Loại bỏ các dòng trace mặc định của chương trình make khi đang compile
+ -f
Nếu bạn đặt tên của script không phải mặc định là Makefile (ví dụ: MyMakefile) thì bạn cần thêm option -f vào

 make -f MyMakefile  
 make -f MyMakefile install  
 make -f MyMakefile clean  
 ...  
   

4. Tạo Makefile theo kiểu module cho project lớn
Nếu project lớn có nhiều subfolder thì bạn nên chia thành nhiều phần cho dễ quản lý, cũng theo vd trên nhưng bây giờ giả sử sum.h và sum.c ở trong một subfolder gọi là src


Trong trường hợp này bạn thêm một makefile phụ là src.mk đặt trong thư mục src

src.mk

 CSRCS+= ./src/sum.c  
   
 CPPSRCS+=   
    
 HDRS+= $(wildcard ./src/*.h)  

Makefile

 .PHONY: all, install, clean  
   
 TARGET:=sum  
   
 -include ./src/src.mk  
 CSRCS+= main.c  
   
 OBJSDIR=./build  
 OBJS:= $(patsubst %.cpp, $(OBJSDIR)/%.o, $(CPPSRCS))  
 OBJS+= $(patsubst %.c, $(OBJSDIR)/%.o, $(CSRCS))  
   
 INCDIR+= -I./src  
 CFLAGS += -DDEBUG -Wall -g  
 LDFLAGS += -L./lib -lm  
   
   
   
 CC:= gcc  
 CXX:= g++  
   
 all: ${TARGET}  
 ${TARGET} : $(OBJS)  
      @echo " [LINK] $@"  
      @mkdir -p $(shell dirname $@)  
      @$(CXX) $(OBJS) -o $@ $(LDFLAGS)  
        
 $(OBJSDIR)/%.o: %.c $(HDRS)  
      @echo " [CC]  $@"  
      @mkdir -p $(shell dirname $@)  
      @$(CC) -c $< -o $@ $(CFLAGS) ${INCDIR}  
   
 $(OBJSDIR)/%.o: %.cpp $(HDRS)  
      @echo " [CXX] $@"  
      @mkdir -p $(shell dirname $@)  
      @$(CXX) -c $< -o $@ $(CFLAGS) ${INCDIR}  
   
 install:  
      cp -rf ${TARGET} /usr/local/bin  
             
 clean:  
      rm -rf ${OBJSDIR}  
      rm -rf ${TARGET}  

Bài viết liên quan
+ Cross compiler

1. Đặt vấn đề 
Những vấn đề khi biên dịch
+ Một chương trình đơn giản => chỉ có một vài file
+ Một chương trình “không đơn giản”
     - Nhiều dòng lệnh
     - Nhiều module
     - Nhiều người tham gia viết

Vấn đề xảy ra:
+ Khó quản lý một file lớn (cả người và máy)
+ Mỗi thay đổi cần thời gian biên dịch lâu
+ Nhiều người lập trình không thể thay đổi cùng một file đồng thời
+ Chương trình được phân ra thành nhiều module

Giải pháp: chia project ra thành nhiều file
Mục tiêu:
+ Chia thành các module một cách đúng đắn
+ Thời gian biên dịch ngắn nếu có sự thay đổi
+ Dễ dàng bảo trì cấu trúc project và sự phụ thuộc

2. Makefile
2.1 Makefile là gì?
+ Makefile là một file dạng script chứa các thông tin:
    - Cấu trúc project (file, sự phụ thuộc)
    - Các lệnh để tạo file
+ Lệnh make sẽ đọc nội dung Makefile, hiểu kiến trúc của project và thực thi các lệnh


2.2 Cấu trúc project
+ Cấu trúc và sự phụ thuộc của project có thể được biểu diễn bằng một DAG (Directed Acyclic Graph)
+ Thí dụ:
    - Chương trình chứa 3 file: main.c, sum.c, sum.h
    - File sum.h được dùng bởi cả 2 file main.c và sum.c
    - File thực thi là sum

 #ifndef SUM_H_  
 #define SUM_H_  
 #include <stdio.h>  
 int sum(int a, int b);  
 #endif /* SUM_H_ */  

 #include "sum.h"  
   
 int sum(int a, int b){  
      return (a+b);  
 }  

 #include <stdio.h>  
 #include "sum.h"  
   
 int main(int argc, char **argv){  
        
      int x;  
      x= sum(1, 2);  
      printf("x = %d \n", x);  
        
      return 1;  
 }  

 sum: main.o sum.o  
   gcc -o sum main.o sum.o  
 main.o: main.c sum.h  
   gcc -c main.c  
 sum.o: sum.c sum.h  
   gcc -c sum.c  

 [ninhld@localhost ~]$   
 [ninhld@localhost ~]$ cd /home/ninhld/Github/eslinuxprogramming/Makefile  
 [ninhld@localhost Makefile]$   
 [ninhld@localhost Makefile]$ make  
 gcc -c main.c  
 gcc -c sum.c  
 gcc -o sum main.o sum.o  
 [ninhld@localhost Makefile]$   
 [ninhld@localhost Makefile]$   
 [ninhld@localhost Makefile]$ ./sum   
 x = 3   
 [ninhld@localhost Makefile]$   
 [ninhld@localhost Makefile]$   

 [ninhld@localhost Makefile]$ make  
 gcc -c main.c  
 gcc -c sum.c  
 gcc -o sum main.o sum.o  
   

 [ninhld@localhost Makefile]$ make  
 gcc -c sum.c  
 gcc -o sum main.o sum.o  

 sum: main.c sum.c sum.h  
      ${CC} -o sum main.c sum.c sum.h