scons使用（带小例子和makefile对比）

一、简介

1. scons 和 make 都是 都是用来管理项目编译的。

2. scons 通过 SConscript 文件管理编译。make通过makefile管理编译

3. scons 一般这样管理 项目编译。

   在顶层的 SConstruct 文件中， 使用函数 DefaultEnvironment 。

   CPPPATH=[’./’];

   TOOLS_PREFIX=‘arm-linux-’

   Environment(CCFLAGS = CCFLAGS,
   CC=TOOLS_PREFIX+‘gcc’,
   CXX=TOOLS_PREFIX+‘g++’,
   LD=TOOLS_PREFIX+‘g++’,
   AR=TOOLS_PREFIX+‘ar’,
   STRIP=TOOLS_PREFIX+‘strip’,
   LIBS = LIBS,
   LIBPATH = LIBPATH,
   CPPPATH = CPPPATH,
   LINKFLAGS = LINKFLAGS,
   OS_SUBSYSTEM_CONSOLE=OS_SUBSYSTEM_CONSOLE,
   OS_SUBSYSTEM_WINDOWS=OS_SUBSYSTEM_WINDOWS);

   设置好要编译的子目录

   SConscriptFiles=[’./hello/SConscript’];

   SConscript(SConscriptFiles)；

   而后在下层目录中：

   env = DefaultEnvironment().Clone();

   env.Program(target=‘hello’,source=‘hello.c’);

   而后在顶层目录执行scons命令编译。

二、scons和makefile 对应关系

功能	make实现	scons实现	备注
指定包含头文件的实现	使用 -I 指定-I./ -I/opt/build/include	CPPPATH =["./","…/Include"];这是一个列表
添加编译选项	使用-直接指定，比如 -O3 -Wall.一般放在CFLAGS中	CCFLAGS="-DDEBUG -DHAS_TEST";这是一个字符串。
指定编译器	CC=	CC=‘mipsel-linux-’ + ‘gcc’ ; 这是一个字符串
指定要链接的库	LIBS="-lpthread -lcurl"	LIBS=[‘pthread’,‘curl’]; 这是一个列表
安装	创建一个install目标；install:	env.Install(’/bin’, source = [‘desmon’]);其实可以在生成的时候指定目录，就不需要执行install操作了。
clean	创建一个clean目标；clean:	env.Clean(’/bin’, ['desmon])；如果没有写clean默认会把新生成的内容删掉。
生成静态库	ar rcs -o libtest.a hello1.o hello2.o	env.StaticLibrary(target=‘libtest’,source=[‘hello1.c’,‘hello2.c’]); 使用env.Library(target=‘libtest’,source=[‘hello1.c’,‘hello2.c’]);默认生成的是静态库
生成动态库	gcc -shared -o libtest.so name1.o name2.o name3.o	env.SharedLibrary(‘libtest’, [‘name1**.**o’, ‘name2.o’, ‘name3.c’])
生成可执行程序	gcc -o hello hello.c	env.Program(target=‘hello’,source=[‘hello.c’]);
编译多个目录	SUBDIR=xxx xxx xxx ; for i in $(SUBDIRS); do $(MAKE) -C $$i all; sleep 2; done;要使用for循环遍历	将要编译的目录放到列表SConscriptFiles中。执行SConscript(SConscriptFiles); SConscriptFiles=[’./src/SConscript’,’./test/SConscript’]; SConscript(SConscriptFiles);
导入环境变量	export HAS_CURL 1	导入os,然后使用os.environ[‘HAS_CURL’]=‘1’;
链接库的路径	-L./;使用 -L指定	LIBPATH=[’./’]; 使用LIBPATH指定。

三、scons 的常用方法

1. 操作路径。

   1. 经常会有要组装路径的情况。

      os.path.join(root, subdir);

   2. 使用这个方法将路径组装起来。

2. 获取当前路径。

   1. os.getcwd()。其实是python 的os模块。不过很有用。

3. 设置环境变量

   1. os.environ [‘key’]=‘value’; 也是python os模块的使用。

4. 访问某个文件夹下的某些文件。

   1. Glob(’./*.c’); 当前目录下的所有的.c文件。并且返回一个列表
   2. Glob(’./lcd*.c’);访问当前目录下所有的lcd开头的.c文件，并且返回一个列表。

5. 创建env对象，管理编译参数

   1. 一般在最上层的SConstruct文件中，会执行DefaultEnvironment(CCFLAGS = CCFLAGS,
      CC=TOOLS_PREFIX+‘gcc’,
      CXX=TOOLS_PREFIX+‘g++’,
      LD=TOOLS_PREFIX+‘g++’,
      AR=TOOLS_PREFIX+‘ar’,
      STRIP=TOOLS_PREFIX+‘strip’,
      LIBS = LIBS,
      LIBPATH = LIBPATH,
      CPPPATH = CPPPATH,
      LINKFLAGS = LINKFLAGS,
      OS_SUBSYSTEM_CONSOLE=OS_SUBSYSTEM_CONSOLE,
      OS_SUBSYSTEM_WINDOWS=OS_SUBSYSTEM_WINDOWS);类似这样，传入需要的参数。
   2. 而后在子目录中，使用env = DefaultEnvironment().Clone();
   3. 然后可以执行其它的操作。比如 env.Program(target=‘hello’,source=‘hello.c’);这样会根据顶层目录传入的参数对hello.c进行编译。
   4. 可以使用evn[‘CPPPATH’] 来访问当前头文件包含路径。这是字典的数据结构。顶层目录也可以使用这种方法赋值。

四、简单案例

1. 现在有个小项目，目录结构如下：

   

2. 顶层SConstruct文件内容。指定在当前目录，或者是在 ‘./hello’ 目录找 包含的头文件。

   CPPPATH=['./','./hello'];
   
   DefaultEnvironment(CPPPATH=CPPPATH);
   
   ConstructScriptFiles=['./hello/ConstructScript'];
   
   SConscript(ConstructScriptFiles);
   

3. hello/ConstructScript文件内容。这里指定利用./hello.c 生成 test可执行程序。

   sources = ['./hello.c'];
   env = DefaultEnvironment().Clone();
   env.Program(target='test',source=sources);
   
   

4. hello.c 文件内容。这里注意 include<hello.h>是 用的尖括号。也就是说如果你不指定hello.h的目录的话，是找不到的。

   #include<hello.h>
     
   int main()
   {
           printf(HELLO);
           printf("\n");
           return 0;
   }
   

5. hello.h 文件内容

   #include<stdio.h>
     
   #define HELLO "Hello World"
   
   

6. 在顶层执行scons，将生成test文件。