1. خانه
  2. راهنما
  3. گزارش‌های خرابی

گزارش‌های خرابی

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.

پنجره گزارش خرابی پس از آن‌که MDM پاسخ‌گویی را متوقف کرد

آنچه می‌بینید

  • 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.

در پنجره:

  1. هنگام وقوع این مشکل چه کاری انجام می‌دادید؟ اختیاری است. نوشتن چند کلمه، مانند «من گزینه افزودن URL را باز کردم»، بسیار کمک می‌کند.
  2. گزارش هر آنچه را که ارسال می‌شود نشان می‌دهد. اگر دوست دارید، ابتدا آن را بخوانید.
  3. ارسال در GitHub فرم گزارش خرابی در GitHub را که از قبل پر شده است، همراه با پوشه حاوی گزارش، در مرورگرتان باز می‌کند. فایل گزارش را به فرم بکشید، آن را بررسی کنید و فرم را ارسال کنید. برای این کار به حساب GitHub نیاز دارید. هیچ چیزی به‌طور خودکار ارسال نمی‌شود.
  4. اگر کسی قبلا همان مشکل را گزارش کرده باشد، پنجره این موضوع را اعلام می‌کند (قبلا به عنوان مشکل #… گزارش شده است). باز کردن مشکل گزارش‌شده آن را باز می‌کند و گزارش شما را در کلیپ‌بورد قرار می‌دهد، بنابراین می‌توانید آن را به عنوان یک نظر اضافه کنید.

دکمه‌های دیگر گزارش را کپی می‌کنند، پوشه آن را باز می‌کنند یا MDM را دوباره راه‌اندازی می‌کنند.

یک گزارش شامل چه چیزهایی است

  • چه اتفاقی افتاد: خطا و مکانی در کد MDM که در آن اتفاق افتاد.
  • پشته: مکانی در کد MDM که در آن از کار افتاد یا متوقف شد، و هر بخش دیگر از آن چه کاری انجام می‌داد.
  • گزارش اخیر MDM: برای مثال، «دستور AddUrl» یا «پنجره باز شد: add-url».
  • سیستم: نسخه MDM و روش نصب آن، سیستم‌عامل و نسخه آن، پردازنده، زبان و پوسته، و تعداد بارگیری‌ها و صف‌ها. این‌ها فقط تعداد هستند.

این گزارش شامل موارد زیر نیست:

  • آدرس‌های دانلود یا نام فایل‌های شما؛
  • نام کاربری شما، که به صورت ~ در مسیرهای پوشه نمایش داده می‌شود.

اگر یک پیام خطا چیزی را که شما تایپ کرده‌اید نقل قول کند، آن متن در گزارش موجود است، بنابراین قبل از ارسال آن را بخوانید.

فایل داده‌های خرابی (.dmp) تصویری از آنچه MDM در آن لحظه در حال اجرا داشت است. این فایل بیشترین کمک را به توسعه‌دهندگان می‌کند، اما ممکن است بخش‌هایی از اطلاعات موجود در حافظه MDM، مانند نشانی‌های بارگیری، کوکی‌ها و گذرواژه‌های ذخیره‌شده را در بر داشته باشد. این فایل فقط وقتی پیوست می‌شود که گزینه پیوست کردن داده‌های خرابی نیز را علامت بزنید.

محل نگهداری گزارش‌ها

در پوشه داده‌های MDM:

  • crashes\: هر گزارش (.txt) و داده خرابی آن (.dmp)؛
  • logs\: گزارش MDM (mdm.log؛ گزارش‌های قدیمی‌تر با نام‌های mdm.1.log و به همین ترتیب، هرکدام 2 MB).

پوشه داده‌های MDM در Windows، %APPDATA%\mattdownloadmanager، در macOS، ~/Library/Application Support/mattdownloadmanager، و در Linux، ~/.local/share/mattdownloadmanager است. در حالت قابل حمل، این پوشه 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 موزیلا می‌خواند. اگر نمادهای 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 into MisterDownloadManager-<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's dump_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