Importante

Actualmente hay un pequeño número de desarrolladores activos en el proyecto. Como tal, las respuestas y etiquetas a todos los problemas abiertos no se pueden proporcionar de inmediato, pero el equipo las nota y las lee. Los buenos informes de errores proporcionan comentarios importantes, que el equipo siempre agradece.

Guía para reportes

Esta guía incluye instrucciones paso a paso sobre cómo reportar errores e incidencias que encontrés en Jami.

Configurar tu entorno

  • Prepárese para la pérdida de datos. Haga una copia de seguridad de su cuenta y vincúlela a tantos dispositivos como sea posible.

  • Instalar la última versión (o incluso una versión beta) de Jami. Informar de errores/problemas con versiones anteriores es menos útil, y es probable que ya haya sido arreglado en versiones más recientes.

Cómo denunciar un error

  1. Solo se requiere una vez: Crear una cuenta [Jami GitLab] (https://git.jami.net/users/sign_up).

  2. Elige el proyecto adecuado para publicar tu número en:

  3. Si tiene varios problemas, por favor presente informes separados de errores. Será mucho más fácil realizar un seguimiento de ellos de esa manera.

  4. El título es un resumen explícito del error (por ejemplo, la barra de encabezado es demasiado grande debido al tamaño del icono).

  5. Descubra los pasos para reproducir el error:

    • Si tienes pasos precisos para reproducirlo (¡genial !) ,está en camino de crear un informe de error útil.

    • Si puede reproducirlo ocasionalmente pero no después de seguir pasos específicos, proporcione información adicional sobre el problema para ayudar a otros a comprenderlo e intentar reproducirlo.

    • Si no puede reproducir el problema, puede haber pocas posibilidades de que sea razonablemente solucionable. Si lo hace, por favor proporcione tanta información/pistas sobre su ocurrencia como sea posible.

  6. Asegúrese de que su software está actualizado. Idealmente, pruebe una versión en desarrollo para ver si el error ya se ha corregido.

  7. Intentar aislar del entorno y reproducir (es decir, probar en varios dispositivos).

  8. Describa su-s entorno(s) especificando lo siguiente:

    • Sistema operativo y versión

    • Modelo de dispositivo concreto (muy importante en los móviles)

    • Versión estable o beta de Jami

    • Qué compilación está utilizando (F-Droid, Google Play, App Store, dl.jami.net, su propia compilación, etc.). Si has construido tu propia versión de Jami, por favor especifica la versión exacta del demonio Jami y la versión del cliente (puedes obtenerla usando “jamid -v” y “jami -v”; pero ten en cuenta que nuestros paquetes se actualizan con bastante frecuencia) y el commit de Git.

    • Condiciones de la red:

      • ¿Ambos dispositivos están en la misma red local?

      • ¿Diferentes redes?

      • ¿Se encuentra uno o los dos detrás de una NAT?

      • ¿Estás usando LTE?

      • ¿Estás usando WiFi?

    • Otros datos necesarios:

      • Proveedor SIP,

      • Hardware,

      • etc.

Escribir un resumen claro

¿Cómo describirías el error usando aproximadamente 10 palabras? Esta es la primera parte de tu informe de errores que verá un desarrollador.

Un buen resumen debe identificar rápidamente y de manera única un informe de error. Debe explicar el problema, no la solución sugerida.

Good: "Cancelling a file transfer crashes Jami"
Bad: "Software crashes"

Good: "All calls hang up after 32 seconds"
Bad: "Not able to call my friends"

Escribir pasos precisos para reproducirse

  • ¿Cómo puede un desarrollador reproducir el error en su propio dispositivo?

    Los pasos para reproducir son la parte más importante de cualquier informe de fallo. Si un desarrollador es capaz de reproducir el fallo, es muy probable que el fallo sea corregido. Si los pasos no están claros, puede que ni siquiera sea posible saber si el error ha sido corregido. Somos totalmente conscientes de que algunos errores pueden parecer obvios para usted, pero probablemente están relacionados con su entorno. Cuanto más preciso sea, más rápido se puede corregir el error.

  • ¿Qué debe incluir en un informe de errores?

    Indicar si se puede reproducir el error a voluntad, ocasionalmente, o no en absoluto. Describa su método de interacción con Jami, además de la intención de cada paso. Después de sus pasos, describa con precisión el resultado observado (real) y el resultado esperado. Separe claramente los hechos (observaciones) de las especulaciones.

Bien

Siempre puedo reproducirme siguiendo estos pasos:

1. Start Jami by clicking on the desktop icon.
2. Start a new conversation with anyone.
3. Click the file transfer button.

Expected results: A window opens and asks me to choose a file to send.
Actual results: When I click the file transfer button, nothing happens.

Mal

Attempt to transfer a file.
It doesn't work.

resultado obtenido

Por favor, incluya:

  • El demonio Jami (jamid o libjami o libring) y los registros de desactivación del cliente.

  • La descarga del núcleo, si se produjo.

resultado esperado

Una descripción del comportamiento esperado o deseado.

Proporcionar información adicional

La siguiente información se solicita para la mayoría de los informes de errores. Puede ahorrar tiempo proporcionando esta información debajo de losresultados esperados.

Registros

Android

Para recopilar registros a través del dispositivo Android usando Jami:

  1. Clic * * Conversaciones**.

  2. Clic en el menú ⋮ (tres puntos) en la esquina superior derecha.

  3. Clic en Settings.

  4. Clic Diagnostic logs.

Para recopilar registros a través de un ordenadora usando el Puente de depuración de Android (adb):

  1. Se requiere que el adb esté configurado en el ordenador.

  2. Iniciar Jami en el móvi y luego ejecútar adb logcat *:D | grep `adb shell ps | egrep 'cx.ring' | cut -c10-15` > logring.txt

  3. Ahora tienes un archivo que contiene el registro del cliente

Cliente Jami de escritorio basado en el framework Qt (GNU/Linux, macOS, Windows)

  1. Abra la pestaña General en la configuración.

  2. En la sección Solución de problemas, clic en Abrir registros.

  3. Activar Ver registros.

  4. Clic en Copiar.

  5. Pegar el resultado y explicar lo sucedido.

GNU/Linux

Registros clásicos (por defecto sólo se registran registros de advertencia >=):

journalctl --since "24h ago" | grep jami

Registro completo: El cliente Jami (GUI) y el demonio son procesos separados. Para obtener registros de ambos procesos, inicie cada proceso manualmente, uno a la vez.

  1. Asegúrese de que no se ejecutan ningún cliente Jami o instancias de demonio: compruebe ejecutando `ps aux ̶ Grab jami̶̶ en una terminal.

    • Jami puede seguir funcionando incluso si no hay ventanas abiertas, dependiendo de tus preferencias.

    • Si el cliente o el demonio están funcionando, termina con kill PID.

  2. En una terminal, comience el daemon con jamid -d -c

    • Este ejecutable normalmente no está en el PATH, y en los paquetes Debian/Trisquel/Ubuntu, se encuentra en /usr/lib/x86_64-linux-gnu/jamid -d -c o /usr/libexec/jamid -d -c.

  3. En otro terminal, se inicia el cliente, usando “jami-d”.

Para obtener un rastro de retroceso, puede ejecutar el programa dentro de GDB:

gdb -ex run --args jami -d, or gdb -ex run --args /usr/libexec/jamid -cd, dependiendo del componente que se necesite depurar.

Cuando se estropee, puede escribir bt (o mejor aún, thread aplicar todos bt) y luego pulsar Enter.

macOS

  1. Navega a /Aplicaciones/Jami.app/Contentes/MacOS/.

  2. Haga doble clic en Jami, lanzará Jami y imprimirá el registro a la terminal.

  3. Copie el registro desde el terminal a un archivo.

Alternativamente, puede ejecutar /<path a Jami>/Jami.app/Contents/MacOS/Jami -d desde la terminal.

Las ventanas

  1. Abrir el símbolo del sistema (cmd.exe)

  2. Ejecuta “ Jami.exe “ con las siguientes opciones:

    • -d para abrir una ventana de consola separada para recibir registros

    • -f para escribir registros a %localappdata%\jami\jami.log