Skip to content

Most visited

Recently visited

navigation

Informar un error

Queremos solucionar los errores que encuentres. Sin embargo, muchos de ellos no incluyen la información necesaria. Por lo tanto, centramos nuestros recursos limitados en los errores que incorporen informes completos. Para aumentar las probabilidades de que el error que detectaste se resuelva, tómate un momento y lee este documento.

Si no sigues estos pasos, cerraremos tu presentación del error. Si sucede eso, simplemente vuelve a presentarlo con la información adicional.

Además, ten en cuenta que el espacio de seguimiento de problemas no es un foro de asistencia. Si tienes preguntas acerca de cómo utilizar las herramientas o poner en funcionamiento tu aplicación de Android, visita stackoverflow.com o uno de los diferentes recursos de asistencia para desarrolladores de Android.

Cómo informar un error

  1. Asegúrate de utilizar la versión más reciente de las herramientas. Destinamos mucho tiempo al análisis de errores que ya se han solucionado. Si cerramos el problema y señalamos este documento, abre otro problema siempre y cuando puedas reproducirlo utilizando la última versión de las herramientas.

  2. Describe los pasos exactos que se deben reproducir. Sé específico. Si podemos reproducir el problema en el primer intento, las probabilidades de encontrar una solución son mucho más altas. Si es posible, incluye un fragmento de código (o mejor aún, señala un proyecto de github que pueda utilizarse para reproducir el error). Las capturas de pantalla también son útiles para mostrar lo que observas.

  3. Describe lo que esperabas que sucediera y lo que observaste en lugar de ello.

  4. Incluye información sobre la versión. En el caso de Android Studio, puedes encontrar esta información en el diálogo About. Haz clic en Help > About (en Mac, haz clic en Android Studio > About Android Studio). No es necesario que destaques el texto para copiarlo. Simplemente presiona Control + C (o Command + C en Mac) y luego pega el contenido en el informe de errores.

  5. Indica la versión de Java que usas (en el caso de Android Studio, esta información se incluye en el diálogo About), si corresponde.

  6. Indica el sistema operativo que usas.

  7. Elige un resumen descriptivo para el error. Te sorprenderás al ver la cantidad de errores presentados con títulos como “Error”, “Problema”, “Excepción” y “No funciona” a modo de resumen.

  8. Para determinados tipos de errores, necesitamos información adicional:

Recuerda que es esencial agregar instrucciones claras para reproducir el error. Si es posible, comparte archivos o proyectos que faciliten la reproducción del error (sin embargo, no debes adjuntar código fuente patentado al informe de errores). Las capturas de pantalla también sirven para respaldar el informe.

Una vez que hayas recopilado esta información, informa tu error aquí.

Detalles de errores de Android Studio

Incluye la siguiente información adicional que es específica de los errores de Android Studio.

Si el IDE se bloquea

Si el IDE en sí parece funcionar con mucha lentitud o completamente congelado, genera algunos volcados de subprocesos y adjúntalos al informe de errores. Gracias a ellos, podemos determinar la razón por la cual el IDE está tan ocupado (o el recurso contenido que espera).

Si el IDE funciona con lentitud, pero no congelado, también debes adjuntar el archivo idea.log (selecciona Help > Show Log in Finder). De esta manera, podemos determinar si la lentitud del IDE se debe a que asienta errores constantemente en el registro.

Si el IDE se queda sin memoria

Si el IDE se queda sin memoria, genera un histograma del montón; para ello, ejecuta lo siguiente:

jmap -histo:live <pid>

Si el IDE falla o genera excepciones

Para otros tipos de fallas, adjunta el archivo idea.log. Selecciona Help > Show Log in Finder.

Cómo generar un volcado de subprocesos

Un volcado de subprocesos muestra un panorama de todos los subprocesos que se ejecutan en la JVM y, en el caso de cada subproceso en particular, ofrece datos sobre todos los marcos de pila. Esto permite determinar la razón por la cual el IDE está ocupado, en especial si generas varios volcados de subprocesos con algunos segundos de diferencia.

Cuando informas errores porque el IDE está extremadamente ocupado con una CPU vinculada o porque parece haberse congelado, un volcado de subprocesos permite determinar el código que realiza mucho trabajo o los subprocesos que se disputan los recursos y generan un interbloqueo.

El JDK incorpora una herramienta denominada “jstack” que se puede utilizar para generar un volcado de subprocesos. Primero, debes encontrar el ID del proceso de Android Studio. Para ello, puedes usar el comando “jps” Tanto jstack como jps se encuentran en el directorio bin del JDK. Si cuentas con varios JDK instalados, en este caso debes utilizar la misma versión que la que empleas para ejecutar Android Studio. Puedes consultar la versión en el diálogo About de Android Studio.

En Linux y Mac:

jps -mv | grep studio

En Windows:

jps -mv | findstr studio

Por ejemplo, observarás una línea prolongada como la siguiente:

$ jps -mv | grep studio
37605 -Dfile.encoding=UTF-8 -ea -Dsun.io.useCanonCaches=false -Djava.net.preferIPv4Stack=true -Djna.nosys=true ...

El primer número de la izquierda (37605 en este caso) es el ID de proceso.

Luego, puedes generar un volcado de subproceso y guardarlo en el archivo dump.txt de esta manera:

jstack -l pid >> dump.txt

Si eso no funciona, existen algunos métodos adicionales específicos de cada plataforma para generar un volcado de subprocesos. Consulta Asistencia sobre IntelliJ para obtener instrucciones detalladas.

Detalles de los errores de Instant Run

Para informar un error relacionado con Instant Run, sigue estos pasos:

  1. Habilita Android Studio para registrar información adicional sobre tu sesión de Instant Run.
  2. Si deseas enviar comentarios sobre un problema que encontraste antes de completar el paso anterior, intenta recrear el problema.
  3. Envía un informe inmediatamente luego de encontrar un problema en Instant Run.

Qué información recopilamos

Habilitar el IDE para que registre la siguiente información sobre tu sesión de Instant Run permite al equipo de Android Studio comprender mejor el problema que experimentaste y solo se destina a este propósito:

Habilitar registros adicionales

Para permitir que Android Studio capture y envíe esta información, sigue estos pasos:

  1. Abre el diálogo Settings o Preferences.
  2. Dirígete a Build, Execution, Deployment > Instant Run.
  3. Selecciona la casilla de verificación Log extra info. Puedes inhabilitar esta opción cuando lo desees.
  4. Haz clic en OK.

Informar un problema

Luego de habilitar los registros adicionales, recrea cualquier problema de Instant Run que hayas experimentado previamente. Inmediatamente después de reproducir un problema, envía un informe de la siguiente manera:

  1. Selecciona Help > Report Instant Run Issue en la barra de menú. Aparecerá un diálogo similar al que se muestra en la figura 4.

    Figura 4: Puedes proporcionar detalles adicionales en el campo de texto y revisar los registros que Android Studio enviará junto con tu informe.

  2. Brinda información adicional en el campo de texto para describir tu experiencia; por ejemplo, los pasos para reproducir el problema o la medida en la que el comportamiento real difirió de tus expectativas.
  3. Al terminar, haz clic en OK.

Detalles de errores de Gradle y de herramientas de compilación

Incluye la siguiente información específica para los problemas relacionados con la compilación de tus proyectos o vinculados con la sincronización de Gradle:

Detalles de errores del emulador de Android

Incluye la siguiente información específica para los errores relacionados con el emulador:

This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Follow Google Developers on WeChat

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)