If Matt Download Manager closes unexpectedly or stops responding, a crash report window opens. It shows what happened, lets you read the whole report, and can send it to the developers on GitHub. Each report helps fix the problem for everyone.

ما تراه
- Matt Download Manager closed unexpectedly: MDM crashed, or hit an internal error and closed.
- Matt Download Manager stopped responding: its window didn't answer for 8 seconds. MDM is still running, frozen. End and restart MDM closes the frozen copy and starts a new one. If MDM answers again by itself, the window says so.
في النافذة:
- ماذا كنت تفعل عندما حدث ذلك؟ هذا اختياري. بضع كلمات، مثل "فتحت إضافة URL"، تساعد كثيرا.
- التقرير يعرض كل ما سيتم إرساله. اقرأه أولا إذا أردت.
- إرسال على GitHub يفتح نموذج تقرير الأعطال الخاص بـ GitHub في متصفحك، وهو مملوء مسبقا، بالإضافة إلى المجلد الذي يحتوي على التقرير. اسحب ملف التقرير إلى النموذج، وتحقق منه، ثم أرسله. تحتاج إلى حساب GitHub. لا يتم إرسال أي شيء تلقائيا.
- إذا كان شخص ما قد أبلغ بالفعل عن نفس المشكلة، فإن النافذة تخبرك بذلك (تم الإبلاغ عنه بالفعل كمشكلة #…). فتح المشكلة المبلغ عنها يفتحها ويضع تقريرك في الحافظة، حتى تتمكن من إضافته كتعليق.
الأزرار الأخرى تنسخ التقرير، أو تفتح مجلده، أو تبدأ MDM مرة أخرى.
ما يحتويه التقرير
- ما حدث: الخطأ والمكان في كود MDM حيث حدث.
- المكدس: المكان في كود MDM حيث تعطل أو تجمد، وما كانت تفعله كل الأجزاء الأخرى منه.
- سجل MDM الأخير: على سبيل المثال "الأمر AddUrl" أو "النافذة المفتوحة: add-url".
- النظام: إصدار MDM وكيف قمت بتثبيته، نظام التشغيل الخاص بك وإصداره، المعالج، اللغة والمظهر، وعدد التنزيلات وقوائم الانتظار لديك. هذه مجرد أعداد.
لا يحتوي على:
- عناوين التنزيل أو أسماء الملفات الخاصة بك؛
- اسم المستخدم الخاص بك، والذي يظهر كـ
~في مسارات المجلدات.
إذا كانت رسالة الخطأ تقتبس شيئا كتبته، فإن هذا النص موجود في التقرير، لذا اقرأه قبل الإرسال.
ملف بيانات التعطل (.dmp) هو لقطة لما كان MDM يقوم بتشغيله في تلك اللحظة. إنه يساعد المطورين أكثر، ولكنه قد يحتوي على أجزاء مما كان MDM يحتفظ به في الذاكرة، مثل عناوين التنزيل وملفات تعريف الارتباط وكلمات المرور المحفوظة. يتم إرفاقه فقط عند تحديد إرفاق بيانات التعطل أيضا.
أين يتم الاحتفاظ بالتقارير
في مجلد بيانات MDM:
crashes\: كل تقرير (.txt) وبيانات العطل الخاصة به (.dmp)؛logs\: سجل MDM (mdm.log، مع السجلات الأقدم كـmdm.1.logوهكذا، 2 ميجابايت لكل منها).
مجلد بيانات MDM هو %APPDATA%\mattdownloadmanager على Windows، و ~/Library/Application Support/mattdownloadmanager على macOS، و ~/.local/share/mattdownloadmanager على Linux. في الوضع المحمول، يكون مجلد data بجوار البرنامج.
يسجل السجل ما يفعله MDM، لذلك يمكن أن يظهر التقرير ما أدى إلى مشكلة. لتسجيل المزيد من التفاصيل، ابدأ MDM بمتغير البيئة MDM_LOG=debug.
للمطورين
كيف يعمل: نسخة ثانية من MDM، المراقب، تبدأ بجانبه مع --crash-monitor. كود العطل موجود في crates/crash و crates/app/src/crash.rs.
- اكتشاف المشاكل. عندما يتعطل MDM (استثناء في Windows، إشارة في Linux، استثناء Mach في macOS)، أو يتوقف تماما، أو يتجمد، فإنه يطلب من المراقب تفريغا. التجمد هو إطار للنافذة يعمل لأكثر من 8 ثوان، يراه مؤشر مراقبة يتجاهل الوقت المستغرق في وضع السكون والدقيقة الأولى بعد استيقاظ الكمبيوتر، بينما تعود أقراصه وشبكته وشاشته: يتم بعد ذلك كتابة توقف مؤقت في السجل، ويتم الإبلاغ عنه فقط إذا استمر بعد تلك الدقيقة. يقيس كلا جزأي الإطار: ما يتعامل معه MDM (الأوامر الواردة، ساعة التنزيلات، قوائم الانتظار، و«المجدول»)، والذي يعمل مصغرا أيضا، والرسم؛ ولا يقيس أبدا الانتظار بين الإطارات. يقيس مؤشر المراقبة أيضا مقدار وقت المعالج الذي حصل عليه مؤشر ترابط النافذة في هذه الأثناء، ويذكر التقرير ما يعنيه ذلك: لقد عمل طوال الوقت (حلقة)، أو انتظر في قفل أو على الإدخال/الإخراج (توقف تام)، أو بالكاد عمل في التعليمات البرمجية العادية، وهو ما يعني أن الكمبيوتر مشغول جدا بتشغيل MDM أو بطيء في تحميله من القرص، ومن المرجح أن هذا ليس خطأ في MDM (تتشارك هذه المشاكل توقيعا واحدا،
freeze while the computer was busy). يذكر كل تقرير أيضا ما كان يفعله الإطار عندما توقف (أيقونة علبة النظام، تقدم التنزيلات، رسم النافذة الرئيسية). عندما يعود مؤشر ترابط النافذة بالفعل إلى حلقة الأحداث، أو في التوقف بعد إطار نافذة مخفية، بحلول الوقت الذي يتم فيه كتابة التفريغ، يكون التجمد قد انتهى قبل اللقطة، لذا لا يمكن لمكدسه تفسيره؛ تذكر هذه التقارير ذلك وتتشارك التوقيعfreeze over before the snapshot. لا يقيس macOS ذلك بعد. يقوم المراقب بعد ذلك بكتابة تفريغ مصغر لكل مؤشر ترابط من الخارج، عبرminidumperوcrash-handler. لا يقوم أي عملية متعطلة بكتابة تفريغها الخاص أبدا، وهو ما تفعله Firefox وCrashpad وSentry أيضا. - قراءة ملف التفريغ. يقرأ عارض الأعطال ملف التفريغ باستخدام
rust-minidumpمن Mozilla. ويستخدم رموز Breakpad الخاصة بالإصدار عند توفرها. يمكن للبناء من المصدر أيضا قراءة معلومات التصحيح الأصلية الموجودة بجانبه (ملف.pdbالخاص به، DWARF) عند بنائه باستخدام--features mdm-crash/native-symbols؛ أما التطبيق المنشور فلا يتضمن هذا القارئ، الذي حجمه عدة ميغابايت. تبقى بصمة التقرير (على سبيل المثالfreeze in mattdownloadmanager::winui::combo_edit) كما هي في تقارير المشكلة نفسها، وتبحث النافذة عن المشكلات الموجودة باستخدامها. - Symbols. Release builds keep line tables (
debug = "line-tables-only"), but no download includes the debug info. CI turns it intoMisterDownloadManager-<version>-symbols-<platform>.zip(one per download that has programs of its own:windows-x64,windows-arm64,windows-x86,linux-x86_64,linux-arm64,macos-arm64,macos-x86_64) (tools/installer/symbols.py, using Mozilla'sdump_syms), published beside the release's other files. The report window fetches the zip for its own version when a stack shows bare addresses. - مقتطف
.dmpمن مشكلة:
cargo run -p mdm-crash --bin mdm-symbolicate -- crash.dmp MisterDownloadManager-<version>-symbols-windows-x64.zip
- اختبارها. يشغل
cargo test -p mdm-crashتجمدا حقيقيا، وحالة هلع، وتعطلا (examples/crashy.rs)، ويتحقق من بصمة كل تقرير. لتجربتها في التطبيق، ابدأ MDM باستخدامMDM_CRASH_TEST=1، ثم شغلmattdownloadmanager /show crash-test:freeze(حالة توقف تام؛ أوspin، 12 ثانية من انشغال خيط تنفيذ النافذة،panic،crash،abort). ينفذcargo test -p mdm-app --test freeze_report -- --ignoredذلك في نسخة من التطبيق خارج الشاشة، مع ظهور نافذتها وهي مصغرة.
مجاني، مفتوح المصدر، بدون إعلانات، بدون فترة تجريبية.
تنزيل Matt Download Manager