Compartir a través de

¿Cuándo y cómo se debería presentar un informe de errores?

  • Artículo

Sugerencia

Use el elemento de menú Notificar un problema en Visual Studio: esto enviará información de diagnóstico junto con el informe del error para ayudar a resolver el problema.

Hay instrucciones detalladas para Visual Studio 2019 o Visual Studio 2017 y Visual Studio para Mac.

Puede buscar informes existentes en el sitio web de Visual Studio Developer Community.

Archivar un error si...

Tiene un conjunto de pasos que cree que los ingenieros podrán usar para reproducir un problema.

O BIEN

Puede describir los síntomas visibles del problema, especialmente si también puede describir algunas circunstancias precisas relacionadas con el problema.[1]

Procedimientos recomendados para ayudar a solucionar errores de forma rápida y eficaz

  1. Busque en Visual Studio Developer Community y en la web informes de errores existentes o sugerencias de uso que puedan abordar el problema directamente.[2][3]

  2. Describa el problema de la forma más clara y concisa posible. Incluye una descripción de lo que ha ocurrido y de lo que se esperaba que ocurriera.

  3. Incluya cualquier seguimiento de pila relevante, texto del mensaje de error o registros de bloqueos (si usa la característica Notificar un problema, estos se pueden incluir automáticamente). [4]

  4. Anote también como texto sin formato cualquier mensaje de error importante que aparezca en la captura de pantalla adjunta.

  5. Incluya un pequeño caso de prueba independiente que reproduzca el error con el menor código posible. Si no puede reproducir el problema con un proyecto nuevo (creado con una de las plantillas integradas), comprima un proyecto que muestre el problema y adjúntelo al informe de errores. Haga que el proyecto de ejemplo sea lo más sencillo posible antes de adjuntarlo.[5][6]

  6. Describa el entorno en el que se ha encontrado el error, incluido el sistema operativo y las versiones de Xamarin y cualquier dependencia.

Detalles adicionales

  1. ^ Lo ideal es que la descripción de los "síntomas visibles" incluya suficientes detalles para que otros clientes puedan confirmar si están viendo el mismo problema (los mismos mensajes de error, la misma degradación del rendimiento, el mismo seguimiento de pila de un bloqueo, etc., etc.). En cuanto a las "circunstancias precisas", un buen ejemplo sería decir algo como: "Normalmente doy con el problema el 75 % de las veces, pero si cambio esta cosa puedo evitar el problema por completo". Otro ejemplo similar de una "circunstancia precisa" es si la degradación a una versión anterior de Xamarin detiene el problema.

  2. ^ Como cabría esperar, los fragmentos de texto de error (o cualquier otro texto exclusivamente descriptivo) suelen ser los mejores términos de búsqueda. Si el informe de error existente está incompleto, le invitamos a agregar detalles o a presentar un nuevo informe de errores mejor.

  3. ^ Otra buena pregunta es si se ha notificado el mismo problema en alguna aplicación Java, Objective-C o Swift. Si es así, es muy probable que el problema se deba a Android o iOS y no a Xamarin.

  4. ^ Algunos ejemplos de información a incluir:

    1. Para los errores que se producen al compilar un proyecto, incluya la salida de compilación de diagnóstico completa en el informe de errores.

    2. Para los errores que se producen al compilar o depurar un proyecto de iOS desde Visual Studio, ejecute Ayuda > Xamarin > Registros zip después de encontrar el error e incluya el archivo .zip resultante en el informe de errores.

    3. Para excepciones o bloqueos en aplicaciones Android o iOS, incluya los registros de depuración para aplicaciones de Xamarin.Android y Xamarin.iOS correspondientes.

  5. ^ Si es posible para su problema concreto, una opción es volver a crear el problema agregando un pequeño número de archivos de la solución original a una nueva solución. A menudo, el equipo de Xamarin podrá investigar los problemas incluso en casos de prueba más grandes (suponiendo que los pasos para reproducirlos se expliquen con claridad), pero las posibilidades de resolver errores rápidamente son mayores en casos de prueba más sencillos.

  6. ^ Si no es posible reproducir el problema agregando un pequeño número de archivos a una solución nueva, puede comprimir y adjuntar toda la carpeta de la solución para la aplicación completa. Elimine las carpetas bin, obj, Components y packages para que el archivo ZIP sea más pequeño. (El IDE y el proceso de compilación normalmente restaurarán o volverán a crear el contenido de estas carpetas según sea necesario). También puede eliminar tantos archivos de código y recursos del proyecto como desee, siempre que la solución resultante siga mostrando el problema original.