当前位置:首页 > 网站旧栏目 > 学习园地 > 设计软件教程 > Build编译工具学习笔记:常用命令参数和BRF文件

Build编译工具学习笔记:常用命令参数和BRF文件
2010-01-13 22:51:53  作者:  来源:
build工具的主页在:http://www.dsource.org/projects/build
它以前叫 bud,所以这里混用 bud 和build,都指的同一个东西

build是D语言的编译工具,相当于C的make命令。
但它更简单且好用,因为它能处理 import 语句,自动载入依赖的文件。
看过本文后,基本上可以使用了。
如果你想用它的高级功能,当然还得花时间去研究它。

build 会涉及的文件有:
  brf文件 (Build Response File) -- bud命令的参数文件
  源文件的 Pragmas 指令
  rdf文件 (Rule Definition File) -- 规则定义文件
  mdf文件 (Macro Definition File) -- 宏定义文件
  cfg文件 (Configuration File) -- 配置文件
  pfl文件 (Profile File) -- 配置文件?

其中,brf文件里面写的就是一些build命令的参数,所以,先从参数开始。

先看几个简单参数,然后再说说brf文件,最后把其他参数简单的列一下。
[注:以下在Linux和dmd下测试过,没有测试win和gdc]

build命令的格式是:

Java代码 复制代码
  1. build <sourcefile> [<switches> ] [<otherfiles> ]   
  2. sourcefile   一般是包括main函数的源文件   
  3. switches     上面列出的参数   
  4. otherfiles   链接库,object文件,宏定义文件等等其他文件(猜的:))  

参数和源文件都没有顺序,可以任意排列 -- 喜欢把源文件放前面,编译参数放后面,因为编译参数经常改

Bud的常用参数之一:常规选项
Java代码 复制代码
  1. -exec           编译成功后,运行它   
  2. -cleanup        在编译完成后,把生成的中间文件删除掉,比如 .o 文件   
  3. -full           编译所有的文件,即使没有修改也要编译一遍   
  4. -T<name>          指定目标的文件名   
  5. -od<path>         指定.o 等临时文件的输出目录   
  6.   
  7. -silent         安静模式,不输出多余信息   
  8. -test           只是显示要调用的命令,不实际编译   
  9. -v              build 和 dmd 都是调试模式   
  10. -V              build 是调试模式,但dmd命令不是   
  11. -info           显示build命令的版本号等信息   
  12. -names          显示要编译的文件名   
  13. -uses[=fname]   输出交叉引用文件              



如果不是bud的参数,会传递给dmd。比如可以指定 -op -L-l 参数 [注:猜的,不肯定]


命令参数如果是一个横线(-),表示启用,如果是两个横线(--),表明禁用。
比如: bud --cleanup -full
两个横线(--)一般和brf文件配合使用,表明要禁用brf文件中的某个编译参数

给个例子:a.d 和 b.d
Java代码 复制代码
  1. module a;   
  2.   
  3. import b;   
  4. import std.stdio;   
  5.   
  6. void main(char[][] arg)   
  7. {   
  8.     writef("in Module A: ");   
  9.     writefln(arg);   
  10.     print_b();   
  11. }  

Java代码 复制代码
  1. module b;   
  2.   
  3. import std.stdio;   
  4.   
  5. void print_b()   
  6. {   
  7.     writefln("in Module B: b.d");   
  8. }  


最简单的编译方法:
Java代码 复制代码
  1. bud a.d   
  2. bud a                   # 可以不写 .d 后缀  

注意,这里不需要指定 b.d,因为a.d中的import起了作用。
bud命令会自动处理。是不是很简单?

编译后让它运行:
Java代码 复制代码
  1. bud a.d -exec   
  2. bud a.d -execXXX        # 给个参数XXX   
  3. bud a.d -exec"XXX YYY"  # 给2个参数XXX YYY  ; 在bash下不能正确运行,不知道怎么处理  


改个名字:
Java代码 复制代码
  1. bud a.d -Ta.out          # 文件名是:a.out   ;在命令行下,生成不了a.out,不知道怎么处理;(   
  2. bud a.d -Ttest_{Target}  # 文件名是:test_a  


如果你不修改a.d或者b.d,多次运行上面的命令,会提示:
Java代码 复制代码
  1. Files are up to date, no build required.  

这个和make的原理一样,如果你想每次都编译,可以这么办:
Java代码 复制代码
  1. bud a.d -full  


