scons简单使用

介绍，scons用的是python语法。需要安装python和scons后才能运行，能够跨平台。比较automake自动生成makefile文件，scons可以认为直接是make的功能，因为只需要执行scons命令就等于执行了make的功能。

现在有一个hello.c的文件。

新建一个SConstruct文件，是一个python脚本文件。

Program('hello.c') 编译hello.c并生成.o文件和可执行文件

Object('hello.c') 编译hello.c但只生成生成.o文件

这两个方法都是python的method。

如果想执行clean操作，我们不需要再象makefile那样指名make clean语句，而是直接执行scons -c 或者scons -clean就可以。程序会根据SConstruct文件内容自动清除。

SConstruct的读取和执行顺序是彼此独立的，直接看以下例子。

SConstruct文件内容：

print "Calling Program('hello.c')" Program('hello.c') print "Calling Program('goodbye.c')" Program('goodbye.c') print "Finished calling Program()"

执行结果：

% scons scons: Reading SConscript files ... Calling Program('hello.c') （1） Calling Program('goodbye.c') （2） Finished calling Program() scons: done reading SConscript files. scons: Building targets ... cc -o goodbye.o -c goodbye.c （2） cc -o goodbye goodbye.o （1） cc -o hello.o -c hello.c cc -o hello hello.o scons: done building targets.

由于在执行scons时一些输出信息反而会混淆我们，所以可以加参数 -Q来关闭一些输出提示。

Program('new_hello', 'hello.c') #第一个参数可以指定目标文件名字，默认为hello，第二个参数就是source files。

多源文件编译指定：

Program('program', ['prog.c', 'file1.c', 'file2.c']) #如果没有第一个参数，则以第二个参数（这是一个python list，用【】表示）的第一个元素为program的名字。

如果你觉得列表里面每个文件都需要带一个引号太麻烦，可以利用

也可利用Glob函数获得名字列表，Golb('*.c')返回规则匹配的string列表，就是类似上面的'prog.c', 'file1.c', 'file2.c'。

两个关键字可以直接指明target和source，所以在Program

src_files = Split('main.c file1.c file2.c') Program(target = 'program', source = src_files)

src_files = Split('main.c file1.c file2.c')

Program(source = src_files, target = 'program') #可以调换参数顺序

多工程共享source files的话：

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)

building library：

Library('foo', ['f1.c', 'f2.c', 'f3.c']) #文件列表 #静态库

Library('foo', ['f1.c', 'f2.o', 'f3.c', 'f4.o']) #文件列表喝object文件

StaticLibrary('foo', ['f1.c', 'f2.c', 'f3.c']) #静态library，其实跟Library调用没区别，只是显示强调是静态库

SharedLibrary('foo', ['f1.c', 'f2.c', 'f3.c']) #共享库，类似dll

The output on POSIX:

% scons -Q cc -o f1.os -c f1.c cc -o f2.os -c f2.c cc -o f3.os -c f3.c cc -o libfoo.so -shared f1.os f2.os f3.os

link library：

Library('foo', ['f1.c', 'f2.c', 'f3.c']) Program('prog.c', LIBS=['foo', 'bar'], LIBPATH='.') #指定库，指定库的路径。

注意-l,-L,-i,-I的用法。

LIBPATH变量：

LIBPATH = '/usr/lib:/usr/local/lib' #unix用：分开

LIBPATH = 'C:\\lib;D:\\lib' #windows用；分开

Program('hello.c', CPPPATH = '.') #这里会让编译器同时关注hello.c里面include的h文件

Program('hello.c', CPPPATH = ['include', '/home/project/inc'])

编译结果：

% scons -Q hello cc -o hello.o -c -Iinclude -I/home/project/inc hello.c cc -o hello hello.o

每次都想重编一个目标，可用AlwaysBuild函数设置：

hello = Program('hello.c') AlwaysBuild(hello)

环境变量：有三种，外部环境变量（外部环境信息），scons环境变量（控制scons行为的变量），执行环境变量。变量是很多变量的集合，包括变量名和变量值。

env = Environment() #创建默认的环境变量，默认scons会按编译器的默认选项来进行编译

import os env = Environment(CC = 'gcc',CCFLAGS = '-O2') #创建并设置环境 变量 env.Program('foo.c')

% scons -Q gcc -o foo.o -c -O2 foo.c gcc -o foo foo.o

环境变量访问：env = Environment()

print "CC is:", env['CC']

