Buscar en Unity

Una guía para convertirte en un beta tester efectivo

Una guía práctica y un documento de referencia para ayudarte a comenzar y aprovechar al máximo las pruebas beta de acceso preferente de Unity.

Bienvenido

Por qué son importantes las pruebas beta

Nuestro personal de QA trabaja arduamente para asegurarnos de que nuestras versiones sean estables, pero no podríamos lograr esto si los miembros de nuestra comunidad de desarrolladores no nos hicieran llegar sus comentarios sobre las compilaciones próximas. ¡Nos alegra mucho que quieran ayudarnos!

Para ayudar a ayudarnos (a ayudarte), hemos creado esta guía para ser el mejor beta tester que puedas ser: cómo subir tu proyecto, cómo escribir un informe de errores o bugs, y mucho más. Seguir estos pasos te permitirá brindarnos información valiosa que nos permitirá corregir problemas que te afectan y que afectan el desarrollo de tus proyectos.

Tus comentarios sobre la versión beta son valiosos. Analizamos cada informe de errores en beta con clasificación 4 y 5, y hacemos todo lo que podemos para analizar aquellos con clasificaciones menores (si no estás seguro de qué significa esto, revisa la esta entrada en el blog). Cuando validemos un error (bug) y tengamos una solución, la programaremos para una próxima versión beta. En este momento no podemos indicarte qué solución estará en qué versión beta, ¡pero sabemos que la introduciremos tan pronto podamos!

A continuación encontrarás información detallada acerca del flujo de trabajo para presentar informes de errores y retroalimentación impactantes. Aquí también puedes encontrar una resumen de los pasos más importantes.

Si tienes otras preguntas acerca de la versión beta, visita el foro sobre beta.

01

Instalación y pasos iniciales

  1. Descargar la última compilación beta, ya sea directamente como un instalador independiente o a través del nuevo Unity Hub. Esta página contiene también mucha información y recursos relacionados con betas. Puedes aprender acerca de las nuevas funcionalidades, encontrar documentos y herramientas útiles, y mantenerte informado acerca de los últimos sorteos.
  2. Ejecuta el instalador o el Hub. Si utilizas el instalador, asegúrate de instalar la versión beta en un directorio nuevo. Está bien tener varias versiones de Unity en paralelo, siempre que se ubiquen en directorios distintos.
  3. Empieza un proyecto nuevo o haz una copia del proyecto que tienes pensado utilizar para probar la beta, después ábrelo con la versión beta más reciente.
    • Asegúrate de crear un copia de respaldo si decides ejecutar un proyecto actual en la versión beta. No garantizamos la compatibilidad con versiones anteriores, por lo que una vez que actualices tu proyecto, es posible que no puedas revertirlo a la versión anterior.
    • Ten presente que cuando Unity abre un proyecto, automáticamente migra el proyecto a la versión de Unity que estás utilizando. Por lo tanto, trabajar en una copia de tu proyecto te ahorra también tiempo ya que evitas tener que volver a importarlo cuando regreses a tu versión estable actual.
  4. Desarrolla como siempre o prueba las nuevas funcionalidades y actualizaciones. Si crees que has encontrado un bug, sigue los pasos a continuación que se describen en las partes dos, tres y cuatro de esta guía.

02

Qué hacer con los errores o bugs en Unity

Así que...encontraste un bug. Aquí te mostramos cómo puedes ayudar de una forma eficiente.

Evalúa la situación

Acciones principales

Acciones secundarias

1. Evalúa la situación

Revisa la controlador de incidentes donde encontrarás los informes de bugs existentes.

Googlea el problema y busca la hilos del foro relacionada.

2. Acciones principales

¿Es un problema conocido que no ha sido resuelto?

Vota por la entrada relevante de la controlador de incidentes.

¿Se trata de un problema no conocido?

Envía un informe de errores o bugs con una proyecto de reproducción mínima y responde a las solicitudes del personal de Unity.

3. Acciones secundarias

¿Ya se ha informado sobre el problema, pero quieres asegurarte de que tu caso se resuelva por medio de una corrección?

Envía un informe de errores o bugs con una proyecto de reproducción mínima y responde a las solicitudes del personal de Unity.

¿Hay una hilo del foro para el problema?

Responde. Si no lo hay, inicia uno haciendo referencia a la identificación de tu problema (Issue ID).

Si tienes un problema con Unity, lo primero que debes hacer es averiguar si ya es un problema conocido o si eres el primero que lo ha experimentado. La primera dirección para obtener este tipo de información es nuestro Controlador de incidentes público.Te permite buscar bugs informados por otros usuarios y votar o comentar al respecto. La votación en relación con problemas ayuda a nuestro equipo a priorizar de qué bugs se ocupará primero.

El Unity foro sobre beta es otro recurso comunitario increíble. Puedes ver lo que otros han reportado, encontrar soluciones a problemas o contribuir con información. También es una buena forma de ponerte en contacto con alguien de Unity. Simplemente asegúrate de que los temas que estés proponiendo se relacionen con la versión beta actual, y no agrupes varios problemas distintos en un solo hilo.

