Configuração
Precisa do Windows 10 ou 11 e do Rust estável 1.98 ou posterior (o conjunto de ferramentas MSVC), e do CMake, LLVM e NASM para o BoringSSL, que o motor de ligação tipo navegador compila a partir do código-fonte (winget install Kitware.CMake LLVM.LLVM NASM.NASM).
cargo build
cargo run -p mdm-app
Para experimentar as alterações sem tocar nas suas próprias transferências, dê à aplicação uma pasta de dados separada:
set MDM_DATA_DIR=C:\some\empty\folder
cargo run -p mdm-app
cargo run -p mdm-labserver -- --faults "rate=2M"inicia um servidor de teste local que disponibiliza ficheiros gerados com os problemas que indicar (ligações lentas, interrupções, respostas de servidor ocupado, sem suporte para intervalos; GET / apresenta a lista), para que as transferências possam ser testadas sem ligação à Internet.
Antes de abrir um pedido de "pull"
Estas são as verificações que o CI executa; cada uma funciona num clone limpo:
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
Mantenha as alterações focadas e alinhadas com o código à sua volta. Algumas regras aplicam-se em todo o lado:
- "Clean room" (Sala limpa). O DDM não contém código, binários, arte, ícones, sons ou texto do Internet Download Manager ou de qualquer outro gestor de transferências. Nunca desmonte, descompile ou corrija outro programa, e nunca contorne o licenciamento de ninguém. Consulte Not a reverse-engineering project.
- Todo o texto apresentado ao utilizador passa por
crate::i18n(t,tc,tn,fmt); depois de adicionar um, executepython tools/i18n/extract.py. Os dados inseridos numa frase (um nome de ficheiro, um endereço, um tamanho) são adicionados através dei18n::ltroui18n::isolate, para que sejam apresentados corretamente em idiomas escritos da direita para a esquerda. - As chamadas específicas do Windows estão em
crates/app/src/win32.rse as respetivas versões para Linux e macOS emunix.rs; o resto do espaço de trabalho é escrito em Rust seguro e portátil (unsafe_code = "deny"). No Windows,tools\dev\check-cross.ps1verifica se o programa continua a compilar para Linux e macOS. - Corrija as causas, não os casos, e mantenha sincronizados os produtores e consumidores de dados partilhados (a lista de transferências, as mensagens da extensão do navegador e os catálogos).
Traduções
A interface está disponível em todos os idiomas que o Windows 11 oferece. Os catálogos em i18n/ foram traduzidos automaticamente, e cada linha marcada com #, machine aguarda a revisão de um falante nativo:
- Abra
i18n/<code>.tsv(os códigos estão emi18n/languages.tsv). - Corrija a tradução na terceira coluna da linha e elimine a sua linha
#, machine. - Mantenha
{placeholders}e o&(a letra do atalho de teclado) como estão.
A partir daí, a linha sem a respetiva linha #, machine fica a seu cargo: tools/i18n/translate.py nunca mais a envia para tradução automática, e o CI (tools/i18n/reviewed_guard.py) rejeita qualquer pedido de integração que a elimine ou volte a marcá-la como #, machine.
cargo test -p mdm-app every_catalogverifica todos os catálogos. Para verificar se os seus textos cabem, defina MDM_FIT_AUDIT como um ficheiro e faça as capturas de ecrã no seu idioma (tools\lab\docs-shots.ps1 ... -Lang <code>): aí são listados todos os textos que ultrapassam os limites da respetiva janela ou se sobrepõem a outra janela. Consulte Languages para saber como se articulam a lista de idiomas, o instalador e a disposição da direita para a esquerda.
O site também está disponível em 21 idiomas e foi traduzido automaticamente. Os textos estão em i18n/site/<code>.json, uma linha por frase: corrija a tradução de uma linha ("text"), mantendo as etiquetas como <g1>…</g1> e <x2/> tal como estão, pois correspondem a ligações e ícones. python tools/website/translate_site.py
--status mostra o que ainda falta em cada idioma, e a mesma ferramenta com --langs <code> traduz apenas o que falta.
Comunicar problemas
Use Ajuda → Comunicar um problema na aplicação para abrir o formulário de comunicação de erros, que inclui a sua versão, o sistema, a forma como o DDM foi instalado e o idioma. O formulário pede as mesmas informações se o abrir manualmente. Para problemas de segurança, consulte SECURITY.md.
Os pedidos de integração são aceites ao abrigo da licença do projeto, a GNU GPL, versão 3 ou posterior.