セットアップ
Windows 10 または 11、Rust stable 1.98 以降 (MSVC ツールチェーン)、および BoringSSL 用の CMake、LLVM、NASM が必要です。エンジンのブラウザのような接続は、これらをソースからビルドします (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に文ごとに1行で記載されています。各行の"text"を修正してください(<g1>…</g1>や<x2/>などのタグはリンクやアイコンを表すため、変更しないでください)。python tools/website/translate_site.py
--statusでは各言語で不足している部分を確認でき、同じツールで--langs <code>を使うと、不足部分だけを翻訳できます。
問題の報告
アプリでヘルプ → 問題の報告を選ぶと、バージョン、システム、DDMのインストール方法、言語が入力されたバグ報告フォームが開きます。フォームを自分で開いた場合も、同じ情報の入力を求められます。セキュリティ上の問題については、SECURITY.mdをご覧ください。
プルリクエストは、プロジェクトのライセンスであるGNU GPL、バージョン3以降の下で受け入れられます。