Si no encuentras nada que se relacione con tu bug, entonces es hora de enviar un informe de errores o bugs. Una vez que hayas enviado un informe, también es una buena idea regresar al foro y publicar una descripción del problema que has descubierto. Al hacerlo, otros podrán informarse y añadir más contexto u ofrecer sus soluciones. Ayudará también a agilizar los tiempos de procesamiento, ya que monitoreamos el foro de betas con frecuencia y priorizamos la evaluación inicial de casos nuevos que se tratan allí.

Si inicias un hilo nuevo acerca de un problema, asegúrate de incluir tu número de caso (lo encontrarás en tu correo electrónico de confirmación) en la entrada de forma tal que nuestro equipo pueda identificar el informe de bugs que presentaste. Es lo primero que te preguntarán si no lo indicas.

Si tienes dudas sobre si un problema apunta a un error en la plataforma o en tu proyecto y consultar los foros o la documentación no te ha ayudado, no dudes en enviar un informe de error de todos modos.

03

Cómo documentar y reportar tu bug o error

Los informes de bugs pueden parecer algo intimidantes al principio pero no son así de difíciles, y son fundamentales para garantizar la estabilidad. Sigue estos sencillos pasos para escribir un buen informe de bugs que nuestros ingenieros puedan entender con facilidad para ponerse manos a la obra en seguida.

No tengas miedo de cometer errores. Si no podemos reproducir un problema con la información que incluiste en tu informe, nos pondremos en contacto contigo para averiguar si algo está faltando.

Abre el Bug Reporter

Mientras ejecutas Unity, anda a Ayuda Help → Reportar un bug en el menú. De manera alternativa, puedes encontrar el Bug Reporter instalado junto al editor en la carpeta de programas. Se inicia también automáticamente si tu equipo se cuelga.

Proporcionar información básica

En el campo «Con qué se relaciona el problema», selecciona la opción que se ajuste mejor al bug que estás reportando. Debido a que estás reportando un bug en la versión beta, normalmente será «Un problema con el Editor» o «Un bug que hace que el equipo se cuelgue».

En «Con qué frecuencia ocurre», tendrás que indicar si este es un problema que has experimentado una vez, a veces o cada vez que sigues los pasos que te llevaron a encontrarlo.

Indica tu dirección de correo electrónico en caso de que nuestro equipo necesite comunicarse contigo para obtener más información. Si has iniciado sesión con tu cuenta de Unity, este campo se llenará automáticamente.

Si tu informe es verificado, el texto que hayas escrito en los campos «Título» y «Describir el problema» pasarán a ser públicos y estarán disponibles en el controlador de incidentes o Issue Tracker. Esto ayuda a la comunidad. Otros usuarios podrán comentar, votar (lo que facilita la priorización de las soluciones), y ver cuándo está disponible una solución o corrección. No publicaremos tu información personal. Solo los empleados de Unity podrán acceder a tus proyectos y otros adjuntos.

Identificar el error o bug

En términos más concisos, ¿cómo describirías el bug? No te extiendas y sé específico, como:

Los errores aparecen en la consola después de limpiar la caché de iluminación global (GI) y volver a cargar el proyecto

Clasifica el bug y escribe el título

Si tuvieses que clasificar el bug, ¿qué elegirías? ¿UI? ¿Importación de assets? ¿Scripting? ¿Una plataforma específica? ¿Se colgó? En este caso, el bug se relacionaba con la iluminación y de manera más específica con el lighmapper Enlighten.

Bueno, ahora añade eso y la descripción de tu bug para crear el título en el siguiente formato:

Descripción de la [categoría]

En este escenario, el título de tu bug se vería así:

[Enlighten] Los errores aparecen en la consola después de limpiar la caché de GI y volver a cargar el proyecto

Indica los pasos a reproducir

Los equipos de QA y Desarrollo de Unity necesitan toda la ayuda que puedas ofrecerles para diagnosticar y corregir un problema. Dependiendo de la información que reciban, es posible que no puedan identificar la raíz del problema, o podrían confundirse y corregir algo que no es tu bug. Por esto, te conviene brindar tanta información como sea posible desde el principio para asegurarte de que ellos resuelvan tu problema definitivamente. La forma más fácil de hacerlo normalmente es desandar los pasos que diste antes de encontrar el bug. Entonces, ¿qué es lo primero que hiciste antes de ver el bug?

Cierra y vuelve a abrir el proyecto

Entonces, ese es el último paso en los Pasos a reproducir. ¿Qué hiciste justo antes de eso?

Limpia la caché de GI: Editar > Preferencias > Caché de GI > Limpiar caché

Sigue retrocediendo tanto como puedas recordar, y de manera ideal hasta cuando lo abriste por primera vez en Unity. Mientras más información puedas brindarnos, más fácil será reproducir y corregir. Si no puedes recordar todo, mira si puedes reproducir el bug y presta atención a los pasos que estás dando.

Ten presente que no tienes que indicar los pasos en forma escrita. Por ejemplo, puedes enviar los pasos a través de una captura de video de tu pantalla. Lo más importante es que muestre con claridad los pasos de manera que nuestros ingenieros puedan recrear el bug.

