ساهم في Mister Download Manager

البدء

تحتاج إلى Windows 10 أو 11 و Rust stable 1.95 أو أحدث (سلسلة أدوات MSVC).

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

اجعل التغييرات مركزة وتطابق الكود المحيط بها. بعض القواعد تنطبق في كل مكان:

• بيئة نظيفة. لا يحتوي MDM على أي تعليمات برمجية أو ملفات تنفيذية أو رسومات أو أيقونات أو أصوات أو نصوص من 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 ينتظر متحدثا أصليا للغة:

1. افتح i18n/<code>.tsv (الرموز موجودة في i18n/languages.tsv).
2. صحح الترجمة في العمود الثالث من الصف واحذف سطر #, machine الخاص به.
3. حافظ على {placeholders} و & (حرف اختصار لوحة المفاتيح) كما هما.

cargo test -p mdm-app every_catalogيتحقق من كل كتالوج. لمعرفة ما إذا كانت نصوصك مناسبة، اضبط MDM_FIT_AUDIT على ملف والتقط لقطات الشاشة بلغتك (tools\lab\docs-shots.ps1 ... -Lang <code>): كل نص يتجاوز نافذته أو يتداخل مع نافذة أخرى يتم إدراجه هناك. انظر اللغات لمعرفة كيفية توافق قائمة اللغات والمثبت والتخطيط من اليمين إلى اليسار.

الموقع الإلكتروني متوفر بـ 20 لغة أيضا، ومترجم آليا. نصوصه موجودة في i18n/site/<code>.json، كل سطر يمثل جملة: قم بتصحيح "text" في السطر (حافظ على الوسوم مثل <g1>…</g1> و <x2/> كما هي، فهي تمثل الروابط والأيقونات). python tools/website/translate_site.py --status يوضح ما ينقص كل لغة، ونفس الأداة مع --langs <code> تترجم ذلك فقط.

الإبلاغ عن المشاكل

استخدم تعليمات ← الإبلاغ عن مشكلة في التطبيق: يفتح نموذج الإبلاغ عن الأخطاء مع ملء إصدارك ونظامك وكيفية تثبيت MDM ولغته. يطلب النموذج نفس الشيء عندما تفتحه بنفسك. مشاكل الأمان: انظر SECURITY.md.

يتم قبول طلبات السحب بموجب ترخيص المشروع، GNU GPL، الإصدار 3 أو أحدث.