Instellen
U hebt Windows 10 of 11 en Rust stable 1.98 of nieuwer (de MSVC-toolchain) nodig, en CMake, LLVM en NASM voor BoringSSL, die de browserachtige verbinding van de engine vanuit de bron bouwt (winget install Kitware.CMake LLVM.LLVM NASM.NASM).
cargo build
cargo run -p mdm-app
Om wijzigingen uit te proberen zonder uw eigen downloads aan te raken, geeft u de app een aparte gegevensmap:
set MDM_DATA_DIR=C:\some\empty\folder
cargo run -p mdm-app
cargo run -p mdm-labserver -- --faults "rate=2M"start een lokale testserver die gegenereerde bestanden aanbiedt met de problemen die u opgeeft (trage verbindingen, onderbrekingen, drukke antwoorden, geen bereikondersteuning; GET / geeft een overzicht), zodat downloads zonder internet kunnen worden getest.
Voordat u een pull-aanvraag opent
Dit zijn de controles die CI uitvoert; ze werken allemaal op een schone kloon:
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
Houd wijzigingen gericht en laat ze aansluiten bij de omringende code. Enkele regels gelden overal:
- Schone lei. DDM bevat geen code, binaire bestanden, illustraties, pictogrammen, geluiden of tekst van Internet Download Manager of een andere downloadmanager. Demonteer, decompileer of patch nooit een ander programma en omzeil nooit iemands licentievoorwaarden. Zie Geen project voor reverse-engineering.
- Alle teksten die de gebruiker ziet, lopen via
crate::i18n(t,tc,tn,fmt); voer na het toevoegen van een tekstpython tools/i18n/extract.pyuit. Gegevens in een zin (een bestandsnaam, een adres, een grootte) worden ingevoegd viai18n::ltrofi18n::isolate, zodat de tekst ook in talen die van rechts naar links worden gelezen goed wordt weergegeven. - Windows-specifieke aanroepen staan in
crates/app/src/win32.rs, de tegenhangers voor Linux en macOS inunix.rs; de rest van de werkruimte bestaat uit veilige, draagbare Rust-code (unsafe_code = "deny"). Op Windows controleerttools\dev\check-cross.ps1of de code nog steeds voor Linux en macOS kan worden gebouwd. - Los de oorzaak op, niet alleen afzonderlijke gevallen, en zorg dat producenten en gebruikers van gedeelde gegevens (de downloadlijst, de berichten van de browserextensie, de catalogi) op elkaar afgestemd blijven.
Vertalingen
De interface is beschikbaar in alle talen die Windows 11 aanbiedt. De catalogi in i18n/ zijn met machinevertaling gemaakt. Elke rij met #, machine moet nog door een moedertaalspreker worden gecontroleerd:
- Open
i18n/<code>.tsv(de codes staan ini18n/languages.tsv). - Verbeter de vertaling in de derde kolom van de rij en verwijder de regel met
#, machine. - Laat
{placeholders}en de ene&(de letter voor de sneltoets) ongewijzigd.
Vanaf dat moment is een rij zonder de regel met #, machine door u vertaald: tools/i18n/translate.py stuurt die nooit meer naar de machinevertaling, en CI (tools/i18n/reviewed_guard.py) laat geen pull-aanvraag toe die de rij verwijdert of opnieuw als #, machine markeert.
cargo test -p mdm-app every_catalogcontroleert elke catalogus. Stel MDM_FIT_AUDIT in op een bestand en maak schermafbeeldingen in uw taal (tools\lab\docs-shots.ps1 ... -Lang <code>) om te zien of uw teksten passen: alle teksten die buiten hun venster vallen of over een ander venster heen lopen, worden vermeld. Zie Talen voor informatie over hoe de talenlijst, het installatieprogramma en de lay-out van rechts naar links op elkaar aansluiten.
Ook de website is beschikbaar in 21 talen en is met machinevertaling vertaald. De teksten staan in i18n/site/<code>.json, één zin per rij: verbeter de "text" van een rij (laat tags zoals <g1>…</g1> en <x2/> ongewijzigd; dit zijn de links en pictogrammen). python tools/website/translate_site.py
--status laat zien wat er in elke taal nog ontbreekt. Met dezelfde tool en --langs <code> wordt alleen dat vertaald.
Problemen melden
Gebruik Help → Een probleem melden in de app. Hiermee opent u het bugrapportformulier, waarin uw versie, systeem, installatiemethode van DDM en taal al zijn ingevuld. Als u het formulier zelf opent, wordt u om dezelfde gegevens gevraagd. Raadpleeg voor beveiligingsproblemen SECURITY.md.
Pull-aanvragen worden geaccepteerd onder de projectlicentie: de GNU GPL, versie 3 of hoger.