dub选项中文帮助.

dub命令选项:

省略命令,则为run,--用于分割选项.
取包或包元数据时http_proxy为环境变量设置.
dub -a x86 --compiler dmd,x86架构下用dmd编译器

一般命令:

-h

选项	解释
--help	显示一般命令帮助
--root=	操作的根目录
--registry=	解析依赖时搜索的网径,默认为dub注册项,或类似mvn+http://localhost:8040/maven/libs-release/dubpackages的maven格式
--skip-registry=<值>	跳过注册
--annotate	只注解,不执行.
--bare	仅读当前目录包.

-v

选项	解释
--verbose	诊断输出
--vverbose	调试输出

-q

选项	解释
--quiet	仅打印警告和错误
--verror	仅打印错误
--vquiet	不打印
--cache=<值>	把包放进特定目录[本地/系统/用户]

命令概览

选项	解释
init	初化空包
run	(默认)构建并运行
build	(默认用当前目录主包)构建包
test	执行选择包的测试
lint	执行lint测试
generate	用特定生成器生成项目文件
describe	打印项目和依赖的json描述
clean	清理中间构建和缓存结果
dustmite	为生成错误构建简单测试案例

管理包

选项	解释
fetch	取并缓存包
install	同上
add	加依赖
remove	移除缓存包
uninstall	同上
upgrade	强制升级依赖
add-path	加默认包搜索路径
remove-path	移除包搜索路径
add-local	加本地包目录(git仓库)
remove-local	移除本地包目录
list	列举dub知道的所有包
search	搜索可用包
add-override	加包盖
remove-override	移包盖
list-overrides	列包盖
clean-caches	清缓存元数据
convert	转换包配置格式

创建(init)包选项

选项	详细	解释
-t	--type=	置类型(minimal,vibe.d,deimos,custom)
-f	--format=	包配置格式(默认json,sdl)
-n	--non-interactive	非交互

构建,测试,运行命令

构建运行(build/run),差不多一样

选项	解释
--temp-build	在临时目录构建
--rdmd	用rdmd构建
--nodeps	构建前,不解析缺少的依赖
--build-mode=<值>	编译器/链接器调用方式可为separate(默认),allAtOnce,singleFile
--single	把包名当作文件名,必须包含包节注释
--force-remove	过时选项
--filter-versions	[实验],过滤版本和调试标识来提高构建缓存效率
--combined	单趟构建整个工程
--print-builds	打印可用构建类型
--print-configs	打印可用配置列表
--print-platform	dub.json中构建平台字段的标识
--parallel	尽量并行编译实例
--override-config=<值>	对特定依赖覆盖特定配置如--override-config=<依赖>/<配置>,可多次指定
--compiler=<值>	指定用的编译器如ldc2/dmd/gdc/gdmd/ldmd可为路径

选项	详细	解释
-n	--non-interactive	不进入交互模式
-b	--build=<值>	构建类型,可能值为debug (默认), plain, release, release-debug, release-nobounds, unittest, profile, profile-gc, docs, ddox, cov, unittest-cov, syntax and custom types,DFLAGS将覆盖这个值,重要选项
-f	--force	强制重构
-y	--yes	自动回复是.
-c	--config=<值>	构建特定配置,可在dub.json中指定
-a	--arch=<值>	强制不同架构如x86/x86_64
-d	--debug=<值>	指定调试版本,可多次用

测试(test)

执行所有包含的单元测试,如果包包含测试包的依赖,则自动生成的主文件将用它来跑单元测试.

选项	解释
--main-file=<值>	指定包含主()函数来跑测试
--coverage	生成覆盖

其余与上一样,

lint(执行d-scanner测试)

选项	解释
--syntax-check	词法语法分析源文件打印符号错误
--style-check	词法语法分析源文件打印静态分析检查错误
--error-format=<值>	上面分析器得出的格式错误
--report	用json格式生成静态分析报告
--report-format=<值>	指定静态分析报告格式
--import-paths=<值>	导入路径

其余构建运行一样.

生成

选项	解释
visuald	VisualD项目文件
sublimetext	SublimeText项目文件
cmake	CMake
build	直接构建

可给定可选包名

描述

根包及依赖包的构建描述,对ide有用,所有有用选项对构建/运行/生成也有用.将打印相应的特定构建配置.
–data=值可为:main-source-file, dflags, lflags, libs, linker-files, source-files, versions, debug-versions, import-paths, string-import-paths, import-files, options
有--data-list时可为:target-type, target-path, target-name, working-directory, copy-files, string-import-files, pre-generate-commands, post-generate-commands, pre-build-commands, post-build-commands, requirements

选项	解释
--import-paths	--data=import-paths --data-list的简写
--string-import-paths	--data=string-import-paths --data-list的简写
--data=值	特定构建配置的值
--data-list	按列配置
--data-0	按\0配置,用于xargs -0

清理(clean)

选项	解释
--all-packages	删除所有已知包

dustmite

通过检查编译器/链接器的错误码和他们的输出来决定期望的错误条件,如果提供--program-status/--program-regex并要生成二进制,则执行它的结果也将整合至二进制.

选项	解释
--compiler-status	编译器状态代码
--compiler-regex	匹配编译器输出正则式
--linker-status	链接器状态码
--linker-regex	匹配链接器输出正则式
--program-status	可执行文件状态码
--program-regex	匹配程序输出正则式
--test-package	运行测试仅在内部使用

管理包

fetch

选项	解释
--version=<值>	版本

add(remove)

与加依赖至dub.json/dub.sdl的dependencies一样.
如无版本,则找最新的.

更新(upgrade)

更新dub.selections.json里的直接和间接依赖.

选项	解释
--prerelease	即使有发布版本,也用最新的预发布版本,
--verify	更新项目并构建,成功的话重写版本
--dry-run	仅打印要更新的,但不更新
--missing-only	仅更新无版本号的依赖,每次构建自动运行

加/删路径(add/remove-path)

加/删搜索路径,在此路径及直接子层下搜索包描述

选项	解释
--system	注册为系统相关

加/删本地(add/remove-local)

加/删本地依赖解析,用于注册本地包,上面是路径(及其子目录),本地是包,只一个目录

选项	解释
--system	注册为系统相关

转换(convert)

转换格式(sdl/json)

选项	详细	解释
-f	--format=<值>	目标格式json,sdl
-s	--stdout	输出至标输出,而不是磁盘