如果看着那么多的.o文件不爽,就把它删掉:
Java代码 复制代码
  1. bud a.d -clean      # -clean 是-cleanup的别名  


几个调试选项:
Java代码 复制代码
  1. bud a.d -names      # 显示要编译的文件名   
  2. bud a.d -test       # 显示dmd和gcc的调用命令   
  3. bud .ad -uses=x     # 生成交叉引用文件,默认文件名是a.use,这里指定为x   
  4. bud a.d -v          # 除了bud的调试信息,还显示dmd编译器的调试信息   
  5. bud a.d -V          # 只显示bud的调试信息  


use文件:
Java代码 复制代码
  1. [USES]   
  2. a.d <> /usr/local/src/phobos/std/stdio.d   
  3. a.d <> b.d    
  4. b.d <> /usr/local/src/phobos/std/stdio.d   
  5. [USEDBY]   
  6. /usr/local/src/phobos/std/stdio.d <> a.d    
  7. /usr/local/src/phobos/std/stdio.d <> b.d    
  8. b.d <> a.d  

可以看到,有2个标签:[USES] 和[USEDBY]
[USES]  的含义是 A 文件使用了哪些文件
[USEDBY] 的含义是 哪些 文件 别 A文件 使用了
每行的文件名之间用 <> 分割
升序排列

