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

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

اگر Dannex Download Manager به‌طور غیرمنتظره بسته شود یا از پاسخگویی بازبماند، پنجره گزارش خرابی باز می‌شود. این پنجره اتفاقی را که افتاده نشان می‌دهد، امکان خواندن گزارش کامل را فراهم می‌کند و می‌توانید گزارش را برای توسعه‌دهندگان در GitHub بفرستید. هر گزارش به رفع مشکل برای همه کمک می‌کند.

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

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

  • Dannex Download Manager به طور غیرمنتظره بسته شد: DDM از کار افتاد یا با خطای داخلی روبه‌رو شد و بسته شد.
  • Dannex Download Manager از پاسخگویی متوقف شد: پنجره آن به مدت 8 ثانیه پاسخ نداد. DDM هنوز در حال اجرا است، اما متوقف شده است. پایان و راه‌اندازی مجدد DDM نسخه متوقف شده را می‌بندد و یک نسخه جدید را راه‌اندازی می‌کند. اگر DDM خودش دوباره پاسخ دهد، پنجره این موضوع را اعلام می‌کند.

در پنجره:

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

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

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

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

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

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

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

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

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

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

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

پوشه داده‌های DDM در Windows، %APPDATA%\dannexdownloadmanager، در macOS، ~/Library/Application Support/dannexdownloadmanager، و در Linux، ~/.local/share/dannexdownloadmanager است. در حالت قابل حمل، این پوشه data در کنار برنامه است.

گزارش آنچه را که DDM انجام می‌دهد ثبت می‌کند، بنابراین یک گزارش می‌تواند نشان دهد که چه چیزی منجر به مشکل شده است. برای ثبت جزئیات بیشتر، DDM را با متغیر محیطی MDM_LOG=debug راه‌اندازی کنید.

برای توسعه‌دهندگان

نحوه کار: نسخه دومی از DDM، یعنی ناظر، با --crash-monitor در کنار آن اجرا می‌شود. کد مربوط به خرابی در crates/crash و crates/app/src/crash.rs قرار دارد.

  • گزارش مشکلات. وقتی DDM از کار می‌افتد (یک استثنای Windows، یک سیگنال در Linux، یک استثنای Mach در macOS)، دچار وحشت می‌شود یا از حرکت بازمی‌ایستد، از مانیتور یک دامپ درخواست می‌کند. از کار افتادن به معنای فریم پنجره‌ای است که بیش از 8 ثانیه اجرا می‌شود و توسط یک رشته نگهبان که زمان خواب را نادیده می‌گیرد، مشاهده می‌شود. این رشته هر دو بخش یک فریم را زمان‌بندی می‌کند: آنچه DDM مدیریت می‌کند (دستورات ورودی، ساعت بارگیری‌ها، صف‌ها و زمان‌بند)، که در حالت کوچک‌شده نیز اجرا می‌شود، و ترسیم؛ هرگز انتظار بین فریم‌ها را زمان‌بندی نمی‌کند. نگهبان همچنین اندازه‌گیری می‌کند که رشته پنجره در این مدت چقدر زمان پردازنده دریافت کرده است، و گزارش می‌گوید که این به چه معناست: تمام مدت اجرا شده (یک حلقه)، در یک قفل یا در I/O منتظر مانده (یک بن‌بست)، یا به سختی در کد عادی اجرا شده است، که به احتمال زیاد به دلیل مشغول بودن بیش از حد رایانه برای اجرای DDM یا کندی در بارگیری آن از دیسک است و اشکال از DDM نیست (این موارد یک امضا دارند، 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 dannexdownloadmanager::winui::combo_edit) در گزارش‌های مربوط به یک مشکل ثابت می‌ماند و پنجره، مسئله‌های موجود را برای یافتن آن جست‌وجو می‌کند.
  • نمادها. نسخه‌های منتشرشده جدول‌های خط (debug = "line-tables-only") را نگه می‌دارند، اما هیچ بارگیری‌ای شامل اطلاعات اشکال‌زدایی نیست. CI آن را به DannexDownloadManager-<version>-symbols-<platform>.zip (tools/installer/symbols.py، با استفاده از dump_syms موزیلا) تبدیل می‌کند و در کنار سایر فایل‌های نسخه منتشرشده قرار می‌دهد. وقتی پشته فراخوانی فقط نشانی‌های خام را نشان می‌دهد، پنجره گزارش فایل فشرده مربوط به نسخه خود را دریافت می‌کند.
  • .dmp از یک مسئله:

cargo run -p mdm-crash --bin mdm-symbolicate -- crash.dmp DannexDownloadManager-<version>-symbols-windows-x64.zip

  • آزمایش آن. cargo test -p mdm-crash یک انجماد، خطای بحرانی و ازکارافتادگی واقعی (examples/crashy.rs) را اجرا می‌کند و امضای هر گزارش را بررسی می‌کند. برای آزمایش آن در برنامه، DDM را با MDM_CRASH_TEST=1 راه‌اندازی کنید، سپس dannexdownloadmanager /show crash-test:freeze (بن‌بست؛ یا spin، 12 ثانیه مشغول‌بودن رشته پنجره، panic، crash، abort) را اجرا کنید. cargo test -p mdm-app --test freeze_report -- --ignored این کار را در یک نسخه کپی‌شده از برنامه که خارج از صفحه‌نمایش است انجام می‌دهد؛ پنجره آن دیده می‌شود و کوچک‌شده است.

رایگان، متن‌باز، بدون تبلیغات، بدون دوره آزمایشی.

بارگیری Dannex Download Manager