Crashrapporten

Als Mister Download Manager onverwachts wordt afgesloten of niet meer reageert, wordt er een venster voor een crashrapport geopend. Het toont wat er is gebeurd, laat u het hele rapport lezen en kan het naar de ontwikkelaars op GitHub sturen. Elk rapport helpt om het probleem voor iedereen op te lossen.

Wat u ziet

• Mister Download Manager is onverwachts afgesloten: MDM is gecrasht, of heeft een interne fout gehad en is afgesloten.
• Mister Download Manager reageert niet meer: het venster reageerde 8 seconden lang niet. MDM draait nog steeds, maar is bevroren. MDM afsluiten en opnieuw starten sluit de bevroren kopie en start een nieuwe. Als MDM vanzelf weer reageert, meldt het venster dat.

In het venster:

1. Wat deed u toen het gebeurde? is optioneel. Een paar woorden, zoals "Ik opende URL toevoegen", helpen enorm.
2. Het rapport toont alles wat zou worden verzonden. Lees het eerst als u wilt.
3. Verzenden op GitHub opent het Crashrapport-formulier van GitHub in uw browser, al ingevuld, samen met de map die het rapport bevat. Sleep het rapportbestand naar het formulier, controleer het en dien het in. U hebt een GitHub-account nodig. Er wordt niets vanzelf verzonden.
4. Als iemand hetzelfde probleem al heeft gemeld, meldt het venster dat (Al gemeld als kwestie #…). De gemelde kwestie openen opent deze en plaatst uw rapport op het klembord, zodat u het als opmerking kunt toevoegen.

De andere knoppen kopiëren het rapport, openen de map ervan of starten MDM opnieuw.

Wat een rapport bevat

• Wat er is gebeurd: de fout en de plaats in de code van MDM waar het gebeurde.
• De stack: de plaats in de code van MDM waar het crashte of bevroor, en wat elk ander onderdeel ervan aan het doen was.
• MDM's recente logboek: bijvoorbeeld "commando URL toevoegen" of "venster geopend: add-url".
• Het systeem: de versie van MDM en hoe u het hebt geïnstalleerd, uw besturingssysteem en de versie ervan, de processor, de taal en het thema, en hoeveel downloads en wachtrijen u hebt. Dit zijn alleen tellingen.

Het bevat niet:

• uw downloadadressen of bestandsnamen;
• uw gebruikersnaam, die wordt weergegeven als ~ in mappaden.

Als een foutmelding iets citeert dat u hebt getypt, staat die tekst in het rapport, dus lees het voordat u het verzendt.

Het crashgegevensbestand (.dmp) is een momentopname van wat MDM op dat moment uitvoerde. Het helpt de ontwikkelaars het meest, maar het kan stukjes bevatten van wat MDM in het geheugen had, zoals downloadadressen. Het wordt alleen bijgevoegd als u Ook de crashgegevens bijvoegen aanvinkt.

Waar rapporten worden bewaard

In de gegevensmap van MDM:

• crashes\: elk rapport (.txt) en de crashgegevens ervan (.dmp);
• logs\: het logboek van MDM (mdm.log, met oudere als mdm.1.log enzovoort, 2 MB elk).

De gegevensmap van MDM is %APPDATA%\misterdownloadmanager op Windows, ~/Library/Application Support/misterdownloadmanager op macOS en ~/.local/share/misterdownloadmanager op Linux. In de draagbare modus is het de data map naast het programma.

Het logboek registreert wat MDM doet, zodat een rapport kan laten zien wat tot een probleem heeft geleid. Om meer details te loggen, start u MDM met de omgevingsvariabele MDM_LOG=debug.

Voor ontwikkelaars

Hoe het werkt: een tweede kopie van MDM, de monitor, start ernaast met --crash-monitor. De crashcode bevindt zich in crates/crash en crates/app/src/crash.rs.

• Problemen opsporen. Wanneer MDM crasht (een Windows-uitzondering, een signaal op Linux, een Mach-uitzondering op macOS), panikeert of bevriest, vraagt het de monitor om een dump. Een bevriezing is een frame van het venster dat langer dan 8 s draait, gezien door een watchdog-thread die de tijd die in slaapstand wordt doorgebracht negeert. De monitor schrijft vervolgens een minidump van elke thread van buitenaf, via minidumper en crash-handler. Een gecrasht proces schrijft nooit zijn eigen dump, wat ook de manier is waarop Firefox, Crashpad en Sentry het doen.
• De dump lezen. De monitor leest de dump met Mozilla's rust-minidump. Het gebruikt de Breakpad-symbolen van de release wanneer deze worden gevonden, of de native debug-info naast een build van de broncode. De Handtekening van het rapport (bijvoorbeeld freeze in misterdownloadmanager::winui::combo_edit) blijft hetzelfde voor rapporten van één probleem, en het venster zoekt ernaar in bestaande problemen.
• Symbolen. Release-builds bewaren regeltabellen (debug = "line-tables-only"), maar geen enkele download bevat de debug-info. CI zet het om in MisterDownloadManager-<version>-symbols-<platform>.zip (tools/installer/symbols.py, met behulp van Mozilla's dump_syms), gepubliceerd naast de andere bestanden van de release. Het rapportvenster haalt de zip op voor zijn eigen versie wanneer een stack kale adressen toont.
• Een .dmp van een probleem:

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

• Testen. cargo test -p mdm-crash voert een echte bevriezing, paniek en crash uit (examples/crashy.rs) en controleert de handtekening van elk rapport. Om het in de app te proberen, start u MDM met MDM_CRASH_TEST=1 en voert u vervolgens misterdownloadmanager /show crash-test:freeze (of panic, crash, abort) uit.