python3实现版本
Preface
GNU Make 太麻烦?Makefile 写起来太臃肿?头文件依赖生成搞不定?多核同时编译太麻烦?Emake 帮你解决这些问题:
使用简单:设定源文件,设定编译参数和输出目标就行了,emake为你打点好一切。
依赖分析:快速分析源代码所依赖的头文件,决定是否需要重新编译。
输出模式:可执行、静态库(.a)、动态库(.so/.dll)。
多核编译:轻松实现并行编译,加速项目构建。
精简紧凑:只有唯一的一个 emake.py 文件。
交叉编译:构建 iOS 项目 ,安卓项目,等等。
语言支持 C / C++ / ObjC / ObjC++ / ASM
工具支持 gcc / mingw / clang
运行系统 Windows / Linux / Mac OS X / FreeBSD
方便的交叉编译,轻松构建 Android NDK / iOS / asm.js 项目
你见过最简单的构建系统,比 Gnu Make / CMake 都简单很多
只有两三个源代码,那 makefile 随便写,文件一多,搞依赖都可以搞死人。emake 就是简单中的简单,不但比 GNU Make 简单,还要比 cmake 简单很多。
Emake 是为快速开发而生的,最初版本在 2009年发布,多年间团队在不同操作系统下用它构建过:服务端项目、客户端项目、iOS项目、安卓项目 和 Flash项目,这些项目都稳健的跑在生产环境中,为海量用户提供服务。
多年的开发中,emake 提高了各种大小项目的开发效率,自身也随着时间增加不断被完善和稳定。
Install
Linux / Mac OS X:
wget http://skywind3000.github.io/emake/emake.py
sudo python2 emake.py -i
运行上面两条指令,十秒内完成安装。emake 会拷贝自己到 /usr/local/bin 下面,后面直接使用 emake 指令操作。
Windows:
下载 emake.py,放到你的 mingw 根目录下(便于 emake 定位 gcc),并且添加到 PATH 环境变量,同级目录新建立一个 emake.cmd 文件,内容如下:
@echo off
d:\dev\python27\python.exe d:\dev\mingw\emake.py %*
修改一下对应路径即可,建立这个 emake.cmd 的批处理文件是为了方便每次敲 emake 就可以工作,避免敲 "python emake.py" 一长串。
Tutorial
假设你有三个文件:foo.c, bar.c, main.c 共同编译成名字为 main(.exe) 的可执行文件,我们创建 “main.mak” 文件:
; 指明目标格式:exe, lib, dll 三选一
mode: exe
; 加入源文件
src: foo.c
src: bar.c
src: main.c
是不是比 makefile, cmake 之类的步骤简单多了?编译项目:
emake main.mak
好了,工程顺利编译成功,每次任何一个文件发生变动,相关对其依赖的源文件都会重新编译,而无依赖的代码则不需要再次编译。
增加编译选项
如果需要增加编译选项的话:
; 指明目标格式:exe, lib, dll 三选一
mode: exe
; 编译选项
flag: -Wall, -O3, -g
; 加入源文件
src: foo.c
src: bar.c
src: main.c
如果项目中使用了数学库 libm.a的话:
link: m
如果还是用了 libstdc++.a 的话:
link: m, stdc++
或者:
link: m
link: stdc++
link 可以直接写 .a 库的文件名:
link: ./lib/libmylib.a
如果需要添加额外的 include 目录 和 lib 目录的话:
inc: /usr/local/opt/jdk/include
lib: /usr/local/opt/jdk/lib
还可以手动指定输出的文件名:
out: main
手动指定临时文件夹,避免临时 .o 文件污染当前目录的话:
int: objs
这样所有的临时文件就会跑到 objs 目录下面了,想要清理的话,删除 objs目录即可。
完整例子
; 指明目标格式:exe, lib, dll 三选一
mode: exe
; 编译选项
flag: -Wall, -O3, -g
; 设定链接
link: m, pthread, stdc++
; 额外头文件路径
inc: /usr/local/opt/jdk/include
inc: /usr/local/opt/jdk/include/linux
; 额外库文件路径
lib: /usr/local/opt/jdk/lib
; 加入源文件
src: foo.c
src: bar.c
src: main.c
Document
emake 的工程文件里面支持下面几种设置:
src
用于声明项目里面的源文件,格式:
src: file1
src: file2
...
src: filen
或者:
src: file1, file2, file3
src: file4, file5, file6
inc
声明项目中的 include 文件夹,相当于 gcc 的 -I 命令:
inc: dir1
inc: dir2
或者:
inc: dir1, dir2
和 src 一样可以使用逗号分隔。
lib
设置库文件目录,格式同上
link
添加需要链接的库,相当于 gcc 的 -l 指令:
link: m, pthread, stdc++
或者:
link: m
link: pthread
link: stdc++
同时支持单行和多行模式,编译 C++ 项目别忘记链接 stdc++。
mode
目标文件的输出格式:
mode: [exe|lib|dll|win]
exe: 生成可执行文件
lib: 生成静态链接库
dll: 生成动态链接库
win: windows下特有,生成无 console窗口的 windows程序。
out
指定目标文件的文件名:
out: target_file_name
int
指定中间临时文件目录,一般设置为:
int: objs
或者:
int: objs/$(target)
flag
指定编译参数,会被直接传递给 gcc.
flag: -Wall, -g, -pg
诸如此类
Settings
Emake 可以指定一个 ini 文件来进行配置:
原来是:
emake
手动指定配置文件名:
emake --ini=xxx.ini
如果不指明的话,会首先在当前文件夹寻找 emake.ini 文件,同时 Linux 下面的话,还会相继在下面三个位置:
/etc/emake.ini
/usr/local/etc/emake.ini
~/.config/emake.ini
进行寻找。该配置文件确定了一些编译的默认配置,在该配置文件中,可以:
更改默认编译器的可执行文件名
更改默认连接器的可执行文件名
设定编译条件
设定默认编译的参数:include / lib 等文件夹等
设定编译器启动的一些环境变量
设定多核编译时的 cpu 数量。
预先设定一些 section,工程文件可以 import 特定的 section。
由上面这些设定,emake 可以灵活的调用各种工具链,方便的进行项目构建和交叉编译。比如我在 Windows 下面的 emake.ini 部分内容:
[default]
flag=-Wall, -I$(inihome)/../mylibs
link=stdc++, winmm, wsock32, opengl32, gdi32, glu32, ws2_32, user32
include=d:/dev/local/include
lib=d:/dev/local/lib
cpu=6
[ffmpeg]
include=d:/dev/local/opt/ffmpeg/include
lib=d:/dev/local/opt/ffmpeg/lib
link=avcodec, avdevice, avfilter, avformat, avutil, postproc, swscale
[qt]
include=D:/Dev/Qt/sdk/4.8.3-mingw/include;D:/Dev/Qt/sdk/4.8.3-mingw/include/QtGui
lib=D:/Dev/Qt/sdk/4.8.3-mingw/lib
link=stdc++, ole32, gdi32, wsock32, opengl32, gdi32, glu32, ws2_32, uuid, oleaut32, winmm, imm32, winspool, QtCore4, QtGui4, QtGuid4
[qt45]
include=D:/Dev/Qt/4.5.0-mingw-static/include;D:/Dev/Qt/4.5.0-mingw-static/include/QtGui
lib=D:/Dev/Qt/4.5.0-mingw-static/lib
link=stdc++, ole32, gdi32, wsock32, opengl32, gdi32, glu32, ws2_32, uuid, oleaut32, winmm, imm32, winspool, QtCore, QtGui
默认区(default)作用于每一个工程文件,其中 cpu字段只能出现在默认区,它规定了编译时最多使用多少个核进行编译,其他区的话,需要在工程里使用 import 来导入:
import: qt, ffmpeg
那么在你的工程里,上面 qt 和 ffmpeg 的相关配置就会被导入了。
Cross Compilation
交叉编译的话,需要单独一个 ini文件来规定工具链,比如我的 android交叉编译配置:
[default]
flag=-Wall
home=bin
gcc=arm-linux-androideabi-gcc
ar=arm-linux-androideabi-ar
as=arm-linux-androideabi-as
name=android,posix,arm
cpu=4
其中 home 规定了 ndk工具链 gcc环境所在的可执行路径,后面同时定义了:gcc, ar, as 三个必须的可执行文件名,使用的时候:
emake --ini=d://android-toolchain/android-9/emake.ini xxx
在 default 区中定义了很多 name ,这些 name 可以用来做工程文件的条件判断,比如:
android/flag: -mfloat-abi=softfp
posix/link: pthread
win32/link: winmm, wsock32, ws2_32
不同的 ini 文件中定义的 name 不同,在工程文件中会判断是否定义过某个 name ,定义过的话,执行后面的话,如此在同一个工程文件中,可以针对不同平台定义源文件,设置编译参数。
Rapid Development
不管时 GNU Make 还是 cmake,亦或时其他构建系统,都需要你写一个专门的工程文件来描述该工程。对于大项目很正常,但是对于中小项目,特别时一些测试类项目,这真的太麻烦了。
Emake 可以不用工程文件,而将工程配置信息嵌入到源代码的注释中:
#include
#include
#include "foobar.h"
//! mode: exe
//! src: foo.cpp, bar.cpp, utils.cpp
int main(void)
{
printf("Hello, World !!\n");
foo();
bar();
return 0;
}
这样在你的源文件里面增添两行以后,即可使用:
emake main.cpp
来进行编译,emake 会自动提取 //! 开头的注释,解析为 emake的项目描述信息,上面的配置描述了该项目依赖的文件(除了 main.cpp自己外),以及项目模式为生成可执行文件。
这样写起来,比所有构建系统都简单很多。
Credits
本项目旧地址: