Skip to content

Most visited

Recently visited

navigation

Crear y editar configuraciones de ejecución y depuración

Cuando ejecutas, depuras o pruebas tu código, Android Studio usa una configuración de ejecución y depuración para determinar la manera de realizar la operación. Por lo general, la configuración predeterminada es suficiente y puedes simplemente ejecutar o depurar tu app. Sin embargo, puedes modificar y crear configuraciones nuevas y modificar las plantillas predeterminadas según tu proceso de desarrollo.

Acerca de las configuraciones de ejecución y depuración

Las configuraciones de ejecución y depuración especifican detalles como las opciones de instalación, inicio y prueba de tu app. Puedes definir una configuración para un único uso o guardarla para usos futuros. Después de guardarla, puedes seleccionar la configuración en la lista desplegable de Select Run/Debug Configuration, dentro de la barra de herramientas. Android Studio guarda configuraciones como parte del proyecto.

Configuración predeterminada de ejecución y depuración

Cuando creas un proyecto por primera vez, Android Studio crea una configuración predeterminada de ejecución y depuración para la actividad principal según la plantilla de Android App. Para ejecutar o depurar tu proyecto, siempre debes tener al menos una configuración de ejecución y depuración definida. Por esta razón, te recomendamos no borrar esta configuración.

Alcance del proyecto y control de la versión

Las configuraciones de ejecución y depuración, y los cambios de plantillas solo se aplican al proyecto actual. Si eliges compartir una configuración de ejecución y depuración, y luego verificas tu proyecto en un sistema de control de versiones, la configuración se comparte con cualquiera que consulte el proyecto. No puedes compartir plantillas.

Apertura del diálogo de las configuraciones de ejecución y depuración

En el diálogo de las configuraciones de ejecución y depuración se muestran tus configuraciones de ejecución y depuración, y las plantillas predeterminadas disponibles. En este diálogo, puedes:

Para abrir el diálogo, haz una de las siguientes acciones:

Aparecerá el diálogo Run/Debug Configurations, como se muestra en la Figura 1.

Figura 1: Diálogo Run/Debug Configurations.

En el diálogo del panel izquierdo, se muestran plantillas predeterminadas en la carpeta Defaults. En ella se agrupan tus configuraciones definidas por tipo de plantilla. Puedes cambiar el tamaño del diálogo para ver los elementos ocultos.

Creación de una configuración nueva de ejecución y depuración

Puedes definir configuraciones nuevas de ejecución y depuración desde el diálogo Run/Debug Configurations, la ventana Project o Code Editor. La configuración nueva debe basarse en una plantilla predeterminada.

En el diálogo Run/Debug Configurations, puedes iniciar una configuración nueva directamente desde una plantilla o desde una copia de otra configuración. Luego, puedes cambiar los valores de campo cuando sea necesario.

También puedes hacer clic con el botón secundario sobre un elemento de la ventana Project a fin de crear de manera automática una configuración específica para ese elemento. Por ejemplo, si deseas ejecutar una actividad en particular, puedes hacer clic con el botón secundario sobre el archivo de la actividad Java y seleccionar Run. Según el elemento, Android Studio usa una plantilla predeterminada de Android App, Android Tests, o JUnit para crear la configuración.

En Code Editor, puedes crear fácilmente una prueba y ejecutar o depurar la configuración para una clase o método, y luego ejecutarla.

Cuando crees una configuración fuera del diálogo Run/Debug Configurations, esta será temporaria a menos que la guardes. De forma predeterminada, puedes tener hasta cinco configuraciones temporarias en el proyecto antes de que Android Studio comience a eliminarlas. Para cambiar este parámetro predeterminado, en el diálogo Run/Debug Configurations, haz clic en la carpeta Defaults y escribe un valor en el campo Temporary Configurations Limit. Para obtener más información sobre configuraciones temporarias, consulta Creación y guardado de configuraciones temporarias de ejecución y depuración.

Puedes compartir una configuración de ejecución y depuración (pero no una plantilla) a través de tu sistema de control de versiones. Si seleccionas Shared en tu configuración de ejecución y depuración, y luego verificas tu proyecto en un sistema de control de versiones, cualquiera que consulte el proyecto recibirá la configuración.

Iniciar una configuración según una plantilla

Para definir una configuración de ejecución y depuración según una plantilla, sigue estos pasos:

  1. Abre el diálogo Run/Debug Configurations.
  2. Haz clic en Add New Configuration .
  3. Selecciona una plantilla predeterminada.
  4. Escribe un nombre en el campo Name.
  5. Modifica la configuración según sea necesario.
  6. Asegúrate de corregir cualquier error que se muestre en la parte inferior del diálogo.

  7. Haz clic en Apply u OK.

Iniciar una configuración desde una copia

Para definir una configuración de ejecución y depuración a partir de una copia de otra configuración, sigue estos pasos:

  1. Abre el diálogo Run/Debug Configurations.
  2. Selecciona una configuración existente de ejecución y depuración en el subpanel izquierdo.
  3. Haz clic en Copy Configuration .
  4. Escribe un nombre en el campo Name.
  5. Modifica la configuración según sea necesario.
  6. Asegúrate de corregir cualquier error que se muestre en la parte inferior del diálogo.

  7. Haz clic en Apply u OK.

Definición de una configuración para un elemento en el proyecto

Android Studio puede crear de manera automática una configuración de ejecución y depuración para algunos elementos que se muestran en la ventana Project. La configuración se basa en una plantilla predeterminada:

Nota: Para un archivo build.gradle o settings.gradle, Android Studio usa la plantilla Groovy. Como alternativa, debes usar Gradle Console para ejecutar o depurar un archivo build.gradle.

Para crear una configuración de ejecución y depuración de un elemento en tu proyecto, sigue estos pasos:

  1. Abre un proyecto en la vista Android o Project.
  2. En la ventana Project, haz clic con el botón secundario en un elemento y elige Run o Debug.
  3. Android Studio crea una configuración temporaria de ejecución y depuración, e inicia tu app.

  4. Para guardar la configuración, selecciona Save en la lista desplegable de Select Run/Debug Configuration, en la barra de herramientas.
  5. La lista desplegable se encuentra a la izquierda de Run y Debug ; por ejemplo, .

    Como alternativa, puedes hacer clic con el botón secundario en el elemento otra vez y seleccionar Save.

    También puedes seleccionar la configuración en el diálogo Run/Debug Configurations y hacer clic en Save Configuration en la parte superior izquierda.

    A excepción de una actividad, si haces clic con el botón secundario y luego ejecutas o depuras el mismo elemento otra vez, Android Studio crea una configuración nueva.

Definir una configuración de pruebas para una clase o un método

Android Studio te permite definir una configuración de ejecución de prueba para una clase o método y luego ejecutarla. Por ejemplo, si creas una clase nueva, puedes crear y ejecutar una prueba para esta. Si se pasa la prueba, puedes ejecutar pruebas para el resto del proyecto a fin de controlar que tu código nuevo no ocasione perjuicios en otro espacio.

Android Studio usa la plantilla Android Tests o JUnit, según tu conjunto de orígenes. Para una prueba de una unidad local, de manera opcional puedes realizar la ejecución con cobertura de código.

Si deseas crear una configuración de ejecución y depuración para una clase o un método en tu código Java, sigue estos pasos:

  1. Abre un proyecto en la vista Android o Project.
  2. Abre un archivo Java en Code Editor.
  3. Selecciona una clase o un método en el código y luego presiona Ctrl+Shift+T (⌘⇧T).
  4. Selecciona Create New Test en el menú que aparece.
  5. En el diálogo Create Test, de manera opcional puedes cambiar los valores del campo y luego hacer clic en OK.
  6. En el diálogo Choose Destination Directory, selecciona androidTest para crear una prueba instrumentada o test para crear una prueba de unidad local. Haz clic en OK.
  7. La prueba nueva aparecerá en la ventana Project del conjunto de orígenes de prueba correspondiente.

  8. Para ejecutar la prueba, realiza una de las siguientes acciones:
    • En la ventana Project, haz clic con el botón secundario sobre la prueba y selecciona Run o Debug.
    • En Code Editor, haz clic con el botón secundario en una definición de clase del archivo de prueba y selecciona Run o Debug para probar todos los métodos de la clase.
    • En Code Editor, haz clic con el botón secundario en un nombre de método del archivo de prueba y selecciona Run o Debug para probar solo ese método.
    • En Code Editor, haz clic en Play en el margen izquierdo, junto a una clase o un método, y selecciona Run o Debug.
  9. Para guardar la configuración, selecciona Save en la lista desplegable de Select Run/Debug Configuration en la barra de herramientas.
  10. La lista desplegable se encuentra a la izquierda de Run y Debug ; por ejemplo, .

    Como alternativa, puedes hacer clic con el botón secundario en el elemento otra vez y seleccionar Save.

    También puedes seleccionar la configuración en el diálogo Run/Debug Configurations y hacer clic en Save Configuration en la parte superior izquierda.

Ejecución y depuración de una app con una configuración guardada

Si has guardado una configuración de ejecución y depuración, puedes seleccionarla antes de ejecutar o depurar tu app.

Para usar una configuración de ejecución y depuración guardada, sigue estos pasos:

  1. Selecciona la configuración de ejecución y depuración en la lista desplegable de Select Run/Debug Configuration, dentro de la barra de herramientas.
  2. La lista desplegable se encuentra a la izquierda de Run y Debug ; por ejemplo, .

  3. Selecciona Run > Run o Run > Debug.
  4. También puedes hacer clic en Run o Debug .

Nota: Durante una sesión de Instant Run, cuando se selecciona una configuración diferente de ejecución y depuración, y se hace clic en Run o Debug de nuevo, finaliza la sesión en curso.

Edición de una configuración de ejecución y depuración

Para editar una configuración de ejecución y depuración, sigue estos pasos:

  1. Abre el diálogo Run/Debug Configurations.
  2. Selecciona una configuración del subpanel izquierdo.
  3. Modifica la configuración según sea necesario.
  4. Asegúrate de corregir cualquier error que se muestre en la parte inferior del diálogo.

  5. Haz clic en Apply u OK.

Edición de una plantilla predeterminada de configuración de ejecución y depuración

Puedes editar las plantillas predeterminadas que proporciona Android Studio para que se adecuen a tu proceso de desarrollo. La edición de una plantilla no afecta las configuraciones existentes que la usan. Entonces, por ejemplo, si necesitas crear varias configuraciones de un tipo determinado, puedes editar la plantilla y luego volver a cambiarla cuando finalices.

Aunque no puedas crear plantillas nuevas, puedes crear configuraciones similares a una plantilla para usarlas. Puedes copiar una configuración y editar la copia para crear configuraciones nuevas.

Para editar una plantilla, sigue estos pasos:

  1. Abre el diálogo Run/Debug Configurations.
  2. Expande la carpeta Defaults y selecciona una plantilla predeterminada.
  3. Modifica la configuración según sea necesario.
  4. Asegúrate de corregir cualquier error que se muestre en la parte inferior del diálogo.

  5. Haz clic en Apply u OK.

Configuraciones de ordenamiento y agrupación

En el diálogo de Run/Debug Configurations, puedes ordenar tus configuraciones para poder encontrarlas rápidamente. Puedes ordenar alfabéticamente los elementos de la carpeta y crear carpetas nuevas para agrupar configuraciones.

Para ordenar configuraciones alfabéticamente, sigue estos pasos:

  1. Abre el diálogo Run/Debug Configurations.
  2. Selecciona una carpeta que contenga configuraciones.
  3. Haz clic en Sort Configurations .
  4. Haz clic en Apply u OK.

Para agrupar configuraciones en carpetas, sigue estos pasos:

  1. Abre el diálogo Run/Debug Configurations.
  2. Selecciona una carpeta que contenga configuraciones.
  3. Haz clic en Create New Folder .
  4. Escribe un nombre en el campo Name.
  5. Arrastra elementos en la misma categoría de plantilla hacia la carpeta.
  6. Ordena las carpetas y configuraciones en la misma categoría de plantilla arrastrándolas hasta la posición o usando Move Up y Move Down .
  7. Haz clic en Apply u OK.

Definición de operaciones previas al lanzamiento

Puedes especificar tareas que deben ejecutarse antes de aplicar la configuración de ejecución y depuración. Las tareas se realizan en el orden en el que aparecen en la lista. La definición de tareas previas al lanzamiento es una función avanzada.

En lugar de usar esta función, te recomendamos disponer cualquier lógica de preparación como tareas en tu archivo build.gradle para que se ejecuten cuando se realice la compilación desde la línea de comandos.

Para crear una lista de tareas, sigue estos pasos:

  1. Para agregar una tarea a la lista, haz clic en Add y selecciona un tipo de tarea. Si se abre un diálogo, completa los campos y haz clic en OK.
  2. Agrega más tareas cuando sea necesario.
  3. Para ordenar las tareas, selecciónalas y haz clic en Up y Down, con lo cual podrás moverlas hacia arriba o abajo en la lista.
  4. Selecciona Show this page si deseas mostrar los ajustes de configuración de ejecución y depuración antes de aplicarlos.

    Esta opción se deselecciona de forma predeterminada.

  5. Selecciona la Activate tool window si deseas activar la ventana de herramientas Run o Debug de manera automática cuando ejecutes o depures tu app.
  6. Esta opción se deselecciona de forma predeterminada.

Para quitar una tarea de la lista, sigue estos pasos:

  1. Selecciona una tarea.
  2. Haz clic en Remove .

Para editar una tarea, sigue estos pasos:

  1. Selecciona una tarea.
  2. Haz clic en Edit .
  3. Edita la configuración de tareas en el diálogo que se abrirá y haz clic en OK.

En la siguiente tabla, se enumeran las tareas disponible que puedes agregar.

Tarea Descripción
Run External tool Permite ejecutar una aplicación que sea externa a Android Studio. En el diálogo External Tools, selecciona una o más aplicaciones que desees ejecutar y luego haz clic en OK. Si la aplicación aún no está definida en Android Studio, agrega su definición en el diálogo Create Tools. Para obtener más información, consulta Configuración de herramientas de terceros y Herramientas externas.
Run Another Configuration Permite ejecutar una de las configuraciones existentes de ejecución y depuración. En el diálogo Choose Configuration to Execute, selecciona una configuración que se ejecutará y luego haz clic en OK.
Marca Permite compilar el proyecto o el módulo. Android Studio ejecuta el comando Make Module si la configuración de ejecución y depuración especifica un módulo en particular o ejecuta el comando Make Project si no se especifican módulos.
Make Project Permite compilar el proyecto. Android Studio ejecuta el comando Make Project.
Make, no error check Esta opción es igual a Make, con la diferencia de que Android Studio ejecuta la configuración de ejecución y depuración independientemente del resultado de la compilación.
Build Artifacts No es compatible con Android Studio.
Run Gradle task Permite lanzar una tarea de Gradle. En el diálogo que se abrirá, especifica los detalles y luego haz clic en OK. Para obtener más información, consulta Gradle.
Gradle-aware Make Permite compilar el proyecto y ejecutar Gradle.
App Engine Gradle builder La tarea del generador de Gradle de App Engine sincroniza el proyecto y luego hace una compilación del módulo.

Plantillas predeterminadas de configuración de ejecución y depuración

Android Studio proporciona plantillas de configuración predeterminadas que te ayudan a comenzar rápidamente. Las siguientes plantillas se aplican al desarrollo de Android con Android Studio:

Nota: Android Studio 2.1.x y las versiones anteriores tenían una plantilla de aplicación nativa, que las versiones nuevas no tienen. Si tienes una plantilla de aplicación nativa en un proyecto, Android Studio la convierte automáticamente en app de Android cuando cargas el proyecto. Un diálogo Convert Project te guía en el proceso.

Las siguientes plantillas no compatibles provienen de IntelliJ IDEA y no son específicas para el desarrollo de Android con Android Studio:

Sigue los vínculos hacia la documentación IntelliJ IDEA para obtener información detallada sobre el uso de estas plantillas.

App para Android

Puedes ejecutar o depurar las apps y actividades de Android en dispositivos virtuales o hardware usando configuraciones basadas en esta plantilla.

Name y share

Una configuración de ejecución y depuración tiene las opciones Name y Share, mientras que la plantilla no las tiene.

Campo Descripción
Nombre Nombre de la configuración de ejecución y depuración.
Compartir

Selecciona esta opción para que la configuración de ejecución y depuración esté disponible para otros miembros del equipo a través del control de versiones. Puedes compartir una configuración de ejecución y depuración, pero no una plantilla. Si seleccionas esta opción, cuando el proyecto se verifica con Git (u otro sistema de control de versiones), la configuración de ejecución y depuración se incluye si alguien consulta el proyecto.

Android Studio almacena la configuración compartida de ejecución y depuración en un archivo XML separado, en la carpeta .idea/runConfigurations. De lo contrario, almacena la configuración en el archivo .idea/workspace.xml. Para obtener más información, consulta el formato de proyecto según el directorio.

Configuración predeterminada: opción no seleccionada.

Pestaña general

En la pestaña General, puedes especificar opciones de instalación, lanzamiento e implementación. La pestaña Miscellaneous también contiene opciones de instalación.

Campo Descripción
Module Permite seleccionar un módulo para aplicarle esta configuración.
Installation Options: Deploy

Selecciona una opción:

  • Default APK (predeterminada): permite crear un APK como se especifica en tu configuración de compilación.
  • Custom Artifact: no es compatible con Android Studio.
  • Nothing: no instalar un APK en un dispositivo. Por ejemplo, si prefieres instalar de modo manual el APK, no necesitas que Android Studio lo instale.
Installation Options: Install Flags Permite escribir cualquier opción pm install de PDA que desees usar. Formatear las opciones como lo harías en la línea de comandos, pero sin una ruta de acceso. A continuación, te mostramos algunos ejemplos:

-i foo.bar.baz -r /path/to/apk

electrónico y

-d -r

Valor predeterminado: ninguna opción.

Launch Options: Launch

Selecciona una opción:

  • Nothing: no se producen lanzamientos. Si especificas Nothing en el campo Deploy, tu app ya se encuentra en ejecución y seleccionas Debug, esta opción es similar a usar Attach debugger to Android process. Seleccionar Run no tiene efecto.
  • Default Activity (predeterminado): permite iniciar la actividad que has marcado como inicio en el manifiesto. Por ejemplo:
  • <intent-filter>
      <action android:name="android.intent.action.MAIN" />
      <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
    
  • Specified Activity: permite iniciar una actividad de app en tu módulo. Escribe el nombre o haz clic en para seleccionar una actividad en una lista.
  • URL: permite especificar una URL para el lanzamiento. Consulta Probar una URL.
Launch Options: Launch Flags Permite escribir cualquier opción am start de PDA que desees usar. Aplica formato las opciones como lo harías en la línea de comandos, pero sin una intención. Por ejemplo:

-W

Esta opción no aparece si seleccionas Nothing como valor de Launch.

Valor predeterminado: ninguna opción.

Deployment Target Options: Objetivo

Selecciona una opción:

  • Open Select Deployment Target Dialog (predeterminada): abre el diálogo Select Deployment Target para seleccionar un dispositivo virtual o hardware.
  • USB device: permite usar un dispositivo de hardware conectado a tu computadora de desarrollo a través de un puerto USB. Si hay más de uno, aparece un diálogo para que puedas seleccionarlo.
  • Emulator: permite usar un dispositivo virtual. En una configuración, puedes seleccionar un AVD. Como alternativa, solo usa el primer AVD de la lista.

Deployment Target Options: Use same device for future launches

Si deseas usar de manera automática el dispositivo que elegiste a través del diálogo Select Deployment Target en el futuro, selecciona esta opción. Si el dispositivo no está disponible, verás aparecer un diálogo. Configuración predeterminada: opción no seleccionada.
Before Launch Consulta Definición de operaciones previas al lanzamiento.

Pestaña de varios

En la pestaña Miscellaneous, puedes especificar opciones de logcat, instalación, lanzamiento e implementación. La pestaña General también contiene opciones de instalación.

Campo Descripción
Logcat: Show logcat automatically Cuando se selecciona esta opción, la pestaña logcat de Android Monitor se activa de manera automática cada vez que depuras y lanzas con éxito una app usando esta configuración. De lo contrario, el foco no se mueve a la pestaña logcat de manera automática al iniciarse la app. Configuración predeterminada: opción seleccionada.
Logcat: Borra el registro antes del lanzamiento Selecciona esta opción si deseas que Android Studio elimine datos desde sesiones previas desde el archivo de registro antes de comenzar la app. Configuración predeterminada: opción no seleccionada.
Installation Options: Skip installation if APK has not changed Cuando se selecciona, Android Studio no vuelve a implementar tu APK si se detecta que no cambió. Si deseas que Android Studio instale el APK de manera forzosa, incluso si no ha cambiado, anula la selección de esta opción. Configuración predeterminada: opción seleccionada.
Installation Options: Force stop running application before launching activity

Si esta opción se selecciona, cuando Android Studio determine que no debe reinstalar un APK porque no ha cambiado, forzará la detención de la app para que esta se inicie a partir de la actividad de lanzamiento predeterminada. Si esta opción no se deselecciona, Android Studio no fuerza la detención de la app.

Esta opción funciona en conjunto con la opción previa que verifica si un APK se instala o no. Deja ambos campos de Installation Options en los valores predeterminados a menos que desees forzar de manera explícita una instalación en cada ocasión.

En algunos casos, tal vez desees deseleccionar esta opción. Por ejemplo, si escribes un motor de método de entrada (IME), la detención forzosa de la app anula la selección de este como teclado actual, una acción que tal vez desees evitar.

Configuración predeterminada: opción seleccionada.

Before Launch Consulta Definición de operaciones previas al lanzamiento.

Pestaña Debugger

Especifica las opciones de depuración en la pestaña Debugger.

En el caso del código C y C++, Android Studio usa el depurador LLDB. Además de la IU de Android Studio normal, la ventana del depurador presenta una pestaña LLDB que te permite ingresar los comandos de LLDB durante la depuración. Puedes ingresar los mismos comandos que usa Android Studio para mostrar información en la IU del depurador y, además, puedes realizar operaciones adicionales.

Para los proyectos de C y C++, puedes agregar directorios de símbolos, como también comandos de arranque y posconexión de LLDB en la pestaña Debugger. Para ello, se usan botones similares a los siguientes:

Consulta Depurar tu app para obtener más información sobre la depuración en Android Studio.

Campo Descripción
Debug type

Selecciona una de las siguientes opciones:

  • Auto (predeterminada): permite que Android Studio elija el mejor tipo de depuración para tu proyecto.
  • Java: se depura solo el código Java.
  • Native: se depura el código C o C++ nativo.
  • Hybrid: se depuran el código Java y el código nativo en dos sesiones de depuración por separado.

Se recomienda la opción Auto, ya que selecciona automáticamente el tipo de depuración correcto para tu proyecto.

Experimental: Use Java aware C++ debugger - Android N+ only

Selecciona esta opción para depurar código Android Java y C++ dentro de la misma sesión de depuración de LLDB. El depurador C++ con reconocimiento de Java es una extensión del modo de depurador Native; junto con la depuración C++, también es compatible con Java.

Para poder usar esta función, el proyecto debe cumplir con los siguientes requisitos:

  • usar Android 7.0 (nivel de API 24) o una versión posterior únicamente;
  • contar con un tipo de depuración Native o Auto.

Si seleccionas el tipo de depuración Auto, Android Studio automáticamente selecciona esta opción si el proyecto cumple con los requisitos. Ten en cuenta que, si tienes un proyecto basado únicamente en Java y deseas usar LLDB para depurarlo, puedes seleccionar esta opción y Native.

A partir de Android Studio 2.2, esta función es experimental. Para obtener más información, consulta Usar el depurador C++ experimental con reconocimiento de Java.

Configuración predeterminada: opción no seleccionada.

Symbol Directories

Si deseas agregar archivos de símbolos para proporcionar al depurador información de C o C++ generada fuera de Android Studio, puedes agregar uno o más directorios aquí. Android Studio prioriza el uso de cualquier archivo de estos directorios en lugar de los archivos generados por el complemento de Android para Gradle. El depurador inspecciona los directorios de arriba abajo, en orden, hasta que encuentra lo que necesita. Realiza búsquedas de manera recursiva en los archivos del directorio. Para optimizar la lista y ahorrar tiempo, dispón los directorios usados con mayor frecuencia en la parte superior de la lista.

Si especificas un directorio en la parte superior del árbol, puede llevar más tiempo inspeccionar todos los subdirectorios. Si agregas un directorio muy específico, el tiempo de búsqueda es menor. Debes encontrar el equilibrio correcto entre la velocidad y la localización de los archivos que necesitas para la depuración. Por ejemplo, si tienes un directorio que contiene subdirectorios para diferentes interfaces binarias de Android (ABI), puedes optar por agregar un directorio para una ABI específica o para todas las ABI. Si bien puede llevar más tiempo buscar en el directorio de nivel superior, se trata de una opción más infalible en caso de que decidas realizar la depuración en un dispositivo diferente.

Ten en cuenta que no debes agregar directorios que contengan archivos de símbolos de Gradle porque el depurador los usa de manera automática.

LLDB Startup Commands

Agrega comandos de LLDB que desees ejecutar antes de que se conecte el depurador al proceso. Por ejemplo, puedes definir una configuración para el entorno, como se muestra en el siguiente comando:

settings set target.max-memory-read-size 2048

LLDB ejecuta los comandos en orden de arriba abajo.

LLDB Post Attach Commands

Agrega comandos de LLDB que desees ejecutar inmediatamente después de que se conecte el depurador al proceso. Por ejemplo:

process handle SIGPIPE -n true -p true -s false

LLDB ejecuta los comandos en orden de arriba abajo.

Host working directory Especifica el directorio de trabajo de LLDB.
Logging: Target channels

Especifica las opciones de registro de LLDB. Android Studio configura las opciones predeterminadas según la experiencia del equipo, de modo que el proceso no sea demasiado lento y, no obstante, contenga la información necesaria para solucionar problemas. El registro a menudo se requiere para los informes de errores de Android Studio. La configuración predeterminada es la siguiente:

lldb process:gdb-remote packets

Puedes modificar la configuración predeterminada para recopilar más información. Por ejemplo, las siguientes opciones de registro permiten recopilar información sobre una platform específica:

lldb process platform:gdb-remote packets

Para obtener una lista completa de comandos de registro, ingresa el comando log list desde una ventana terminal de LLDB en Android Studio.

Android Studio dispone los registros del dispositivo en la siguiente ubicación, donde ApplicationId es el ID de aplicación exclusivo que se usa en el manifiesto de APK compilado, y permite identificar tu app en tu dispositivo y en Google Play Store:

/data/data/ApplicationId/lldb/log

Si varios usuarios acceden a un dispositivo, Android Studio dispone los registros en la siguiente ubicación, donde AndroidUserId es un identificador exclusivo para un usuario en el dispositivo:

/data/user/AndroidUserId/ApplicationId/lldb/log

Si deseas obtener información sobre cómo usar LLDB para la depuración remota, consulta Depuración remota.

Before Launch Consulta Definición de operaciones previas al lanzamiento.

Pestaña Profiling

Especifica las opciones de creación de perfiles del depurador de GPU para Android Monitor en la pestaña Profiling.

Campo Descripción
Graphics Trace Options: Capture GPU Commands

Si está habilitado este campo, al ejecutar esta configuración de ejecución y depuración, se compilará, instalará y ejecutará la app con seguimiento de GPU. El seguimiento no es compatible con la depuración de una app. Si depuras una app con seguimiento de GPU, recibirás un mensaje y el depurador se iniciará sin seguimiento. Esta opción es relevante para la herramienta del depurador de GPU.

Ten en cuenta que, luego de habilitar esta casilla de verificación, cada vez que inicies la app esta se bloqueará y deberás conectar el depurador o el depurador de GPU.

Graphics Trace Options: Disable precompiled shaders and programs

Selecciona esta opción para inhabilitar la compatibilidad del controlador de gráficos de OpenGL ES con ejecutables de programa y sombreadores precompilados durante el seguimiento. Esta opción es relevante para la herramienta del depurador de GPU.

Los sombreadores precompilados no son compatibles con la reproducción de seguimientos y, por lo tanto, solo los sombreadores compilados durante el tiempo de ejecución que usan la función glShaderSource se pueden emplear para la inspección del búfer de fotogramas.

Las apps siempre deben realizar consultas de compatibilidad de sombreadores compilados previamente antes de usar las funciones glShaderBinary o glProgramBinary, y regresar a la compilación de tiempo de ejecución si los sombreadores precompilados o los programas no son compatibles.

Configuración predeterminada: opción no seleccionada.

Before Launch Consulta Definición de operaciones previas al lanzamiento.

Android Tests

La plantilla de pruebas que debes usar depende de tu conjunto de orígenes. La plantilla Android Tests se aplica para una prueba instrumentada. La plantilla JUnit se aplica para una prueba de unidad local.

Si usas Firebase Test Lab para realizar pruebas en diferentes dispositivos, puedes usar esta plantilla para definir tus pruebas instrumentadas. Para obtener más información, consulta Ejecutar tus pruebas con Firebase Test Lab.

Name y share

Una configuración de ejecución y depuración tiene las opciones Name y Share, mientras que la plantilla no las tiene.

Campo Descripción
Nombre Nombre de la configuración de ejecución y depuración.
Compartir

Selecciona esta opción para que la configuración de ejecución y depuración esté disponible para otros miembros del equipo a través del control de versiones. Puedes compartir una configuración de ejecución y depuración, pero no una plantilla. Si seleccionas esta opción, cuando el proyecto se verifica con Git (u otro sistema de control de versiones), la configuración de ejecución y depuración se incluye si alguien consulta el proyecto.

Android Studio almacena la configuración compartida de ejecución y depuración en un archivo XML separado, en la carpeta .idea/runConfigurations. De lo contrario, almacena la configuración en el archivo .idea/workspace.xml. Para obtener más información, consulta el formato de proyecto según el directorio.

Configuración predeterminada: opción no seleccionada.

Pestaña general

En la pestaña General, puedes especificar la ubicación de la prueba, el ejecutor de instrumentación, el shell de PDA y las opciones de depuración.

Campo Descripción
Module Permite seleccionar un módulo para aplicarle esta configuración.
Prueba

En esta área, especifica la ubicación de pruebas que deseas ejecutar:

  • All in module (predeterminada): inicia todas las pruebas desde el módulo seleccionado.
  • All in package: inicia todas las pruebas desde el paquete que se especifica en el campo Package. Escribe el nombre o haz clic en para seleccionar el paquete en un diálogo.
  • Class: inicia pruebas de la clase especificada en el campo Class. Escribe el nombre o haz clic en para seleccionar la clase en un diálogo.
  • Method: inicia un método de prueba. En el campo Class, especifica la clase que contiene el método. En el campo Method, especifica el método. Escribe el nombre o haz clic en para seleccionar la clase o el método en un diálogo.
Specific instrumentation runner (optional) Escribe la ubicación del ejecutor de instrumentación; haz clic en para usar un diálogo. En el archivo build.gradle se especifica la ubicación del ejecutor de instrumentación; este valor lo anula. Por lo general, el valor predeterminado es la clase AndroidJUnitRunner de la biblioteca de compatibilidad de pruebas de Android.
Extra options Permite escribir cualquier opción am instrument de PDA que desees usar. No escribas el componente. Por ejemplo, si usas AndroidJUnitRunner de la biblioteca de compatibilidad de pruebas de Android, puedes usar este campo para pasar opciones adicionales al ejecutor, como -e size small. Valor predeterminado: ninguna opción.
Deployment Target Options: Objetivo

Selecciona una opción:

  • Open Select Deployment Target Dialog (predeterminada): abre el diálogo Select Deployment Target para seleccionar un dispositivo virtual o hardware.
  • USB device: permite usar un dispositivo de hardware conectado a tu computadora de desarrollo a través de un puerto USB. Si hay más de uno, aparece un diálogo para que puedas seleccionarlo.
  • Emulator: permite usar un dispositivo virtual. En una configuración, puedes seleccionar un AVD. Como alternativa, solo usa el primer AVD de la lista.
  • Matriz de dispositivo de Firebase Test Lab: consulta Ejecutar tus pruebas con Firebase Test Lab.
Deployment Target Options: Use same device for future launches Si deseas usar de manera automática el dispositivo que elegiste a través del diálogo Select Deployment Target en el futuro, selecciona esta opción. Si el dispositivo no está disponible, verás aparecer un diálogo. Configuración predeterminada: opción no seleccionada.
Before Launch Consulta Definición de operaciones previas al lanzamiento.

Pestaña de varios

La pestaña Varios contiene opciones de logcat e instalación.

Campo Descripción
Logcat: Borra el registro antes del lanzamiento Selecciona esta opción si deseas quitar datos de sesiones previas del archivo de registro antes de iniciar la app. Configuración predeterminada: opción no seleccionada.
Installation Options: Skip installation if APK has not changed Cuando se selecciona, Android Studio no vuelve a implementar tu APK si se detecta que no cambió. Si deseas que Android Studio instale el APK de manera forzosa, incluso si no ha cambiado, anula la selección de esta opción. Configuración predeterminada: opción seleccionada.
Installation Options: Force stop running application before launching activity

Si esta opción se selecciona, cuando Android Studio determine que no debe reinstalar un APK porque no ha cambiado, forzará la detención de la app para que esta se inicie a partir de la actividad de lanzamiento predeterminada. Si esta opción no se deselecciona, Android Studio no fuerza la detención de la app.

Esta opción funciona en conjunto con la opción previa que verifica si un APK se instala o no. Deja ambos campos de Installation Options en los valores predeterminados a menos que desees forzar de manera explícita una instalación en cada ocasión.

En algunos casos, tal vez desees deseleccionar esta opción. Por ejemplo, si escribes un motor de método de entrada (IME), la detención forzosa de la app anula la selección de este como teclado actual, una acción que tal vez desees evitar.

Configuración predeterminada: opción seleccionada.

Before Launch Consulta Definición de operaciones previas al lanzamiento.

Pestaña Debugger

Especifica las opciones de depuración en la pestaña Debugger.

En el caso del código C y C++, Android Studio usa el depurador LLDB. Además de la IU de Android Studio normal, la ventana del depurador presenta una pestaña LLDB que te permite ingresar los comandos de LLDB durante la depuración. Puedes ingresar los mismos comandos que usa Android Studio para mostrar información en la IU del depurador y, además, puedes realizar operaciones adicionales.

Para los proyectos de C y C++, puedes agregar directorios de símbolos, como también comandos de arranque y posconexión de LLDB en la pestaña Debugger. Para ello, se usan botones similares a los siguientes:

Consulta Depurar tu app para obtener más información sobre la depuración en Android Studio.

Campo Descripción
Debug type

Selecciona una de las siguientes opciones:

  • Auto (predeterminada): permite que Android Studio elija el mejor tipo de depuración para tu proyecto.
  • Java: se depura solo el código Java.
  • Native: se depura el código C o C++ nativo.
  • Hybrid: se depuran el código Java y el código nativo en dos sesiones de depuración por separado.

Se recomienda la opción Auto, ya que selecciona automáticamente el tipo de depuración correcto para tu proyecto.

Experimental: Use Java aware C++ debugger - Android N+ only

Selecciona esta opción para depurar código Android Java y C++ dentro de la misma sesión de depuración de LLDB. El depurador C++ con reconocimiento de Java es una extensión del modo de depurador Native; junto con la depuración C++, también es compatible con Java.

Para poder usar esta función, el proyecto debe cumplir con los siguientes requisitos:

  • usar Android 7.0 (nivel de API 24) o una versión posterior únicamente;
  • contar con un tipo de depuración Native o Auto.

Si seleccionas el tipo de depuración Auto, Android Studio automáticamente selecciona esta opción si el proyecto cumple con los requisitos. Ten en cuenta que, si tienes un proyecto basado únicamente en Java y deseas usar LLDB para depurarlo, puedes seleccionar esta opción y Native.

A partir de Android Studio 2.2, esta función es experimental. Para obtener más información, consulta Usar el depurador C++ experimental con reconocimiento de Java.

Configuración predeterminada: opción no seleccionada.

Symbol Directories

Si deseas agregar archivos de símbolos para proporcionar al depurador información de C o C++ generada fuera de Android Studio, puedes agregar uno o más directorios aquí. Android Studio prioriza el uso de cualquier archivo de estos directorios en lugar de los archivos generados por el complemento de Android para Gradle. El depurador inspecciona los directorios de arriba abajo, en orden, hasta que encuentra lo que necesita. Realiza búsquedas de manera recursiva en los archivos del directorio. Para optimizar la lista y ahorrar tiempo, dispón los directorios usados con mayor frecuencia en la parte superior de la lista.

Si especificas un directorio en la parte superior del árbol, puede llevar más tiempo inspeccionar todos los subdirectorios. Si agregas un directorio muy específico, el tiempo de búsqueda es menor. Debes encontrar el equilibrio correcto entre la velocidad y la localización de los archivos que necesitas para la depuración. Por ejemplo, si tienes un directorio que contiene subdirectorios para diferentes interfaces binarias de Android (ABI), puedes optar por agregar un directorio para una ABI específica o para todas las ABI. Si bien puede llevar más tiempo buscar en el directorio de nivel superior, se trata de una opción más infalible en caso de que decidas realizar la depuración en un dispositivo diferente.

Ten en cuenta que no debes agregar directorios que contengan archivos de símbolos de Gradle porque el depurador los usa de manera automática.

LLDB Startup Commands

Agrega comandos de LLDB que desees ejecutar antes de que se conecte el depurador al proceso. Por ejemplo, puedes definir una configuración para el entorno, como se muestra en el siguiente comando:

settings set target.max-memory-read-size 2048

LLDB ejecuta los comandos en orden de arriba abajo.

LLDB Post Attach Commands

Agrega comandos de LLDB que desees ejecutar inmediatamente después de que se conecte el depurador al proceso. Por ejemplo:

process handle SIGPIPE -n true -p true -s false

LLDB ejecuta los comandos en orden de arriba abajo.

Host working directory Especifica el directorio de trabajo de LLDB.
Logging: Target channels

Especifica las opciones de registro de LLDB. Android Studio configura las opciones predeterminadas según la experiencia del equipo, de modo que el proceso no sea demasiado lento y, no obstante, contenga la información necesaria para solucionar problemas. El registro a menudo se requiere para los informes de errores de Android Studio. La configuración predeterminada es la siguiente:

lldb process:gdb-remote packets

Puedes modificar la configuración predeterminada para recopilar más información. Por ejemplo, las siguientes opciones de registro permiten recopilar información sobre una platform específica:

lldb process platform:gdb-remote packets

Para obtener una lista completa de comandos de registro, ingresa el comando log list desde una ventana terminal de LLDB en Android Studio.

Android Studio dispone los registros del dispositivo en la siguiente ubicación, donde ApplicationId es el ID de aplicación exclusivo que se usa en el manifiesto de APK compilado, y permite identificar tu app en tu dispositivo y en Google Play Store:

/data/data/ApplicationId/lldb/log

Si varios usuarios acceden a un dispositivo, Android Studio dispone los registros en la siguiente ubicación, donde AndroidUserId es un identificador exclusivo para un usuario en el dispositivo:

/data/user/AndroidUserId/ApplicationId/lldb/log

Si deseas obtener información sobre cómo usar LLDB para la depuración remota, consulta Depuración remota.

Before Launch Consulta Definición de operaciones previas al lanzamiento.

Pestaña Profiling

Especifica las opciones de creación de perfiles del depurador de GPU para Android Monitor en la pestaña Profiling.

Campo Descripción
Graphics Trace Options: Capture GPU Commands

Si está habilitado este campo, al ejecutar esta configuración de ejecución y depuración, se compilará, instalará y ejecutará la app con seguimiento de GPU. El seguimiento no es compatible con la depuración de una app. Si depuras una app con seguimiento de GPU, recibirás un mensaje y el depurador se iniciará sin seguimiento. Esta opción es relevante para la herramienta del depurador de GPU.

Ten en cuenta que, luego de habilitar esta casilla de verificación, cada vez que inicies la app esta se bloqueará y deberás conectar el depurador o el depurador de GPU.

Graphics Trace Options: Disable precompiled shaders and programs

Selecciona esta opción para inhabilitar la compatibilidad del controlador de gráficos de OpenGL ES con ejecutables de programa y sombreadores precompilados durante el seguimiento. Esta opción es relevante para la herramienta del depurador de GPU.

Los sombreadores precompilados no son compatibles con la reproducción de seguimientos y, por lo tanto, solo los sombreadores compilados durante el tiempo de ejecución que usan la función glShaderSource se pueden emplear para la inspección del búfer de fotogramas.

Las apps siempre deben realizar consultas de compatibilidad de sombreadores compilados previamente antes de usar las funciones glShaderBinary o glProgramBinary, y regresar a la compilación de tiempo de ejecución si los sombreadores precompilados o los programas no son compatibles.

Configuración predeterminada: opción no seleccionada.

Before Launch Consulta Definición de operaciones previas al lanzamiento.

App Engine DevAppServer

Esta configuración de ejecución y depuración se aplica a la Google Cloud Platform. Para obtener más información, consulta Agregar un módulo Java Servlet para App Engine y Ejecutar, probar y depurar el backend. Cuando sigues estos pasos y sincronizas tu proyecto con el archivo build.gradle, Android Studio crea una configuración App Engine DevAppServer para ti.

Ten en cuenta que la plantilla App Engine Server de IntellJ IDEA es diferente y no está disponible en Android Studio.

Campo Descripción
Nombre Nombre de la configuración de ejecución y depuración.
Compartir

Selecciona esta opción para que la configuración de ejecución y depuración esté disponible para otros miembros del equipo a través del control de versiones. Puedes compartir una configuración de ejecución y depuración, pero no una plantilla. Si seleccionas esta opción, cuando el proyecto se verifica con Git (u otro sistema de control de versiones), la configuración de ejecución y depuración se incluye si alguien consulta el proyecto.

Android Studio almacena la configuración compartida de ejecución y depuración en un archivo XML separado, en la carpeta .idea/runConfigurations. De lo contrario, almacena la configuración en el archivo .idea/workspace.xml. Para obtener más información, consulta el formato de proyecto según el directorio.

Configuración predeterminada: opción no seleccionada.

Single instance only Si quieres asegurarte de que solo se ejecute una instancia de la configuración de ejecución y depuración, selecciona esta opción. No permite varias ejecuciones de la misma configuración al mismo tiempo. Configuración predeterminada: opción seleccionada.
Module Permite seleccionar un módulo para aplicarle esta configuración.
Synchronize with build.gradle configuration Si agregas un módulo de App Engine y lo sincronizas con el archivo build.gradle, los campos de configuración de App Engine DevAppServer se completan de forma automática (recomendado). Si se selecciona Tools > Android > Sync Project with Gradle Files también se sincroniza el proyecto. Configuración predeterminada: opción seleccionada.
App Engine SDK Permite escribir una ruta de acceso en un Google App Engine SDK para Java en el equipo local. Haz clic en ... para seleccionarlo en un diálogo.
War Path Permite escribir una ruta de acceso para el directorio Web Application Archive (WAR) de la app que implementarás en el servidor de desarrollo local. Haz clic en ... para seleccionarlo en un diálogo.
VM Args

Especifica las opciones de la línea de comandos que desees pasar al VM para iniciar DevAppServer. Al especificar las opciones:

  • Usa espacios para separar diferentes opciones.
  • Para opciones con espacios, encierra el espacio con comillas (" ").
  • Si una opción incluye comillas, agrega una barra diagonal inversa antes de las comillas (\").

Para obtener más información sobre las opciones del VM, consulta la documentación para tu versión J2SE, como java JDK 7 y java JDK 8.

Valor predeterminado: ninguna opción.

Dirección del servidor Escribe la dirección que se usará para el servidor. Tal vez debas proporcionar la dirección para poder acceder al servidor de desarrollo desde otra computadora de tu red. Una dirección de 0.0.0.0 permite acceder al localhost y al nombre de host. Valor predeterminado: localhost.
Server Port Escribe el número de puerto que se usará para el servidor. Valor predeterminado: 8080.
Disable Check for App Engine SDK Updates Si se aplica, el servidor de desarrollo no se comunicará con App Engine para verificar la disponibilidad de una nueva versión del SDK. De forma predeterminada, el servidor verifica la existencia de una versión nueva en el inicio y produce un mensaje si esta se encuentra disponible.
Before Launch Consulta Definición de operaciones previas al lanzamiento.
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)