Informes de errores

Si Mister Download Manager se cierra inesperadamente o deja de responder, se abre una ventana de informe de errores. Muestra lo que ha ocurrido, permite leer el informe completo y puede enviarlo a los desarrolladores en GitHub. Cada informe ayuda a solucionar el problema para todos.

Qué se ve

• Mister Download Manager se cerró inesperadamente: MDM se bloqueó o encontró un error interno y se cerró.
• Mister Download Manager dejó de responder: su ventana no respondió durante 8 segundos. MDM sigue ejecutándose, pero está congelado. Finalizar y reiniciar MDM cierra la copia congelada e inicia una nueva. Si MDM vuelve a responder por sí mismo, la ventana lo indica.

En la ventana:

1. ¿Qué estaba haciendo cuando ocurrió? es opcional. Unas pocas palabras, como «Abrí Añadir URL», son de gran ayuda.
2. El informe muestra todo lo que se enviaría. Léalo primero si lo desea.
3. Enviar en GitHub abre el formulario de Informe de errores de GitHub en su navegador, ya rellenado, junto con la carpeta que contiene el informe. Arrastre el archivo del informe al formulario, revíselo y envíelo. Necesita una cuenta de GitHub. No se envía nada automáticamente.
4. Si alguien ya ha informado del mismo problema, la ventana lo indica (Ya informado como problema #…). Abrir el problema notificado lo abre y pone su informe en el portapapeles, para que pueda añadirlo como comentario.

Los otros botones copian el informe, abren su carpeta o inician MDM de nuevo.

Qué contiene un informe

• Qué ocurrió: el error y el lugar en el código de MDM donde ocurrió.
• La pila: el lugar en el código de MDM donde se bloqueó o congeló, y lo que estaban haciendo todas las demás partes.
• El registro reciente de MDM: por ejemplo, «comando AddUrl» o «ventana abierta: add-url».
• El sistema: la versión de MDM y cómo lo instaló, su sistema operativo y su versión, el procesador, el idioma y el tema, y cuántas descargas y colas tiene. Son solo recuentos.

No contiene ninguno de estos datos:

• sus direcciones de descarga o nombres de archivo;
• su nombre de usuario, que se muestra como ~ en las rutas de las carpetas.

Si un mensaje de error cita algo que usted escribió, ese texto está en el informe, así que léalo antes de enviarlo.

El archivo de datos de bloqueo (.dmp) es una instantánea de lo que MDM estaba ejecutando en ese momento. Es lo que más ayuda a los desarrolladores, pero puede contener fragmentos de lo que MDM tenía en la memoria, como direcciones de descarga. Solo se adjunta cuando marca Adjuntar también los datos de bloqueo.

Dónde se guardan los informes

En la carpeta de datos de MDM:

• crashes\: cada informe (.txt) y sus datos de bloqueo (.dmp);
• logs\: el registro de MDM (mdm.log, con los más antiguos como mdm.1.log y así sucesivamente, 2 MB cada uno).

La carpeta de datos de MDM es %APPDATA%\misterdownloadmanager en Windows, ~/Library/Application Support/misterdownloadmanager en macOS y ~/.local/share/misterdownloadmanager en Linux. En modo portátil es la carpeta data junto al programa.

El registro graba lo que hace MDM, por lo que un informe puede mostrar lo que llevó a un problema. Para registrar más detalles, inicie MDM con la variable de entorno MDM_LOG=debug.

Para desarrolladores

Cómo funciona: una segunda copia de MDM, el monitor, se inicia junto a ella con --crash-monitor. El código de bloqueo reside en crates/crash y crates/app/src/crash.rs.

• Captura de problemas. Cuando MDM se bloquea (una excepción de Windows, una señal en Linux, una excepción Mach en macOS), entra en pánico o se congela, pide un volcado al monitor. Una congelación es un fotograma de la ventana que se ejecuta durante más de 8 segundos, visto por un hilo de vigilancia que ignora el tiempo de inactividad. El monitor escribe entonces un minivolcado de cada hilo desde el exterior, a través de minidumper y crash-handler. Un proceso bloqueado nunca escribe su propio volcado, que es como lo hacen también Firefox, Crashpad y Sentry.
• Lectura del volcado. El monitor lee el volcado con rust-minidump de Mozilla. Utiliza los símbolos Breakpad de la versión cuando los encuentra, o la información de depuración nativa junto a una compilación desde el código fuente. La Firma del informe (por ejemplo, freeze in misterdownloadmanager::winui::combo_edit) permanece igual en los informes de un mismo problema, y la ventana busca problemas existentes con ella.
• Símbolos. Las compilaciones de lanzamiento conservan las tablas de líneas (debug = "line-tables-only"), pero ninguna descarga incluye la información de depuración. CI la convierte en MisterDownloadManager-<version>-symbols-<platform>.zip (tools/installer/symbols.py, usando dump_syms de Mozilla), publicada junto a los otros archivos de la versión. La ventana de informes obtiene el zip de su propia versión cuando una pila muestra direcciones sin procesar.
• Un .dmp de un problema:

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

• Prueba. cargo test -p mdm-crash ejecuta una congelación, pánico y bloqueo reales (examples/crashy.rs) y comprueba la firma de cada informe. Para probarlo en la aplicación, inicie MDM con MDM_CRASH_TEST=1 y luego ejecute misterdownloadmanager /show crash-test:freeze (o panic, crash, abort).