Laporan kerusakan

Jika Mister Download Manager ditutup secara tidak terduga atau berhenti merespons, jendela laporan kerusakan akan terbuka. Jendela ini menunjukkan apa yang terjadi, memungkinkan Anda membaca seluruh laporan, dan dapat mengirimkannya ke pengembang di GitHub. Setiap laporan membantu memperbaiki masalah untuk semua orang.

Apa yang Anda lihat

• Mister Download Manager ditutup secara tidak terduga: MDM mengalami kerusakan, atau mengalami kesalahan internal dan tertutup.
• Mister Download Manager berhenti merespons: jendelanya tidak merespons selama 8 detik. MDM masih berjalan, membeku. Akhiri dan mulai ulang MDM menutup salinan yang membeku dan memulai yang baru. Jika MDM merespons lagi dengan sendirinya, jendela akan mengatakannya.

Di jendela:

1. Apa yang Anda lakukan saat itu terjadi? bersifat opsional. Beberapa kata, seperti "Saya membuka Tambah URL", sangat membantu.
2. Laporan menunjukkan semua yang akan dikirim. Bacalah terlebih dahulu jika Anda mau.
3. Kirim di GitHub membuka formulir Laporan kerusakan GitHub di browser Anda, yang sudah terisi, bersama dengan folder yang berisi laporan. Seret file laporan ke dalam formulir, periksa, dan kirim. Anda memerlukan akun GitHub. Tidak ada yang dikirim dengan sendirinya.
4. Jika seseorang sudah melaporkan masalah yang sama, jendela akan mengatakannya (Sudah dilaporkan sebagai masalah #…). Buka masalah yang dilaporkan membukanya dan menempatkan laporan Anda di papan klip, sehingga Anda dapat menambahkannya sebagai komentar.

Tombol lainnya menyalin laporan, membuka foldernya, atau memulai MDM lagi.

Apa yang terkandung dalam laporan

• Apa yang terjadi: kesalahan dan tempat dalam kode MDM di mana itu terjadi.
• Tumpukan: tempat dalam kode MDM di mana ia mengalami kerusakan atau membeku, dan apa yang dilakukan setiap bagian lainnya.
• Log terbaru MDM: misalnya "perintah AddUrl" atau "jendela dibuka: add-url".
• Sistem: versi MDM dan cara Anda menginstalnya, sistem operasi dan versinya, prosesor, bahasa dan tema, serta berapa banyak unduhan dan antrean yang Anda miliki. Ini hanya hitungan.

Ini tidak berisi:

• alamat unduhan atau nama file Anda;
• nama pengguna Anda, yang ditampilkan sebagai ~ di jalur folder.

Jika pesan kesalahan mengutip sesuatu yang Anda ketik, teks itu ada dalam laporan, jadi bacalah sebelum mengirim.

File data kerusakan (.dmp) adalah cuplikan dari apa yang dijalankan MDM pada saat itu. Ini paling membantu pengembang, tetapi dapat menyimpan bagian-bagian dari apa yang ada di memori MDM, seperti alamat unduhan. Ini hanya dilampirkan ketika Anda mencentang Juga lampirkan data kerusakan.

Tempat laporan disimpan

Di folder data MDM:

• crashes\: setiap laporan (.txt) dan data kerusakannya (.dmp);
• logs\: log MDM (mdm.log, dengan yang lebih lama sebagai mdm.1.log dan seterusnya, masing-masing 2 MB).

Folder data MDM adalah %APPDATA%\misterdownloadmanager di Windows, ~/Library/Application Support/misterdownloadmanager di macOS, dan ~/.local/share/misterdownloadmanager di Linux. Dalam mode portabel itu adalah folder data di samping program.

Log mencatat apa yang dilakukan MDM, sehingga laporan dapat menunjukkan apa yang menyebabkan masalah. Untuk mencatat lebih banyak detail, mulai MDM dengan variabel lingkungan MDM_LOG=debug.

Untuk pengembang

Cara kerjanya: salinan kedua MDM, monitor, dimulai di sampingnya dengan --crash-monitor. Kode kerusakan berada di crates/crash dan crates/app/src/crash.rs.

• Menangkap masalah. Ketika MDM mengalami kerusakan (pengecualian Windows, sinyal di Linux, pengecualian Mach di macOS), panik, atau membeku, ia meminta monitor untuk membuang data. Pembekuan adalah bingkai jendela yang berjalan lebih dari 8 detik, dilihat oleh utas pengawas yang mengabaikan waktu yang dihabiskan untuk tidur. Monitor kemudian menulis minidump dari setiap utas dari luar, melalui minidumper dan crash-handler. Proses yang rusak tidak pernah menulis dump-nya sendiri, yang juga dilakukan oleh Firefox, Crashpad, dan Sentry.
• Membaca dump. Monitor membaca dump dengan rust-minidump milik Mozilla. Ia menggunakan simbol Breakpad rilis jika ditemukan, atau info debug asli di samping build dari sumber. Tanda Tangan laporan (misalnya freeze in misterdownloadmanager::winui::combo_edit) tetap sama di seluruh laporan untuk satu masalah, dan jendela akan mencari masalah yang ada untuk itu.
• Simbol. Build rilis menyimpan tabel baris (debug = "line-tables-only"), tetapi tidak ada unduhan yang menyertakan info debug. CI mengubahnya menjadi MisterDownloadManager-<version>-symbols-<platform>.zip (tools/installer/symbols.py, menggunakan dump_syms milik Mozilla), yang diterbitkan di samping file rilis lainnya. Jendela laporan mengambil zip untuk versinya sendiri ketika tumpukan menunjukkan alamat kosong.
• .dmp dari suatu masalah:

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

• Mengujinya. cargo test -p mdm-crash menjalankan pembekuan, kepanikan, dan crash yang nyata (examples/crashy.rs) dan memeriksa tanda tangan setiap laporan. Untuk mencobanya di aplikasi, mulai MDM dengan MDM_CRASH_TEST=1, lalu jalankan misterdownloadmanager /show crash-test:freeze (atau panic, crash, abort).