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 คือ %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 snapshot macOS ยังไม่ได้วัดค่านี้ มอนิเตอร์จะเขียน มินิดัมพ์ ของทุกเธรดจากภายนอก ผ่าน 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