Añadir resultados esperados versus resultados reales

¿Qué creíste que sucedería antes de que encontrases el bug?

Esperado: ningún error en la consola

¿Qué sucedió en cambio?

Real: hay errores en la consola

Ten presente que si encuentras mensajes de errores inesperados resulta útil que los agregues también a la descripción.

Después de completar toda la información, tu informe ahora debe verse así:

Adjunta tu carpeta de proyecto

El Bug Reporter incluirá automáticamente el proyecto cargado actualmente en el informe de errores o bugs si vuelves a abrirlo a través del editor. Si inicias el reporter a través de su archivo ejecutable, tendrás que adjuntar tu proyecto manualmente. A menos que tu proyecto ya sea muy pequeño, se recomienda quitar los assets que no sean relevantes. Enviar un proyecto de reproducción mínimo que solo incluye lo que es necesario permite a nuestros equipos de QA y Desarrollo aislar el problema de manera más eficiente y presentar una solución mucho más rápido.

Si el problema se produce en una escena específica de tu proyecto, intenta exportar la escena en la que encuentras el bug, y después vuelve a importarla en un proyecto nuevo y ve si el bug todavía está allí. Si lo está, sube el proyecto nuevo y más pequeño. Si no lo está, puedes seguir intentado con versiones más grandes del proyecto.

Para ayudar a reducir el tamaño de tus proyectos y crear proyectos con reproducción mínima, hemos desarrollado varias herramientas que reducen de manera considerable el esfuerzo requerido.

Puedes encontrar información adicional acerca de cómo usar estas herramientas !aquí.

El proyecto más pequeño que recrea el problema es ideal, pero los proyectos grandes definitivamente son mejores que nada, así que por favor incluye tu proyecto completo si no puedes reducirlo. Nuestro sistema de informes soporta adjuntos pesados. No subas assets individuales debido a que el proyecto contiene datos y archivos de interés que los asset no incluyen por sí solos.

El informe final ahora debe verse así:

¡Perfecto! Has preparado un informe instructivo y conciso del bug que nuestro equipo puede utilizar para encontrar y corregir el error. Solo queda un paso:

Envía tu informe de bugs

Pulsa «Enviar» para enviar tu informe de bugs.

Cuando presentes tu bug, te enviaremos un correo electrónico de confirmación con el número de caso, el cual deberás conservar. El correo electrónico incluirá un enlace a una página web con el estado actual del bug. Puedes regresar a esa página en cualquier momento para acceder a información actualizada. No compartas este enlace en el foro o en otros espacios públicos ya que incluye tu dirección de contacto la historia del informe de bugs. El número de caso es suficiente para que otros puedas encontrar el problema en el Controlador de incidentes o Issue Tracker.

Para tu comodidad, te sugerimos controlar tus informes de bugs y carpetas de proyectos relacionados. Te recomendamos el siguiente método:

  1. Cada vez que presentes un informe de bugs, crea un archivo .zip del proyecto que has adjuntado.
  2. Conserva un archivo .txt del informe de bugs y colócalo en el directorio Assets así sabrás qué error muestra el proyecto y cómo puedes reproducirlo.
  3. Después de enviar tu informe de bugs, toma nota del número de caso que se indica en el correo electrónico de confirmación y coloca un prefijo en tu archivo .zip con este.

De esta manera, puedes encontrar rápidamente el proyecto que adjuntaste a un informe una vez que Unity te envíe un correo electrónico para informarte que se ha cerrado tu informe de bugs.

Después de recibir la notificación de Unity acerca del cierre de tu informe de bugs, puedes verificar si el bug se ha corregido encontrando el proyecto correspondiente y abriendo la última versión beta de Unity. Sigue los pasos para reproducir, y podrás determinar fácilmente si el bug ya no está.

Si bien esto demanda algo de trabajo de tu parte, significa que a) es más probable que tengas un informe de bugs de alta calidad, lo que significa que es más probable que tu bug pueda ser reproducido y corregido, y b) puedes garantizar con facilidad que el bug ya no aparecerá en una versión beta futura.

04

Seguimiento

Siempre es ideal que nuestro personal pueda ponerse en contacto contigo en caso de que tengan preguntas. Si enviaste un informe de bugs, nos comunicaremos contigo vía correo electrónico. Si escribiste en el foro, te responderemos allí. Responde tan pronto como puedas a las preguntas y solicitudes que recibas del equipo para asegurarte de que tu caso se resuelva rápidamente.

Si tu bug no aparece en los foros, te recomendamos que inicies un hilo nuevo. Recuerda que otros podrían haber experimentado el mismo problema, ¡por lo que publicar las soluciones que encuentres es una forma rápida de hacer amigos en la comunidad de beta!

¡Eso es todo!

Gracias por tomarte el tiempo para descubrir cómo ser un beta tester efectivo. Si tienes preguntas acerca de cualquiera de los puntos anteriores y tu motor de búsqueda preferido no encuentra respuestas, pasa por foros y pregunta.

Lo tengo

Usamos cookies para asegurarnos de brindarte la mejor experiencia en nuestro sitio web. Haz clic aquí para obtener más información.