scons用户指南第四章：编译和链接库文件

1、编译库文件

你可以使用Library方法来编译库文件：

Library('foo', ['f1.c', 'f2.c', 'f3.c'])

SCons会根据你的系统使用合适的库前缀和后缀。所以在POSIX系统里，上面的例子会如下编译：

% scons -Q

cc -o f1.o -c f1.c

cc -o f2.o -c f2.c

cc -o f3.o -c f3.c

ar rc libfoo.a f1.o f2.o f3.o

ranlib libfoo.a

如果你不显示指定目标库的名字，SCons会使用第一个源文件的名字。

1.1、使用源代码或目标文件编译库文件

除了使用源文件外，Library也可以使用目标文件，如下所示：

Library('foo', ['f1.c', 'f2.o', 'f3.c', 'f4.o'])

1.2、使用StaticLibrary显示编译静态库

Library函数是用来编译静态库的。如果你想显示指定需要编译静态库，可以使用StaticLibrary替代Library：

StaticLibrary('foo', ['f1.c', 'f2.c', 'f3.c'])

1.3、使用SharedLibrary编译动态库

如果想编译动态库（在POSIX系统里）或DLL文件（Windows系统），可以使用SharedLibrary：

SharedLibrary('foo', ['f1.c', 'f2.c', 'f3.c'])

在POSIX里运行scons编译：

% 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

2、链接库文件

链接库文件的时候，使用$LIBS变量指定库文件，使用$LIBPATH指定存放库文件的目录：

Library('foo', ['f1.c', 'f2.c', 'f3.c'])

Program('prog.c', LIBS=['foo', 'bar'], LIBPATH='.')

注意到，你不需要指定库文件的前缀（比如lib）或后缀（比如.a或.lib），SCons会自动匹配。

% scons -Q

cc -o f1.os -c f1.c

cc -o f2.os -c f2.c

cc -o f3.os -c f3.c

ar rc libfoo.a f1.o f2.o f3.o

ranlib libfoo.a

cc -o prog.o -c prog.c

cc -o prog prog.o -L. -lfoo -lbar

3、$LIBPATH告诉去哪里找库

默认情况下，链接器只会在系统默认的库目录中寻找库文件。SCons也会去$LIBPATH指定的目录中去寻找库文件。$LIBPATH由一个目录列表组成，如下所示：

Program('prog.c', LIBS='m', LIBPATH=['/usr/lib', '/usr/local/lib'])

使用Python列表的好处是可以跨平台。另一种可选方式是，把库目录用系统特定的路径分隔符连接成一个字符串：

在POSIX系统里：

LIBPATH='/usr/lib:/usr/local/lib'

在Windows里：

LIBPATH='C:\\lib;D:\\lib'

当链接器执行的时候，SCons会创建合适的flags，使得链接器到指定的库目录寻找库文件。上面的例子在POSIX系统里编译：

% scons -Q

cc -o prog.o -c prog.c

cc -o prog prog.o -L/usr/lib -L/usr/local/lib -lm