หาก 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 เก็บไว้ในหน่วยความจำ เช่น ที่อยู่ดาวน์โหลด คุกกี้ และรหัสผ่านที่บันทึกไว้ ไฟล์นี้จะแนบมาด้วยเมื่อคุณเลือก แนบข้อมูลข้อขัดข้องด้วย เท่านั้น
รายงานถูกเก็บไว้ที่ไหน
ในโฟลเดอร์ข้อมูลของ DDM:
crashes\: แต่ละรายงาน (.txt) และข้อมูลข้อขัดข้อง (.dmp);logs\: บันทึกเหตุการณ์ของ DDM (mdm.logโดยมีไฟล์เก่ากว่าเป็นmdm.1.logเป็นต้น ขนาด 2 MB ต่อไฟล์)
โฟลเดอร์ข้อมูลของ 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 จัดการ (คำสั่งที่เข้ามา, นาฬิกาของการดาวน์โหลด, คิว และตัวจัดกำหนดการ) ซึ่งทำงานแบบย่อหน้าต่างด้วย และการวาดภาพ; ไม่นับรวมเวลารอระหว่างเฟรม เธรดเฝ้าระวังยังวัดว่าเธรดหน้าต่างใช้เวลาประมวลผลไปเท่าใด และรายงานจะบอกความหมายของสิ่งนั้น: ทำงานตลอดเวลา (วนซ้ำ), รออยู่ในล็อกหรือ I/O (การติดตาย), หรือแทบไม่ได้ทำงานในโค้ดปกติ ซึ่งหมายถึงคอมพิวเตอร์ยุ่งเกินไปที่จะรัน DDM หรือโหลดจากดิสก์ช้า ซึ่งส่วนใหญ่ไม่ใช่ข้อผิดพลาดของ DDM (สิ่งเหล่านี้มีลายเซ็นเดียวกัน
freeze while the computer was busy) เมื่อเธรดหน้าต่างกลับมาอยู่ในลูปเหตุการณ์แล้วในขณะที่เขียนไฟล์ดัมพ์ การค้างได้สิ้นสุดลงก่อนที่จะมีการบันทึกภาพ ดังนั้นสแต็กจึงไม่สามารถอธิบายได้; รายงานเหล่านั้นจะระบุเช่นนั้นและมีลายเซ็นfreeze over before the snapshotmacOS ยังไม่ได้วัดค่านี้ มอนิเตอร์จะเขียน มินิดัมพ์ ของทุกเธรดจากภายนอก ผ่านminidumperและcrash-handlerกระบวนการที่หยุดทำงานจะไม่เขียนไฟล์ดัมพ์ของตัวเอง ซึ่งเป็นวิธีที่ Firefox, Crashpad และ Sentry ทำเช่นกัน - การอ่านไฟล์ดัมพ์ มอนิเตอร์จะอ่านไฟล์ดัมพ์ด้วย
rust-minidumpของ Mozilla โดยจะใช้สัญลักษณ์ Breakpad ของรุ่นเมื่อพบ การสร้างจากซอร์สโค้ดสามารถอ่านข้อมูลดีบักแบบเนทีฟที่อยู่ข้างๆ ได้ด้วย (เช่น.pdb, DWARF) เมื่อสร้างด้วย--features mdm-crash/native-symbols; แอปที่จัดส่งจะไม่มีตัวอ่านนั้น ซึ่งมีขนาดหลาย MB ลายเซ็นของรายงาน (เช่น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จำลองการค้าง การหยุดทำงานแบบ panic และการขัดข้องจริง (examples/crashy.rs) แล้วตรวจสอบลายเซ็นของแต่ละรายงาน หากต้องการลองในแอป ให้เริ่ม DDM ด้วยMDM_CRASH_TEST=1แล้วเรียกใช้dannexdownloadmanager /show crash-test:freeze(deadlock; หรือspinซึ่งทำให้เธรดหน้าต่างทำงานเต็มที่เป็นเวลา 12 วินาที,panic,crash,abort)cargo test -p mdm-app --test freeze_report -- --ignoredทำเช่นนั้นกับสำเนาของแอปที่อยู่นอกหน้าจอ โดยแสดงหน้าต่างไว้และย่อหน้าต่างลง
ฟรี, โอเพนซอร์ส, ไม่มีโฆษณา, ไม่มีช่วงทดลองใช้
ดาวน์โหลด Dannex Download Manager