尧图网站建设  自动生成 DUB 配置（dub.json）)
构建工具【免费下载链接】mesonThe Meson Build System项目地址https://gitcode.com/gh_mirrors/me/meson点击查看免费下载本文围绕 Meson 构建系统中的 Dlang 模块展开讲解如何通过import(dlang)与generate_dub_file()在 Meson 项目中自动生成、维护 DUB 的dub.json配置文件并结合仓库源码说明其参数校验、依赖版本探测与文件合并机制以及如何与dependency(..., method: dub)联动消费 D 语言依赖。读完本文你将掌握在 Meson 工程中为 D 语言项目产出标准 DUB 清单文件、同时让 Meson 与 DUB 双构建系统协作的完整实战方案。Dlang 模块是什么DUB 是 D 语言生态中完全集成的构建系统同时也是一种依赖分发方式D 包注册表 code.dlang.org。Meson 的 Dlang 模块专为 D 语言提供工具它的核心职责是在 Meson 构建体系中充当与 DUB 配置格式之间的桥梁——把 Meson 中声明的项目信息自动翻译成 DUB 所要求的dub.json文件。在 Meson 中使用该模块非常简单只需导入并给模块起一个任意的变量名dlang import(dlang)变量名完全可以自定义比如d import(dlang)同样合法后续调用d.generate_dub_file(...)即可。该模块只对外暴露一个函数generate_dub_file()其用途是自动生成 DUB 配置文件。从源码实现看该模块定义于 mesonbuild/modules/dlang.py是ExtensionModule的子类methods字典中注册了唯一入口generate_dub_file模块元信息为ModuleInfo(dlang, 0.48.0)即该模块自 Meson 0.48.0 起可用。generate_dub_file() 的基本结构与必填参数generate_dub_file()只有两个必填参数项目名与源码目录。其余内容全部通过关键字参数传入这些关键字会被自动翻译为 JSON 键值对并写入生成的dub.json文件中。调用结构generate_dub_file(project name, source/folder, key: value ...)第一个参数项目名称对应dub.json中的name字段第二个参数源码目录dub.json将生成在该目录下后续key: value任意数量的关键字参数与dub.json的顶层字段一一对应。官方文档示例dlang import(dlang) dlang.generate_dub_file(meson.project_name().to_lower(), meson.project_source_root(), authors: Meson Team, description: Test executable, copyright: Copyright © 2018, Meson Team, license: MIT, sourceFiles: [test.d], targetType: executable, dependencies: my_dep )这个示例体现了两种典型用法动态取值meson.project_name().to_lower()将 Meson 项目名小写化后作为 DUB 包名meson.project_source_root()将dub.json输出到项目源码根目录静态配置authors、description、copyright、license、sourceFiles、targetType等直接以关键字形式传入这些字段恰好与 DUB 清单的标准字段如sourceFiles、targetType同名。仓库中 test cases/d/11 dub/meson.build 给出了一个真实可运行的等价示例它把输出目录改成了构建目录meson.project_build_root()并传入dependencies: urld_dep这种来自dependency()的依赖对象project(dub-example, d) dub_exe find_program(dub, required : false) if not dub_exe.found() error(MESON_SKIP_TEST: Dub not found) endif dub_ver dub_exe.version() if dub_ver.version_compare(1.31.1, 1.35.0) error(MESON_SKIP_TEST: Incompatible Dub version dub_ver) endif urld_dep dependency(urld, method: dub) test_exe executable(test-urld, test.d, dependencies: urld_dep) test(test urld, test_exe) dlang import(dlang) dlang.generate_dub_file(meson.project_name().to_lower(), meson.project_build_root(), authors: Meson Team, description: Test executable, copyright: Copyright © 2018, Meson Team, license: MIT, sourceFiles: [test.d], targetType: executable, dependencies: urld_dep )关键字参数如何映射为 dub.json 字段从 dlang.py 的generate_dub_file实现可以看清完整的映射与校验逻辑初始时配置对象只包含name: args[0]即必填的项目名随后遍历所有关键字参数若键为dependencies走专门的分支其余键则逐一做类型校验后写入配置类型校验规则关键字参数的值必须是字符串、整数、布尔值、数组或字典以及这些类型的嵌套组合否则抛出InvalidArguments异常错误信息为keyword arguments must be strings, numbers, booleans, arrays, or dictionaries of such。这意味着你几乎可以传入 DUB 清单支持的任何字段结构例如嵌套的buildOptions、subPackages等复杂对象最终以json.dumps(config, indent4, ensure_asciiFalse)写入dub.json即生成带 4 空格缩进、保留非 ASCII 字符如中文、版权符号 ©的格式化 JSON。因此“关键字自动翻译为 JSON”并非简单的字符串拼接而是经过严格类型校验的 JSON 序列化过程非法类型会在配置阶段直接报错而不是生成一个损坏的dub.json。dependencies 关键字的特殊处理dependencies是唯一具有特殊语义的关键字。它接受一个或多个依赖对象可以是数组源码中对每个依赖执行如下流程通过listify(value, flattenFalse)将传入值规范化为列表对其中每个Dependency实例取dep.get_name()调用_call_dubbin([describe, name])即执行dub describe name查询该包在本地 DUB 仓库中的信息若命令执行成功返回码为 0则用dep.get_version()取出版本号写入data[name] version最终config[dependencies] data生成形如dependencies: {urld: 1.2.3}的映射。也就是说dub.json中dependencies字段的版本号不是凭空捏造的而是 Meson 实际调用dub describe从本地 DUB 元数据中探测出来的。这也是为什么该功能要求本机已安装可用的dub可执行文件。已有 dub.json 的合并与手动编辑文档明确说明你可以手动编辑 Meson 生成的dub.json也可以自行提供一份初始的dub.json模块只会更新generate_dub_file()中指定的值其余字段原样保留。对应的源码逻辑在 dlang.py写入前会先检查目标目录下是否已存在dub.json若存在则用json.load读取作为配置基底再覆盖/新增本次调用指定的键若读取失败JSON 语法错误则输出警告Failed to load the data in dub.json并以全新配置继续。这种“读旧文件 → 合并新键 → 写回”的策略使得开发者可以放心地手工维护dub.json中的自定义字段如excludedSourceFiles、configurations同时让 Meson 持续同步项目名、描述、依赖等动态信息二者互不覆盖、互不冲突。发布 DUB 包的要求description 与 license虽然description和license并非generate_dub_file()的必填参数但文档强调若想把包发布到 D 包注册表code.dlang.org必须提供description和license。源码对此给出了配套的运行时警告当kwargs与既有config中都不存在description或license时Meson 会输出警告Without 字段 the DUB package cant be published见 dlang.py。也就是说缺少这两个字段不会导致构建失败但会在配置阶段明确提醒你该包无法发布。若你的项目只做内部构建、不打算发布这两个字段可以省略。底层机制DUB 可执行文件的探测模块在首次调用generate_dub_file()时会通过_init_dub()完成dub工具的探测dlang.py先检查是否已有类级缓存DlangModule.class_dubbin或依赖检测模块的DubDependency.class_dubbin避免重复搜索若没有缓存则调用check_dub()通过state.find_program(dub, silentTrue)在 PATH 中查找再执行dub --version验证其可运行性找到时输出绿色Found DUB: YES ... (版本号)未找到时输出红色Found DUB: NO最终若确无可用 DUB 则抛出MesonException(DUB not found.)。另外需要注意generate_dub_file()的依赖版本探测依赖dub describe因此整个模块在缺少dub的环境下无法正常工作。与 DUB 依赖检测的联动Dlang 模块负责“生成清单”而消费 DUB 依赖则走dependency(包名, method: dub)二者共同构成 Meson 对 D 生态的完整支持。相关约束记录在 D.md 与 Dependencies.mdMeson 只能找到本地 DUB 仓库中已存在的依赖需要手动先获取并构建目标依赖例如dub fetch urld dub build urldMeson 与 DUB 必须使用同一套 D 编译器。可通过 DUB 的--compiler参数与 Meson 的DC环境变量对齐例如dub build urld --compilerdmd DCdmd meson setup builddir从 mesonbuild/dependencies/dub.py 的实现可以看到更深一层的细节依赖解析时会调用dub describe获取包描述并从 DUB 缓存目录中查找“编译器、架构、平台、配置、构建类型”全部匹配的预编译产物编译器 ID 映射为dmd → dmd、gcc → gdc、llvm → ldcDUB 版本存在兼容性门槛1.31.1 且 1.35.0的版本无法定位缓存产物需要升级到 1.35这正是测试用例中MESON_SKIP_TEST跳过条件的原因当前实现仅支持静态库类型的 DUB 依赖library、sourceLibrary、staticLibraryMeson 的buildtype与 DUB 的--build值存在映射debugoptimized → release-debug、minsize → release。小结Dlang 模块通过import(dlang)引入仅含generate_dub_file()一个函数两个必填参数为项目名与源码目录其余关键字参数经类型校验后直接映射为dub.json顶层字段dependencies关键字特殊处理通过dub describe探测依赖版本号已存在的dub.json会被合并更新未指定的字段保留不变便于手动维护与混合编辑发布到 D 包注册表需要description与license缺失时 Meson 会输出明确警告与dependency(..., method: dub)配合时须保证依赖已通过dub fetch/dub build本地化并让 MesonDC与 DUB--compiler使用同一编译器。相关参考模块实现 mesonbuild/modules/dlang.py、依赖检测 mesonbuild/dependencies/dub.py、实战用例 test cases/d/11 dub/meson.build、D 语言集成说明 docs/markdown/D.md、依赖声明文档 docs/markdown/Dependencies.md。赞分享构建工具【免费下载链接】mesonThe Meson Build System项目地址https://gitcode.com/gh_mirrors/me/meson点击查看免费下载相关推荐给 WPF 应用换上现代 Fluent 界面WPF UI 快速指南给 WPF 应用换上现代 Fluent 界面WPF UI 快速指南 WPF UI 是一款面向 Windows 桌面应用的界面控件库它把 Fluent Des构建工具Meson Hotdoc 模块用 hotdoc 自动化生成并安装项目文档Meson Hotdoc 模块用 hotdoc 自动化生成并安装项目文档 导读 本文围绕 Meson 构建系统中内置的 hotdoc 模块展开讲解如何通过构建工具Meson CMake 模块完全指南CMake 子项目、配置选项与包配置文件生成Meson CMake 模块完全指南CMake 子项目、配置选项与包配置文件生成 CMake 模块是 Meson 构建系统提供的桥接工具它允许你在 Meso构建工具上一篇解决iOS弹窗适配难题WYPopoverController自动旋转与键盘处理技巧下一篇终极设计资源指南为开发者打造的免费UI工具与素材库创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Meson 的 Dlang 模块：用 generate_dub_file() 自动生成 DUB 配置（dub.json）
构建工具【免费下载链接】mesonThe Meson Build System项目地址https://gitcode.com/gh_mirrors/me/meson点击查看免费下载本文围绕 Meson 构建系统中的 Dlang 模块展开讲解如何通过import(dlang)与generate_dub_file()在 Meson 项目中自动生成、维护 DUB 的dub.json配置文件并结合仓库源码说明其参数校验、依赖版本探测与文件合并机制以及如何与dependency(..., method: dub)联动消费 D 语言依赖。读完本文你将掌握在 Meson 工程中为 D 语言项目产出标准 DUB 清单文件、同时让 Meson 与 DUB 双构建系统协作的完整实战方案。Dlang 模块是什么DUB 是 D 语言生态中完全集成的构建系统同时也是一种依赖分发方式D 包注册表 code.dlang.org。Meson 的 Dlang 模块专为 D 语言提供工具它的核心职责是在 Meson 构建体系中充当与 DUB 配置格式之间的桥梁——把 Meson 中声明的项目信息自动翻译成 DUB 所要求的dub.json文件。在 Meson 中使用该模块非常简单只需导入并给模块起一个任意的变量名dlang import(dlang)变量名完全可以自定义比如d import(dlang)同样合法后续调用d.generate_dub_file(...)即可。该模块只对外暴露一个函数generate_dub_file()其用途是自动生成 DUB 配置文件。从源码实现看该模块定义于 mesonbuild/modules/dlang.py是ExtensionModule的子类methods字典中注册了唯一入口generate_dub_file模块元信息为ModuleInfo(dlang, 0.48.0)即该模块自 Meson 0.48.0 起可用。generate_dub_file() 的基本结构与必填参数generate_dub_file()只有两个必填参数项目名与源码目录。其余内容全部通过关键字参数传入这些关键字会被自动翻译为 JSON 键值对并写入生成的dub.json文件中。调用结构generate_dub_file(project name, source/folder, key: value ...)第一个参数项目名称对应dub.json中的name字段第二个参数源码目录dub.json将生成在该目录下后续key: value任意数量的关键字参数与dub.json的顶层字段一一对应。官方文档示例dlang import(dlang) dlang.generate_dub_file(meson.project_name().to_lower(), meson.project_source_root(), authors: Meson Team, description: Test executable, copyright: Copyright © 2018, Meson Team, license: MIT, sourceFiles: [test.d], targetType: executable, dependencies: my_dep )这个示例体现了两种典型用法动态取值meson.project_name().to_lower()将 Meson 项目名小写化后作为 DUB 包名meson.project_source_root()将dub.json输出到项目源码根目录静态配置authors、description、copyright、license、sourceFiles、targetType等直接以关键字形式传入这些字段恰好与 DUB 清单的标准字段如sourceFiles、targetType同名。仓库中 test cases/d/11 dub/meson.build 给出了一个真实可运行的等价示例它把输出目录改成了构建目录meson.project_build_root()并传入dependencies: urld_dep这种来自dependency()的依赖对象project(dub-example, d) dub_exe find_program(dub, required : false) if not dub_exe.found() error(MESON_SKIP_TEST: Dub not found) endif dub_ver dub_exe.version() if dub_ver.version_compare(1.31.1, 1.35.0) error(MESON_SKIP_TEST: Incompatible Dub version dub_ver) endif urld_dep dependency(urld, method: dub) test_exe executable(test-urld, test.d, dependencies: urld_dep) test(test urld, test_exe) dlang import(dlang) dlang.generate_dub_file(meson.project_name().to_lower(), meson.project_build_root(), authors: Meson Team, description: Test executable, copyright: Copyright © 2018, Meson Team, license: MIT, sourceFiles: [test.d], targetType: executable, dependencies: urld_dep )关键字参数如何映射为 dub.json 字段从 dlang.py 的generate_dub_file实现可以看清完整的映射与校验逻辑初始时配置对象只包含name: args[0]即必填的项目名随后遍历所有关键字参数若键为dependencies走专门的分支其余键则逐一做类型校验后写入配置类型校验规则关键字参数的值必须是字符串、整数、布尔值、数组或字典以及这些类型的嵌套组合否则抛出InvalidArguments异常错误信息为keyword arguments must be strings, numbers, booleans, arrays, or dictionaries of such。这意味着你几乎可以传入 DUB 清单支持的任何字段结构例如嵌套的buildOptions、subPackages等复杂对象最终以json.dumps(config, indent4, ensure_asciiFalse)写入dub.json即生成带 4 空格缩进、保留非 ASCII 字符如中文、版权符号 ©的格式化 JSON。因此“关键字自动翻译为 JSON”并非简单的字符串拼接而是经过严格类型校验的 JSON 序列化过程非法类型会在配置阶段直接报错而不是生成一个损坏的dub.json。dependencies 关键字的特殊处理dependencies是唯一具有特殊语义的关键字。它接受一个或多个依赖对象可以是数组源码中对每个依赖执行如下流程通过listify(value, flattenFalse)将传入值规范化为列表对其中每个Dependency实例取dep.get_name()调用_call_dubbin([describe, name])即执行dub describe name查询该包在本地 DUB 仓库中的信息若命令执行成功返回码为 0则用dep.get_version()取出版本号写入data[name] version最终config[dependencies] data生成形如dependencies: {urld: 1.2.3}的映射。也就是说dub.json中dependencies字段的版本号不是凭空捏造的而是 Meson 实际调用dub describe从本地 DUB 元数据中探测出来的。这也是为什么该功能要求本机已安装可用的dub可执行文件。已有 dub.json 的合并与手动编辑文档明确说明你可以手动编辑 Meson 生成的dub.json也可以自行提供一份初始的dub.json模块只会更新generate_dub_file()中指定的值其余字段原样保留。对应的源码逻辑在 dlang.py写入前会先检查目标目录下是否已存在dub.json若存在则用json.load读取作为配置基底再覆盖/新增本次调用指定的键若读取失败JSON 语法错误则输出警告Failed to load the data in dub.json并以全新配置继续。这种“读旧文件 → 合并新键 → 写回”的策略使得开发者可以放心地手工维护dub.json中的自定义字段如excludedSourceFiles、configurations同时让 Meson 持续同步项目名、描述、依赖等动态信息二者互不覆盖、互不冲突。发布 DUB 包的要求description 与 license虽然description和license并非generate_dub_file()的必填参数但文档强调若想把包发布到 D 包注册表code.dlang.org必须提供description和license。源码对此给出了配套的运行时警告当kwargs与既有config中都不存在description或license时Meson 会输出警告Without 字段 the DUB package cant be published见 dlang.py。也就是说缺少这两个字段不会导致构建失败但会在配置阶段明确提醒你该包无法发布。若你的项目只做内部构建、不打算发布这两个字段可以省略。底层机制DUB 可执行文件的探测模块在首次调用generate_dub_file()时会通过_init_dub()完成dub工具的探测dlang.py先检查是否已有类级缓存DlangModule.class_dubbin或依赖检测模块的DubDependency.class_dubbin避免重复搜索若没有缓存则调用check_dub()通过state.find_program(dub, silentTrue)在 PATH 中查找再执行dub --version验证其可运行性找到时输出绿色Found DUB: YES ... (版本号)未找到时输出红色Found DUB: NO最终若确无可用 DUB 则抛出MesonException(DUB not found.)。另外需要注意generate_dub_file()的依赖版本探测依赖dub describe因此整个模块在缺少dub的环境下无法正常工作。与 DUB 依赖检测的联动Dlang 模块负责“生成清单”而消费 DUB 依赖则走dependency(包名, method: dub)二者共同构成 Meson 对 D 生态的完整支持。相关约束记录在 D.md 与 Dependencies.mdMeson 只能找到本地 DUB 仓库中已存在的依赖需要手动先获取并构建目标依赖例如dub fetch urld dub build urldMeson 与 DUB 必须使用同一套 D 编译器。可通过 DUB 的--compiler参数与 Meson 的DC环境变量对齐例如dub build urld --compilerdmd DCdmd meson setup builddir从 mesonbuild/dependencies/dub.py 的实现可以看到更深一层的细节依赖解析时会调用dub describe获取包描述并从 DUB 缓存目录中查找“编译器、架构、平台、配置、构建类型”全部匹配的预编译产物编译器 ID 映射为dmd → dmd、gcc → gdc、llvm → ldcDUB 版本存在兼容性门槛1.31.1 且 1.35.0的版本无法定位缓存产物需要升级到 1.35这正是测试用例中MESON_SKIP_TEST跳过条件的原因当前实现仅支持静态库类型的 DUB 依赖library、sourceLibrary、staticLibraryMeson 的buildtype与 DUB 的--build值存在映射debugoptimized → release-debug、minsize → release。小结Dlang 模块通过import(dlang)引入仅含generate_dub_file()一个函数两个必填参数为项目名与源码目录其余关键字参数经类型校验后直接映射为dub.json顶层字段dependencies关键字特殊处理通过dub describe探测依赖版本号已存在的dub.json会被合并更新未指定的字段保留不变便于手动维护与混合编辑发布到 D 包注册表需要description与license缺失时 Meson 会输出明确警告与dependency(..., method: dub)配合时须保证依赖已通过dub fetch/dub build本地化并让 MesonDC与 DUB--compiler使用同一编译器。相关参考模块实现 mesonbuild/modules/dlang.py、依赖检测 mesonbuild/dependencies/dub.py、实战用例 test cases/d/11 dub/meson.build、D 语言集成说明 docs/markdown/D.md、依赖声明文档 docs/markdown/Dependencies.md。赞分享构建工具【免费下载链接】mesonThe Meson Build System项目地址https://gitcode.com/gh_mirrors/me/meson点击查看免费下载相关推荐给 WPF 应用换上现代 Fluent 界面WPF UI 快速指南给 WPF 应用换上现代 Fluent 界面WPF UI 快速指南 WPF UI 是一款面向 Windows 桌面应用的界面控件库它把 Fluent Des构建工具Meson Hotdoc 模块用 hotdoc 自动化生成并安装项目文档Meson Hotdoc 模块用 hotdoc 自动化生成并安装项目文档 导读 本文围绕 Meson 构建系统中内置的 hotdoc 模块展开讲解如何通过构建工具Meson CMake 模块完全指南CMake 子项目、配置选项与包配置文件生成Meson CMake 模块完全指南CMake 子项目、配置选项与包配置文件生成 CMake 模块是 Meson 构建系统提供的桥接工具它允许你在 Meso构建工具上一篇解决iOS弹窗适配难题WYPopoverController自动旋转与键盘处理技巧下一篇终极设计资源指南为开发者打造的免费UI工具与素材库创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考