如何使用waf构建共享库？

Question

我想使用 waf 构建一个共享库，因为它看起来更容易并且比 GNU 自动工具更简洁。

到目前为止，我实际上有几个与我开始编写的 wscript 相关的问题：

VERSION='0.0.1'
APPNAME='libmylib'

srcdir = '.'
blddir = 'build'

def set_options(opt):
 opt.tool_options('compiler_cc')
 pass

def configure(conf):
 conf.check_tool('compiler_cc')
 conf.env.append_value('CCFLAGS', '-std=gnu99 -Wall -pedantic -ggdb')

def build(bld):
 bld.new_task_gen(
  features = 'cc cshlib',
  source = '*.c',
  target='libmylib')

包含 source = '*.c' 的行不起作用。我必须指定每个 .c 文件而不是使用通配符吗？

例如，如何启用调试构建（当前 wscript 正在使用调试构建 CFLAGS，但我希望最终用户可以选择此选项）。

计划将库源放在一个子目录中，并且使用 lib 的程序分别放在自己的子目录中。

Answer 1

假设您使用的是最新版本的 waf（撰写本文时为 1.5.9），可以通过 glob() 构建上下文中的方法。因此，您可以编写以下内容：

bld.new_task_gen(
    features = 'cc cshlib',
    source = bld.glob('*.c'),
    target='mylib')

如果您使用的是没有 glob 的旧版本 waf，那么您可以使用一个方法 find_sources_in_dirs：

lib = bld.new_task_gen(
    features = 'cc cshlib',
    target = 'mylib')
lib.find_sources_in_dirs('.')

此方法仍在 Waf 中，但已预定弃用并可能最终消失。

srcdir 和 blddir 变量现在是可选的，因此您不需要它们 - 它们默认为“.”。无论如何，“构建”。您不应在目标名称前添加“lib”，这是以特定于平台的方式自动完成的（在 Windows 上不添加 lib，共享库使用 .dll）。调试与发布构建是一个令人惊讶的棘手问题。最初 Waf 包含此功能，但在某个时候被删除并且从未重新添加。这是邮件列表上的常见请求，因此将来可能会重新出现。同时，您可能会做比使用 gjc 的 cflags 模块。只需将其添加到您的项目目录中即可。最终的 wscript 将是：

VERSION='0.0.1'
APPNAME='mylib'

def set_options(opt):
    opt.tool_options('compiler_cc')
    opt.tool_options('cflags', tooldir='.')

def configure(conf):
    conf.check_tool('compiler_cc')
    conf.check_tool('cflags', tooldir='.')

def build(bld):
    bld.new_task_gen(
        features = 'cc cshlib',
        source = bld.glob('*.c'),
        target=APPNAME)

要设置调试版本，您将运行以下命令：

./waf configure -d debug

如果您在自己的子目录中使用库，那么您可能应该有一个顶级 wscript 并使用 bld.add_subdirs() 添加库的技术/程序目录。每个子目录都有自己的 wscript_build 文件。然后，您可以使用 export_incdirs 和 uselib_local 属性指定库和程序“模块”之间的正确包含目录。

Answer 2

多年来，waf 发生了很大变化，因此问题中的代码和答案都不再适用于当前的 waf。现在你只需编写：

def options(ctx):
    ctx.load('compiler_c')
def configure(ctx):
    ctx.load('compiler_c')
def build(ctx):
    ctx.shlib(source = ctx.path.ant_glob('src/*.c'),
              target = 'name')

请注意，waf 会自动添加 lib 前缀，因此你不必编写 target
= '库名称'.在 Windows 上，您还必须将 defs 关键字参数添加到 shlib 函数调用中。

就我个人而言，我建议不要使用涉及 wscript_build 文件的递归构建脚本。并不是说它不起作用（如 递归 makefile），只是保留所有逻辑要简单得多在一个中等大小的构建脚本中。