Якщо Dannex Download Manager неочікувано закривається або перестає відповідати, відкривається вікно звіту про збої. Воно показує, що сталося, дозволяє прочитати весь звіт і може надіслати його розробникам на GitHub. Кожен звіт допомагає виправити проблему для всіх.

Що ви бачите
- Dannex Download Manager неочікувано закрився: DDM аварійно завершив роботу або зіткнувся з внутрішньою помилкою та закрився.
- Dannex Download Manager перестав відповідати: його вікно не відповідало протягом 8 секунд. DDM все ще працює, але завис. Завершити та перезапустити DDM закриває завислу копію та запускає нову. Якщо DDM знову відповідає самостійно, вікно повідомляє про це.
У вікні:
- Що ви робили, коли це сталося? є необов'язковим. Кілька слів, наприклад «Я відкрив Додати URL-адресу», дуже допомагають.
- Звіт показує все, що буде надіслано. Прочитайте його спочатку, якщо бажаєте.
- Надіслати на GitHub відкриває у вашому браузері форму Звіт про збій на GitHub, вже заповнену, разом із папкою, що містить звіт. Перетягніть файл звіту у форму, перевірте його та надішліть. Вам потрібен обліковий запис GitHub. Нічого не надсилається самостійно.
- Якщо хтось вже повідомив про ту саму проблему, вікно повідомляє про це (Вже повідомлено як проблема #…). Відкрити повідомлену проблему відкриває її та поміщає ваш звіт у буфер обміну, щоб ви могли додати його як коментар.
Інші кнопки копіюють звіт, відкривають його папку або знову запускають DDM.
Що містить звіт
- Що сталося: помилка та місце в коді DDM, де вона сталася.
- Стек: місце в коді DDM, де він аварійно завершив роботу або завис, і що робила кожна інша його частина.
- Останній журнал DDM: наприклад, «команда AddUrl» або «вікно відкрито: add-url».
- Система: версія DDM та спосіб його встановлення, ваша операційна система та її версія, процесор, мова та тема, а також кількість завантажень та черг, які ви маєте. Це лише підрахунки.
Він не містить:
- ваші адреси завантажень або імена файлів;
- ваше ім'я користувача, яке відображається як
~у шляхах до папок.
Якщо повідомлення про помилку цитує щось, що ви ввели, цей текст міститься у звіті, тому прочитайте його перед надсиланням.
Файл даних про збій (.dmp) – це знімок того, що виконував DDM у той момент. Він найбільше допомагає розробникам, але може містити фрагменти того, що DDM мав у пам’яті, наприклад, адреси завантажень, файли cookie та збережені паролі. Він додається лише тоді, коли ви поставите прапорець Також додати дані про збій.
Де зберігаються звіти
У папці даних DDM:
crashes\: кожен звіт (.txt) та його дані про збій (.dmp);logs\: журнал DDM (mdm.log, зі старішими якmdm.1.logтощо, по 2 МБ кожен).
Папка даних DDM знаходиться за адресою %APPDATA%\dannexdownloadmanager у Windows, ~/Library/Application Support/dannexdownloadmanager у macOS та ~/.local/share/dannexdownloadmanager у Linux. У портативному режимі це папка data поруч із програмою.
Журнал записує дії DDM, тому звіт може показати, що призвело до проблеми. Щоб реєструвати більше деталей, запустіть DDM зі змінною середовища MDM_LOG=debug.
Для розробників
Як це працює: друга копія DDM, монітор, запускається поруч із нею за допомогою --crash-monitor. Код збою знаходиться в crates/crash та crates/app/src/crash.rs.
- Виявлення проблем. Коли DDM аварійно завершує роботу (виняток Windows, сигнал на Linux, виняток Mach на macOS), панікує або зависає, він запитує дамп у монітора. Зависання — це кадр вікна, що виконується понад 8 с, виявлений потоком-сторожем, який ігнорує час, проведений у режимі сну. Він вимірює обидві частини кадру: те, що обробляє DDM (вхідні команди, годинник завантажень, черги та Планувальник), що також працює у згорнутому вигляді, і малювання; ніколи не чекає між кадрами. Сторожовий потік також вимірює, скільки часу процесора отримав потік вікна тим часом, і звіт показує, що це означає: він працював весь час (цикл), він чекав у блокуванні або на вхід/вихід (взаємне блокування), або він майже не працював у звичайному коді, що означає, що комп’ютер занадто зайнятий для запуску DDM або повільно завантажує його з диска, швидше за все, це не помилка DDM (вони мають одну сигнатуру,
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 dannexdownloadmanager::winui::combo_edit) однаковий у звітах про ту саму проблему, і вікно шукає за ним наявні проблеми. - Символи. Збірки випуску містять таблиці рядків (
debug = "line-tables-only"), але до жодного завантаження не входить налагоджувальна інформація. CI перетворює її наDannexDownloadManager-<version>-symbols-<platform>.zip(tools/installer/symbols.py, використовуючиdump_symsвід Mozilla) і публікує поруч з іншими файлами випуску. Коли в стеку відображаються лише адреси, вікно звіту завантажує ZIP-архів для своєї версії. .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