开始设置
您需要 Windows 10 或 11,以及 Rust 稳定版 1.98 或更高版本(MSVC 工具链),以及 CMake、LLVM 和 NASM 用于 BoringSSL,引擎的浏览器式连接会从源代码构建这些组件 (winget install Kitware.CMake LLVM.LLVM NASM.NASM)。
cargo build
cargo run -p mdm-app
如要在不影响自己的下载内容的情况下尝试更改,请为应用指定一个单独的数据文件夹:
set MDM_DATA_DIR=C:\some\empty\folder
cargo run -p mdm-app
cargo run -p mdm-labserver -- --faults "rate=2M"启动一个本地测试服务器,根据您指定的异常情况(连接速度慢、连接中断、响应繁忙、不支持分段请求;GET /列出了这些情况)提供生成的文件,这样无需连接互联网也能测试下载。
在您提交拉取请求之前
以下是 CI 执行的检查;每项检查都在干净的克隆版本上运行:
cargo fmt --all --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace
python tools/i18n/extract.py # then: git diff --exit-code i18n/en.tsv
node tools/extension/test.mjs
更改应聚焦于具体问题,并与周围的代码风格保持一致。以下规则适用于所有地方:
- 洁净室。 DDM 不包含来自 Internet Download Manager 或任何其他下载管理器的代码、二进制文件、艺术作品、图标、声音或文本。切勿反汇编、反编译或修改其他程序,也切勿规避任何人的许可条款。请参阅这不是逆向工程项目。
- 用户看到的所有文本都必须通过
crate::i18n(t、tc、tn、fmt);添加文本后,运行python tools/i18n/extract.py。句子中的数据(文件名、地址、大小)应通过i18n::ltr或i18n::isolate传入,以便在从右到左的语言中正确显示。 - 仅限 Windows 的调用放在
crates/app/src/win32.rs中,Linux 和 macOS 对应的调用放在unix.rs中;工作区的其余部分使用安全、可移植的 Rust(unsafe_code = "deny")。在 Windows 上,tools\dev\check-cross.ps1会检查是否仍能为 Linux 和 macOS 构建。 - 解决根本原因,而非个别问题,并确保共享数据(下载列表、浏览器扩展的消息、目录)的生成方和使用方保持同步。
翻译
界面支持 Windows 11 提供的所有语言。i18n/中的语言目录由机器翻译生成,每行标记为#, machine的内容都等待母语人士审校:
- 打开
i18n/<code>.tsv(语言代码见i18n/languages.tsv)。 - 修正该行第 3 列的翻译,并删除该行的
#, machine行。 - 保留
{placeholders}和唯一的&(键盘快捷键字母),不要更改。
删除某行的#, machine行后,该行就由您负责维护:tools/i18n/translate.py不会再对其进行机器翻译;CI(tools/i18n/reviewed_guard.py)会拒绝删除该行或再次将其标记为#, machine的拉取请求。
cargo test -p mdm-app every_catalog会检查每个语言目录。要检查文本是否合适,请将MDM_FIT_AUDIT设为文件,并使用您的语言截取屏幕截图(tools\lab\docs-shots.ps1 ... -Lang <code>):所有超出窗口边界或与其他窗口重叠的文本都会列出。有关语言列表、安装程序和从右到左布局之间的配合方式,请参阅语言。
本网站也提供 21 种语言版本,同样由机器翻译生成。网站文本位于i18n/site/<code>.json中,每行一句:修正每行的"text"(保留<g1>…</g1>和<x2/>等标签,它们代表链接和图标)。python tools/website/translate_site.py
--status会显示各语言还缺少哪些内容;使用同一工具并指定--langs <code>时,只会翻译这些内容。
报告问题
在应用中使用帮助 → 报告问题:这会打开错误报告表单,并自动填入您的版本、系统、DDM 的安装方式和界面语言。手动打开表单时,也会要求提供这些信息。安全问题:请参阅SECURITY.md。
拉取请求须遵循项目的许可协议,即GNU GPL 第 3 版或更高版本。