另一种访问环境变量的方法，试用环境变量的subst方法，而且它还对下面的变量不断展开直到无法继续展开，例如下面两个例子：

env = Environment(CCFLAGS = '-DFOO') print "CCCOM is:", env['CCCOM'] #输出 CCCOM is: $CC $CCFLAGS $CPPFLAGS $_CPPDEFFLAGS $_CPPINC FLAGS -c -o $TARGET $SOURCES

print "CCCOM is:", env.subst('$CCCOM') #输出 CCCOM is: gcc -DFOO -c -o #这里将上面的变量值展开了

默认环境DefaultEnvironment（）； 试用方法跟上面的环境变量一样，不过控制范围是默认的所有配置。在默认环境中设置好一些变量，可以提高编译速度，比如在默认环境变量中制定了编译器的位置，这样的话可以省去搜索 默认编译器位置的 消耗。如：

替换注意事项： env = Environment(CCFLAGS = '-DDEFINE1') #-DDEFINE1

print "CCFLAGS =", env['CCFLAGS'] env.Program('foo.c') env.Replace(CCFLAGS = '-DDEFINE2') #-DDEFINE2 print "CCFLAGS =", env['CCFLAGS'] env.Program('bar.c')

#上面设置了两次，但当程序开始编译的时候，只会以最后一次配置的值为准，所以请看下面的结果：

% scons scons: Reading SConscript files ... CCFLAGS = -DDEFINE1 CCFLAGS = -DDEFINE2 scons: done reading SConscript files. scons: Building targets ... cc -o bar.o -c -DDEFINE2 bar.c cc -o bar bar.o cc -o foo.o -c -DDEFINE2foo.c cc -o foo foo.o scons: done building targets.

env.SetDefault(SPECIAL_FLAG = '-extra-option') #默认变量不存在时设置

添加新的变量： env = Environment() env.Append(NEW_VARIABLE = 'added') #不存在时自动创建并赋值；存在时变量的值是append上去而不是assign的

env.AppendUnique(CCFLAGS=['-g']) #该变量不存在时才添加

env.Prepend(CCFLAGS = ['-DFIRST']) #在变量值前面插入，不存在则自动创建并赋值，跟append相似

env.PrependUnique(CCFLAGS=['-g']) #该变量不存在才前插

env = DefaultEnvironment(tools = ['gcc', 'gnulink'], CC = '/usr/local/bin/gcc') #显式指定编译器位置

多环境变量： opt = Environment(CCFLAGS = '-O2')

dbg = Environment(CCFLAGS = '-g') opt.Program('foo', 'foo.c') dbg.Program('bar', 'bar.c')

复制环境变量：env = Environment(CC = 'gcc')

opt = env.Clone(CCFLAGS = '-O2') dbg = env.Clone(CCFLAGS = '-g') env.Program('foo', 'foo.c') o = opt.Object('foo-opt', 'foo.c') opt.Program(o) d = dbg.Object('foo-dbg', 'foo.c') dbg.Program(d)

替换环境变量值：env = Environment(CCFLAGS = '-DDEFINE1')

env.Replace(CCFLAGS = '-DDEFINE2') env.Program('foo.c')

--implicit-cache参数可让scons高速缓存哪些隐式依赖关系，这样能减少搜索隐私依赖的时间。如：

% scons -Q --implicit-cache hello cc -o hello.o -c hello.c cc -o hello hello.o % scons -Q hello scons: `hello' is up to date.

当你不想每次都输入这个参数时，可以在SConstruct文件中加入这个语句：SetOption('implicit_cache', 1)

有时scons扫描器检查不出一些文件的依赖性，可以利用Depends函数显示地的指明依赖性：

hello = Program('hello.c') Depends(hello, 'other_file')

如果想让某个依赖文件改变时不重编，可以用Ignore函数设置忽略这些依赖性：

hello_obj=Object('hello.c') hello = Program(hello_obj) Ignore(hello_obj, 'hello.h')

CPPPATH变量：类似 -I指定，指定编译目录 #声明了这个选项是用于隐式依赖，比如某些cpp文件包含了h文件，当这些h文件更改时，就会重编这些cpp对应的对象。每次编译的时候，会去搜索这些隐式依赖，所以会消耗一些时间

Program('program', Glob('*.c'))

Program('program', Split('main.c file1.c file2.c')) #这里的split函数是返回一个列表

也可以这么用来提高可读性

src_files = Split('main.c file1.c file2.c') #中间多少个空格无所谓 Program('program', src_files)