Xmake构建系统中的规则API与依赖顺序改进

Xmake项目近期针对构建系统中的规则API和依赖顺序管理进行了重大改进，这些改进显著提升了构建系统的灵活性和可控性。本文将详细介绍这些技术改进的核心内容。

统一DAG实现

Xmake现在采用了统一的DAG(有向无环图)实现来管理构建任务。如果没有显式指定任务顺序，系统会自动根据内部构建规则添加默认的依赖顺序。开发者可以通过jobgraph接口精确控制构建流程：

rule("foo")
    on_build_file(function (target, jobgraph, sourcefile, opt)
        jobgraph:add(target:name().."/"..sourcefile, function(index, total, opt)
            -- 构建逻辑
        end)
    end, {jobgraph = true})

细粒度的源码文件依赖控制

新版本支持对单个源文件级别的依赖顺序进行精确控制：

rule("foo")
    on_build_files(function (target, jobgraph, sourcebatch, opt)
        for _, sourcefile in sourcebatch.sourcefiles do
            local job_name = target:name().."/"..sourcefile
            jobgraph:add(job_name, function(index, total, opt)
                -- 构建逻辑
            end)
            -- 添加任务顺序依赖
            jobgraph:add_orders(job_name, other_target:name().."/buildfiles")
        end
    end, {jobgraph = true})

实时构建任务管理

Xmake现在支持在构建过程中动态添加或移除构建任务：

rule("foo")
    on_build_file(function (target, jobgraph, sourcefile, opt)
        local job_name = target:name().."/"..sourcefile
        jobgraph:add(job_name, function(index, total, opt)
            -- 动态添加新任务
            jobgraph:add("zoo/build", function (index, total, opt)
            end)
            -- 移除已有任务
            jobgraph:remove("bar/buildfiles")
        end)
    end, {jobgraph = true})

构建准备阶段

新增的prepare阶段允许在正式构建前执行预处理工作，如C++模块文件扫描等：

rule("scan_module_files")
    on_prepare(function (target, opt)
        -- 扫描模块文件
    end)

或者使用jobgraph接口：

rule("scan_module_files")
    on_prepare(function (target, jobgraph, opt)
        jobgraph:add(target:name().."/scanfiles", function (index, total, opt)
            -- 扫描模块文件
        end)
    end, {jobgraph = true})

规则顺序控制

开发者现在可以显式控制规则的执行顺序：

rule("foo")
    add_orders("rule1", "rule2", "rule3")
    add_orders("foo", "rule5")

这将产生以下执行顺序：

rule1 → rule2 → rule3
foo → rule5

任务分组支持

新版本引入了任务分组机制，可以更好地组织相关任务：

rule("foo")
    on_build_files(function (target, jobgraph, sourcebatch, opt)
        local group_name = target:name().."/buildfiles"
        for _, sourcefile in sourcebatch.sourcefiles do
            local job_name = target:name().."/"..sourcefile
            jobgraph:add(job_name, function(index, total, opt)
                -- 构建逻辑
            end, {groups = group_name})
        end
        -- 添加任务顺序依赖
        jobgraph:add_orders(other_target:name().."/buildfiles", group_name)
    end, {jobgraph = true})

兼容性考虑

为了确保平稳过渡，Xmake提供了回退机制。开发者可以通过设置策略来使用旧的jobbatch模式：

set_policy("build.jobgraph", false)

实际应用案例

这些改进特别有利于复杂构建场景，如C++模块与预编译头文件的处理。现在可以确保模块依赖扫描在构建前完成，并正确处理各种规则间的依赖关系。

[  1%]: compiling.release src/test.h
[  1%]: <hello> generating.module.deps src/main.cpp
[  2%]: <hello> generating.module.deps src/hello.mpp
[  3%]: <hello> generating.module.deps /usr/local/Cellar/llvm/19.1.2/bin/../lib/c++/../../share/libc++/v1/std.cppm
[ 25%]: <hello> compiling.module.release hello
[ 43%]: compiling.release src/main.cpp
[ 60%]: linking.release hello

这些改进使Xmake在复杂项目构建管理方面更加强大和灵活，为开发者提供了更精细的控制能力。