Errores, Características y Problemas

QGIS es un proyecto impulsado en gran medida por sus voluntarios, y es el trabajo de un equipo de desarrolladores, documentadores, traductores y colaboradores. A pesar de los esfuerzos del equipo para liberar QGIS sin errores, pueden permanecer algunos. Si usted encuentra un error o desea que se añadan nuevas características, ¡por favor repórtelo!

Donde reportar?

Cada parte del Proyecto QGIS tiene un lugar dedicado donde los problemas (solicitudes de características o errores) pueden ser reportados, gestionados y discutidos. Dependiendo del área donde encontró el problema, la siguiente tabla indica el lugar correcto para reportarlo:

Lugar donde encontró el error o para el que hay una solicitud de extensión

Lugar para informar del problema

Aplicaciones (QGIS Escritorio, QGIS Servidor)

https://github.com/qgis/QGIS/issues

QGIS Website (https://qgis.org)

https://github.com/qgis/QGIS-Website/issues

Documentación de QGIS (https://docs.qgis.org)

https://github.com/qgis/QGIS-Documentation/issues

API C++ (https://qgis.org/api)

https://github.com/qgis/QGIS/issues

API PyQGIS (https://qgis.org/pyqgis)

https://github.com/qgis/QGIS/issues (para contenidos) y https://github.com/qgis/pyqgis/issues (para formateo)

Complementos externos

El repositorio que el autor especificó en la descripción de la extensión.

Para ayuda y preguntas, por favor contacte la Listas de correos.

Comunicando problemas en aplicaciones QGIS

Problemas en aplicaciones QGIS (QGIS Escritorio y QGIS Servidor) están disponibles en Github. para poder remitir o comentar un informe, necesitará registrarse e iniciar sesión.

Antes de notificar un problema

Antes de presentar una incidencia, compruebe que está ejecutando las versiones actualmente soportadas 3.34.4 o 3.36.0 o la versión de desarrollo 3.37 (consulte también Cronograma de lanzamiento) y revise las incidencias actualmente abiertas para asegurarse de que no está creando un duplicado. Si dispone de información adicional sobre una incidencia, puede añadirla al ticket existente. Los plugins de terceros también pueden causar problemas. Si ha instalado alguno, compruebe también que el problema puede reproducirse sin ellos. Por favor, no informes de varios errores no relacionados en un único informe de error.

Cuando inicia sesión, un botón «New Issue» estará disponible. Selecciónelo y siga allí las instrucciones.

Antes de enviar el error, por favor compruebe el formato de sus reportes haga clic en «Vista previa». Por favor evite editar reportes existentes, si no hay errores de ortografía. Mejor añada más comentarios en cualquier otro caso.

Crear una traza inversa

Si tiene un fallo, puede ser útil incluir una traza inversa ya que el error puede no ser reproducible en otra máquina.

En Linux, QGIS intenta automáticamente usar gdb para conectarse al proceso de bloqueo para producir una traza inversa. Pero algunas distribuciones desactivan la posibilidad de conectar depuradores a procesos en ejecución. En ese caso, gdb solo produce un mensaje bastante inútil como:

QGIS died on signal 11Could not attach to process.
If your uid matches the uid of the target process,
check the setting of /proc/sys/kernel/yama/ptrace_scope, or try
again as the root user.
For more details, see /etc/sysctl.d/10-ptrace.conf
ptrace: Operation not permitted.
No thread selected
No stack.
gdb returned 0
Aborted (core dumped)

En ese caso, debe volver a habilitar esa opción estableciendo kernel.yama.ptrace_scope en 0 en /etc/sysctl.d/10-ptrace.conf (o /etc/sysctl.conf o algún otro archivo en /etc/sysctl.d/) y ejecute sysctl -p como root. Cuando reproduzca el bloqueo después de eso, se imprimirá una traza inversa.

Si no puede reproducir el bloqueo, aún debe haber un volcado del núcleo en el directorio actual, que puede analizarse después de que el proceso ya haya finalizado. Se llama ``núcleo “” (en algunos sistemas un punto y la identificación del proceso se agrega al nombre del archivo).

En algunas distribuciones, la creación de volcados de núcleo también está deshabilitada. En el caso de que solo obtenga Abortado'' en lugar de ``Abortado(núcleo volcado)'' cuando se produce el bloqueo. Luego debe ejecutar ``ulimit -c unlimited antes de iniciar QGIS. También puede incluir eso en su .profile, para que siempre esté habilitado cuando inicie sesión.

Para producir una traza inversa desde el archivo central, inicie gdb/path/to/the/qgis/binary core''. El binario suele ser ``/usr/bin/qgis o /usr/bin/qgis.bin en Debian con el complemento GRASS instalado. En gdb ejecuta bt que producirá la traza inversa.

Salida de registro en Windows

La compilación nocturna en OSGeo4W (paquete qgis-dev) se genera con la salida de depuración que puede ver con DebugView. Si el problema no es fácil de entender, este problema puede arrojar luz sobre dónde se bloquea QGIS.

Comunicar problemas con el sitio web o la documentación de QGIS

El proyecto QGIS proporciona un sitio web activo y una rica documentación. A pesar de nuestros esfuerzos, si encuentra información desactualizada, una declaración incorrecta o poco clara o pierde una información valiosa, no dude en informarla.

Las principales fuentes de estos documentos están alojadas y administradas en repositorios de GitHub, por lo que se requiere una cuenta de GitHub para informar errores o enviar parches.

Para empezar, primero Crear una cuenta GitHub.

A continuación, elija el repositorio apropiado:

Compruebe si el problema que quiere reportar aun no se ha repotado.

Haga clic en New Issue, escriba un título y una descripción clara para su problema.

Cuando termine, haga clic en Submit new issue.

Nota

Un enlace Fix me está disponible al final de cada sitio web para la mejora directa y el envío de una solicitud de extracción.

La opción también está disponible en el pie de página de la documentación.

Comunicando errores en complementos

La mayoría de los complementos de QGIS se publican en el repositorio oficial de complementos de QGIS. Los errores o las solicitudes de funciones relacionadas con ellos deben abrirse en sus respectivos sistemas de seguimiento de errores:

  • Para cualquier complemento disponible en el repositorio QGIS, encontrará en sus metadatos un enlace a su rastreador de errores. De lo contrario, consulte la documentación del complemento para encontrar la dirección del sistema de seguimiento de errores relevante o un desarrollador para contactar.

    Si no hay información disponible, repórtelo a la lista de correo del desarrollador.

  • Para otros complementos, no tenemos medios para garantizar que se proporcione dicha información.

Enviar un parche a proyectos QGIS

Además de informar problemas, puede ayudar a resolverlos. Los problemas se solucionan en GitHub a través de solicitudes de extracción. Debe bifurcar el repositorio si desea contribuir y enviar solicitudes de extracción:

Puede encontrar algunas directrices que le ayudarán a introducir fácilmente tus parches y pull requests en los proyectos QGIS en Submitting Pull Requests. Y más ampliamente, puede que necesite leer el capítulo Development Process.