- Startseite
- Mitwirken
Zu Dannex Download Manager beitragen
Fehlerberichte, Ideen, Übersetzungsfehler und Pull-Requests sind willkommen. Alles geschieht offen auf GitHub.
Einrichtung
Sie benötigen Windows 10 oder 11 und Rust stable 1.98 oder neuer (die MSVC-Toolchain) sowie CMake, LLVM und NASM für BoringSSL, das die Browser-ähnliche Verbindung der Engine aus dem Quellcode erstellt (winget install Kitware.CMake LLVM.LLVM NASM.NASM).
cargo build
cargo run -p mdm-app
Um Änderungen auszuprobieren, ohne Ihre eigenen Downloads zu beeinflussen, geben Sie der App einen separaten Datenordner mit:
set MDM_DATA_DIR=C:\some\empty\folder
cargo run -p mdm-app
cargo run -p mdm-labserver -- --faults "rate=2M"startet einen lokalen Testserver, der generierte Dateien mit den von Ihnen gewünschten Problemen (langsame Verbindungen, Unterbrechungen, ausgelastete Antworten, keine Bereiche; GET / listet sie auf) bereitstellt, sodass Downloads ohne Internet getestet werden können.
Bevor Sie einen Pull-Request öffnen
Dies sind die Prüfungen, die CI durchführt; jede funktioniert auf einem sauberen Klon:
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
Halten Sie Änderungen fokussiert und passen Sie sie dem umgebenden Code an. Einige Regeln gelten überall:
- Saubere Entwicklung. DDM enthält keinen Code, keine Binärdateien, Grafiken, Symbole, Sounds oder Texte von Internet Download Manager oder einem anderen Download-Manager. Zerlegen, dekompilieren oder patchen Sie niemals ein anderes Programm und umgehen Sie niemals die Lizenzbedingungen anderer. Siehe Kein Reverse-Engineering-Projekt.
- Jeder Text, den Nutzer sehen, läuft über
crate::i18n(t,tc,tn,fmt); führen Sie nach dem Hinzufügen eines Textespython tools/i18n/extract.pyaus. Daten innerhalb eines Satzes (ein Dateiname, eine Adresse, eine Größe) werden überi18n::ltroderi18n::isolateeingefügt, damit sie in Sprachen mit Schreibrichtung von rechts nach links richtig angezeigt werden. - Aufrufe, die nur unter Windows verfügbar sind, befinden sich in
crates/app/src/win32.rs, die entsprechenden Aufrufe für Linux und macOS inunix.rs; der Rest des Arbeitsbereichs besteht aus sicherem, portablem Rust (unsafe_code = "deny"). Unter Windows prüfttools\dev\check-cross.ps1, ob sich das Projekt weiterhin für Linux und macOS kompilieren lässt. - Ursachen statt Einzelfälle beheben und dafür sorgen, dass Erzeuger und Nutzer gemeinsamer Daten (die Download-Liste, die Nachrichten der Browser-Erweiterung, die Kataloge) aufeinander abgestimmt sind.
Übersetzungen
Die Oberfläche ist in allen Sprachen verfügbar, die Windows 11 anbietet. Die Kataloge in i18n/ wurden maschinell übersetzt, und jede mit #, machine markierte Zeile wartet auf die Prüfung durch Muttersprachlerinnen und Muttersprachler:
- Öffnen Sie
i18n/<code>.tsv(die Codes finden Sie ini18n/languages.tsv). - Korrigieren Sie die Übersetzung in der dritten Spalte der Zeile und löschen Sie die
#, machine-Zeile. - Behalten Sie
{placeholders}und das einzelne&(den Buchstaben für die Tastenkombination) unverändert bei.
Eine Zeile ohne ihre #, machine-Zeile gehört von da an Ihnen: tools/i18n/translate.py schickt sie nie wieder zur maschinellen Übersetzung, und CI (tools/i18n/reviewed_guard.py) lässt jeden Pull-Request fehlschlagen, der sie löscht oder erneut als #, machine markiert.
cargo test -p mdm-app every_catalogprüft jeden Katalog. Um zu sehen, ob Ihre Texte passen, setzen Sie MDM_FIT_AUDIT auf eine Datei und erstellen Sie die Screenshots in Ihrer Sprache (tools\lab\docs-shots.ps1 ... -Lang <code>): Dort wird jeder Text aufgelistet, der über sein Fenster oder über ein anderes Fenster hinausragt. Unter Sprachen erfahren Sie, wie Sprachliste, Installer und Layout für Sprachen mit Schreibrichtung von rechts nach links zusammenspielen.
Die Website ist ebenfalls in 21 Sprachen verfügbar und wurde auch maschinell übersetzt. Ihre Texte stehen in i18n/site/<code>.json, eine Zeile pro Satz: Korrigieren Sie die "text" einer Zeile (lassen Sie Tags wie <g1>…</g1> und <x2/> unverändert; sie stehen für Links und Symbole). python tools/website/translate_site.py
--status zeigt, was in den einzelnen Sprachen noch fehlt. Dasselbe Tool übersetzt mit --langs <code> nur diese fehlenden Texte.
Probleme melden
Verwenden Sie in der App Hilfe → Ein Problem melden: Dadurch wird das Fehlerberichtsformular geöffnet, in dem Ihre Version, Ihr System, die Art der DDM-Installation und die Sprache bereits eingetragen sind. Wenn Sie das Formular selbst öffnen, werden dieselben Angaben abgefragt. Informationen zu Sicherheitsproblemen finden Sie in SECURITY.md.
Pull-Requests werden unter der Projektlizenz, der GNU GPL, Version 3 oder neuer, akzeptiert.