SCons笔记

1. 基本使用
SConstruct文件就功能而言相当于Makefile文件，就内容而言则是Python脚本，scons读入它时，会把脚本的命令都执行一遍，但具体编译过程则有scons自己相机而定。
Program('hello.c')
Program('new_hello','hello_c') 前为目标，后为源文件
Program(['prog.c','file1.c','file2.c']) 多个源文件
Program(‘program'，['prog.c','file1.c','file2.c']) 指定目标文件，多个源文件
Program('program‘，Glob('*.c'))
Program('program',Split('main.c file.c file2.c')) 多个原文件更清晰的写法
src_files=Split("""main.c
file1.c
file2.c""")
Program(target='program',source=src_files)

2. 编译多个目标文件就多次调用Program()

3.8 多个程序共享源文件
eg.1
Program(Split('foo.c common1.c common2.c'))
Program('bar', Split('bar1.c bar2.c common1.c common2.c'))
eg.2
common = ['common1.c', 'common2.c']
foo_files = ['foo.c'] + common
bar_files = ['bar1.c', 'bar2.c'] + common
Program('foo', foo_files)
Program('bar', bar_files)

4. 库编译和链接
4.1 库编译
Library('foo', ['f1.c', 'f2.c', 'f3.c'])
4.1.1 你甚至可以在文件List里混用源文件和.o文件
Library('foo', ['f1.c', 'f2.o', 'f3.c', 'f4.o'])
4.1.2 显式编译静态库
StaticLibrary('foo', ['f1.c', 'f2.c', 'f3.c'])
4.1.3 编译动态库
SharedLibrary('foo', ['f1.c', 'f2.c', 'f3.c'])
4.2 库链接
Library('foo', ['f1.c', 'f2.c', 'f3.c'])
Program('prog.c', LIBS=['foo', 'bar'], LIBPATH='.')
不用指明库的前缀和后缀，如lib,.a等。
4.3 找到库：$LIBPATH变量
Program('prog.c', LIBS = 'm',
LIBPATH = ['/usr/lib', '/usr/local/lib'])
Unix上 LIBPATH = '/usr/lib:/usr/local/lib'
Windows上 LIBPATH = 'C:\\lib;D:\\lib'

5. 节点对象（nodes）
SCons把所有知道的文件和目录表示为节点。
5.1 builder方法的返回值都是节点对象List,这一点很重要，在python中List+List还是List，下面可以看到应用。
hello_list = Object('hello.c', CCFLAGS='-DHELLO')
goodbye_list = Object('goodbye.c', CCFLAGS='-DGOODBYE')
Program(hello_list + goodbye_list)
这里如果不使用变量的话，就不能跨平台使用了，因为不同系统object扩展名是不同的

5.2 显示创建文件和目录节点
hello_c = File('hello.c')
Program(hello_c)
classes = Dir('classes')
Java(classes, 'src')
一般，你不用显式调用他们，因为builder方法会自动处理文件名字符串并转换为节点的。
当你不知道目标是文件还是目录时：
xyzzy = Entry('xyzzy')

5.3 打印节点文件名
hello_c = File('hello.c')
Program(hello_c)

classes = Dir('classes')
Java(classes, 'src')

object_list = Object('hello.c')
program_list = Program(object_list)
print "The object file is:", object_list[0]
print "The program file is:", program_list[0]
5.4 把节点文件名当作字符串来使用
imp
ort os.path
program_list = Program('hello.c')
program_name = str(program_list[0])
if not os.path.exists(program_name):
print program_name, "does not exist!"
此例判断了文件是否存在


6. 依赖关系
6.1
Decider函数，确定文件是否被修改
6.1.1 默认使用MD5检查源文件内容而不是时间戳，用touch不算修改过
显示调用
Program('hello.c')
Decider('MD5')
6.1.2 使用时间戳
Program('hello.c')
Decider('timestamp-newer')
与下面语句等价
Program('hello.c')
Decider('make')
更详细的检查
Program('hello.c')
Decider('timestamp-match')
6.1.3 两者同时使用
Program('hello.c')
Decider('MD5-timestamp')
6.3 $CPPPATH 隐含依赖关系
Program('hello.c', CPPPATH = ['include', '/home/project/inc'])
会在编译时加 -I

6.4 缓冲隐式依赖关系
% scons -Q --implicit-cache hello 运行选项
SetOption('implicit_cache', 1) 写在脚本里
这样下次就不用从头开始找依赖关系了
% scons -Q --implicit-deps-changed hello
再打开

6.5 显式依赖关系： Depends函数
当Scons没有找到关系时
hello = Program('hello.c')
Depends(hello, 'other_file')
6.9 总是编译
hello = Program('hello.c')
AlwaysBuild(hello)

7. 环境
7.2 创建环境
7.2.1
imp ort os

env = Environment(CC = 'gcc',
CCFLAGS = '-O2')

env.Program('foo.c')
% scons -Q
7.2.2 获取环境变量
env = Environment()
print "CC is:", env['CC']
% scons -Q
CC is: cc
scons: `.' is up to date.
env = Environment(FOO = 'foo', BAR = 'bar')
dict = env.Dictionary()
for key in ['OBJSUFFIX', 'LIBSUFFIX', 'PROGSUFFIX']:
print "key = %s, value = %s" % (key, dict[key])


This SConstruct file will print the specified dictionary items for us on POSIX systems as follows:

% scons -Q
key = OBJSUFFIX, value = .o
key = LIBSUFFIX, value = .a
key = PROGSUFFIX, value =
scons: `.' is up to date.
13. Install安装文件至其他文件夹
env = Environment()
hello = env.Program('hello.c')
env.Install('/usr/bin', hello)
13.1 在目录里安装多个文件
env = Environment()
hello = env.Program('hello.c')
goodbye = env.Program('goodbye.c')
env.Install('/usr/bin', [hello, goodbye])
env.Alias('install', '/usr/bin')
13.2 一个文件不同存放
env = Environment()
hello = env.Program('hello.c')
env.InstallAs('/usr/bin/hello-new', hello)
env.Alias('install', '/usr/bin')

% scons -Q install
cc -o hello.o -c hello.c
cc -o hello hello.o
Install file: "hello" as "/usr/bin/hello-new"

14 平台独立的文件系统操作
14.1 复制
Command("file.out", "file.in", Copy("$TARGET", "$SOURCE"))
或者
Command("file.out", [], Copy("$TARGET", "file.in"))

16. 多层目录构建
Sconconstruct在最顶层
16.1 SConscript文件可以层层包含
SConscript(['drivers/SConscript',
'parser/SConscript',
'utilities/SConscript'])
在drivers下：
SConscript(['display/SConscript',
'mouse/SConscript'])
16.2 对文件SConscript的相对目录
SConscript(['prog1/SConscript',
'prog2/SConscript'])