- Strona główna
- Współpraca
Współtwórz Dannex Download Manager
Zgłoszenia błędów, pomysły, poprawki tłumaczeń i propozycje zmian w kodzie są mile widziane. Wszystko odbywa się publicznie na GitHub.
Przygotowanie środowiska
Potrzebujesz systemu Windows 10 lub 11 i stabilnej wersji Rust 1.98 lub nowszej (zestaw narzędzi MSVC), a także CMake, LLVM i NASM dla BoringSSL, które silnik kompiluje ze źródeł w celu nawiązania połączenia podobnego do przeglądarki (winget install Kitware.CMake LLVM.LLVM NASM.NASM).
cargo build
cargo run -p mdm-app
Aby wypróbować zmiany bez ingerowania w pobrane pliki, przypisz aplikacji osobny folder danych:
set MDM_DATA_DIR=C:\some\empty\folder
cargo run -p mdm-app
cargo run -p mdm-labserver -- --faults "rate=2M"uruchamia lokalny serwer testowy, który udostępnia wygenerowane pliki z wybranymi przez Ciebie problemami (wolne połączenia, przerwane połączenia, odpowiedzi „zajęte”, brak obsługi zakresów; GET / wyświetla ich listę), dzięki czemu można testować pobieranie bez dostępu do internetu.
Zanim utworzysz propozycję zmian
Oto testy uruchamiane przez CI. Każdy z nich działa na czystej kopii repozytorium:
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
Wprowadzaj zmiany w konkretnym obszarze i dostosuj je do otaczającego kodu. Wszędzie obowiązuje kilka zasad:
- Czyste środowisko. DDM nie zawiera kodu, plików binarnych, grafik, ikon, dźwięków ani tekstów pochodzących z Internet Download Manager ani żadnego innego menedżera pobierania. Nigdy nie rozkładaj innego programu na części, nie dekompiluj go ani nie modyfikuj i nie obchodź warunków licencji. Zobacz To nie jest projekt inżynierii wstecznej.
- Każdy tekst wyświetlany użytkownikowi musi przechodzić przez
crate::i18n(t,tc,tn,fmt); po dodaniu tekstu uruchompython tools/i18n/extract.py. Dane w zdaniu (nazwa pliku, adres, rozmiar) dodawaj za pomocąi18n::ltrlubi18n::isolate, aby tekst był poprawnie wyświetlany w językach pisanych od prawej do lewej. - Wywołania dostępne tylko w systemie Windows znajdują się w
crates/app/src/win32.rs, a ich odpowiedniki dla systemów Linux i macOS wunix.rs; pozostała część obszaru roboczego zawiera bezpieczny, przenośny kod Rust (unsafe_code = "deny"). W systemie Windowstools\dev\check-cross.ps1sprawdza, czy kod nadal się kompiluje dla systemów Linux i macOS. - Naprawiaj przyczyny, nie pojedyncze przypadki, a producentów i odbiorców wspólnych danych (listy pobierania, komunikatów rozszerzenia przeglądarki, katalogów) utrzymuj w zgodzie.
Tłumaczenia
Interfejs jest dostępny w każdym języku oferowanym przez Windows 11. Katalogi w i18n/ przetłumaczono maszynowo, a każdy wiersz oznaczony #, machine czeka na sprawdzenie przez native speakera:
- Otwórz
i18n/<code>.tsv(kody znajdują się wi18n/languages.tsv). - Popraw tłumaczenie w trzeciej kolumnie wiersza i usuń wiersz
#, machine. - Zachowaj
{placeholders}i jedną literę&(skrót klawiaturowy) bez zmian.
Od tej pory wiersz bez wiersza #, machine należy do Ciebie: tools/i18n/translate.py nie wyśle go ponownie do tłumaczenia maszynowego, a CI (tools/i18n/reviewed_guard.py) odrzuci każdą propozycję zmian, która go usunie lub ponownie oznaczy jako #, machine.
cargo test -p mdm-app every_catalogsprawdza każdy katalog. Aby sprawdzić, czy teksty mieszczą się w interfejsie, ustaw MDM_FIT_AUDIT na plik i wykonaj zrzuty ekranu w swoim języku (tools\lab\docs-shots.ps1 ... -Lang <code>): wyświetlana jest tam lista tekstów, które wychodzą poza okno lub nachodzą na inne elementy. Zobacz Języki, aby dowiedzieć się, jak współdziałają lista języków, instalator i układ od prawej do lewej.
Strona internetowa jest również dostępna w 21 językach i także została przetłumaczona maszynowo. Teksty znajdują się w i18n/site/<code>.json, po jednym zdaniu w wierszu: popraw tłumaczenie w wierszu ("text") i pozostaw tagi takie jak <g1>…</g1> i <x2/> bez zmian — to linki i ikony. python tools/website/translate_site.py
--status pokazuje, czego brakuje w każdym języku, a to samo narzędzie z --langs <code> tłumaczy tylko brakujące teksty.
Zgłaszanie problemów
W aplikacji wybierz Pomoc → Zgłoś problem, aby otworzyć formularz zgłoszenia błędu z uzupełnionymi informacjami o wersji, systemie, sposobie instalacji DDM i języku aplikacji. Formularz prosi o te same informacje, jeśli otworzysz go samodzielnie. Problemy z bezpieczeństwem zgłaszaj zgodnie z instrukcjami w pliku SECURITY.md.
Propozycje zmian są przyjmowane na warunkach licencji projektu: GNU GPL, wersja 3 lub nowsza.