Bud的常用参数之二:编译选项
[注:对编译器的术语不是很清楚,会有些表达不清楚。回头研究一下编译术语,再来修改这段】
编译过程一般是 a.d (源文件)  -> a.o (object文件) -> a.exe (可执行文件),这里不讨论预处理等过程
object文件还可以编译成 静态链接库(liba.a) 或者 动态链接库(liba.so)

a.d 到 a.o 的过程叫编译 过程
a.o 到 a.exe 的过程叫 连接过程(link)
a.o 到 liba.a/so 的过程叫 lib过程      [注:实在不知道怎么翻译;( ]

bud 默认会把有main()或者Winmain()函数的源程序编译成可执行文件;
如果没有这两个函数,则会被编译成链接库文件(.a)
下面这些选项可以改变这些行为:
不知道怎么生成 .so的文件?

Java代码 复制代码
  1. -obj          只是创建 object文件(.o),不进行link和lib操作,等同于同时加 -nolink -nolib   
  2. -link         即使源文件中没有main()函数,也强制进行连接。   
  3.                 main()函数一般在链接库中,而不在要编译的源代码中   
  4. -nolink       针对有main()函数的源文件:不进行link操作,只生成 .o 文件   
  5. -lib          针对有main()函数的源文件:不进行link操作,只生成 .a 文件   
  6. -nolib        针对没有main()函数的源文件:不进行lib操作,只生成 .o 文件   
  7. -allobj       不懂:(   
  8.   
  9. -LIBOPT       指定要连接的参数   
  10. -LIBPATH      指定链接库的目录   
  11. -PP           指定除当前路径外的 其他源文件的搜索路径  


举例吧:

Java代码 复制代码
  1. #-obj:只生成.o 文件   
  2. bud a.d -obj         # 会同时生成 a.o b.o   
  3. bud b.d -obj         # 生成 b.o,不会生成 a.o ;)   
  4.   
  5. #-link:强制连接   
  6. bud a.d -obj         # 生成 a.o   
  7. bud b.d a.o          # 生成 b 可执行文件   
  8.   
  9. #-nolink:不链接   
  10. bud a.d -nolink      # 生成 a.o   
  11.   
  12. #-lib:生成 静态库   
  13. bud a.d -lib         # 生成 a.a 为何不是liba.a?   
  14.   
  15. #-nolib: 不生成 静态库   
  16. bud b.d -nolib       # 生成 b.o ,而不是 b.a  


LIZBOPT的作用不大清楚,把原文的定义列出来吧,偷懒了
-LIBOPT
This allows you to pass one or more command line arguments to the librarian.

Java代码 复制代码
  1. Example: Set the page size to 32Kb   
  2.     -LIBOPT-p32   
  3. Example: Embedded spaces enclosed in quotes.   
  4.     "-LIBOPT -l -i"  


-LIBPATH
This allows you to add one or more paths to be searched for library files.
This might be used when you don't want to permanently update the standard search paths.

Example:
Java代码 复制代码
  1. -LIBPATH=c:\mylibs;d:\3rdparty;c:\lib\debuglibs   
  2. BPATH=/usr/lib:/usr/local/lib:/usr/local/lib/mysql/    


-PP 举例:
把b.d 文件移动 / 目录下,用bud a.d 编译就会提示找不到b.d,ok
Java代码 复制代码
  1. bud a.d -PP/         # 提示找不到 /b.o,因为编译的b.o生成在了当前目录,而不是根目录   
  2. bud a.d -PP/ -op     # 方案1:op是dmd的编译参数,表示在源文件的路径下生成.o文件   
  3. bud a.d -PP/ -odobj  # 方案2:把.o文件都输出到 obj 目录下  


dmd命令的-L参数:指定
Java代码 复制代码
  1. -L                  指定一个连接参数,比如:   
  2.                         -L-lpthread  linux下链接libpthread.so  


brf文件使用说明

brf文件就是定义了各种bud命令参数的集合。
文件扩展名是:.brf

举例:
文件名:final.brf
Java代码 复制代码
  1. # 生成发行版本        # #符号是brf文件的注释符号   
  2. -T{Target}_release  # 应用程序的名字   
  3. -release            # Don't generate runtime checks.   
  4. -full               # 重新编译所有文件   
  5. -cleanup            # 编译完成后清除中间文件   
  6. -inline             # 进行内联优化  


运行方法:
Java代码 复制代码
  1. bud a @final        # 注意@符号   
  2. bud a @final --inline      
  3.                     # 把inline选项禁用;有警告,不知道原因;(  


可以把源文件写到 brf 文件中
每行一个编译参数,没有顺序
可以用 -- 选项,把brf文件中的参数禁用了
不可以像Makefile文件一样,定义多个编译目标。定义多个brf文件吧

bud命令的默认brf文件叫 build.brf,如果要使用默认的brf,则可以不用指定文件名:
Java代码 复制代码
  1. bud @  


多放几个例子上来,备忘:
来自:http://dlang.group.javaeye.com/group/topic/1072?page=6
Java代码 复制代码
  1. -cleanup            编译后清理掉.o文件     
  2. -L-lpthread         linux下链接libpthread.so     
  3. -LIBPATH=c:\db      设置库链接路径     
  4. libdb45.lib         直接链接windows下使用的lib文件     
  5. -op                 .o文件输出到源文件所在路径     
  6. -odobjs             把.o文件输出到objs文件夹     
  7. -T../bin/test 编译的可执行文件输出路径    

# 一个简单的make.brf 文件
Java代码 复制代码
  1. -cleanup     
  2. -op     
  3. -L-ldb     
  4. -LIBPATH=/home/lijie/dm/lib:/home/lijie/dmd/lib:/usr/local/BerkeleyDB.4.5/lib     
  5. src/test.d     
  6. -T../bin/test    


其他bud参数

如果没有给出定义,就自己看文档吧,我也不大理解 ;)
Java代码 复制代码
  1. -DCPATH             指定编译器的安装路径   
  2. -CFPATH             指定D配置文件的路径   
  3. -BCFPATH            指定Bud配置文件的路径   
  4.   
  5. -RDF<file>            指定RDF文件(Rule Definition File)的路径   
  6. -MDF<file>            指定MDF文件(Macro Definition File)的路径   
  7.   
  8. -nodef              不创建 MDF(Module Definition File)文件   
  9. -explicit           只编译指定的文件   
  10. -usefinal              
  11.   
  12. -dll                如果源文件有DllMain()函数,默认会编译成Dll库;...   
  13. -gui                如果源文件有WinMain()函数,默认会编译成GUI程序;...   
  14.   
  15. -help               显示帮助   
  16.   
  17. -AutoWinLibs(=<Yes/No>)   
  18. -modules(=<name>)   
  19. -UMB=<Yes/No>   
  20. -R<option>   
  21. -emptyargs             
  22.   
  23. -M<name>   
  24. -X<name>  


Bud的编译安装
下载源程序
make -f Makefile.unix
./build build -full -op
ln -s build bud

后记:
因为我只是用D写写测试程序, 基本上就2、3个文件,最多有个C的链接库。
我的这点小需求,bud命令还是能很好处理的。更复杂的情况,我就不了解。

文中有些错误,和不肯定的地方,等我弄明白了再来修正吧。

安徽新华电脑学校专业职业规划师为你提供更多帮助【在线咨询