Skip to content

Most visited

Recently visited

navigation

Compilar tu app desde la línea de comandos

Puedes ejecutar todas las tareas de compilación disponibles para tu proyecto de Android usando la herramienta de la línea de comandos del contenedor de Gradle. Está disponible como archivo por lotes para Windows (gradlew.bat) y como secuencia de comandos shell para Linux y Mac (gradlew.sh), y se puede acceder a ella desde la raíz de cada proyecto que crees con Android Studio.

Para ejecutar una tarea con el contenedor, usa uno de los siguientes comandos:

Para ver una lista de todas las tareas de compilación disponibles para tu proyecto, ejecuta tasks:

gradlew tasks

En el resto de esta página, se describen los aspectos básicos para compilar y ejecutar tu app con el contenedor de Gradle. Para obtener más información sobre cómo configurar tu compilación de Android, consulta Configurar tu compilación.

Si prefieres usar las herramientas de Android Studio en lugar de las herramientas de la línea de comandos, consulta Compilar y ejecutar tu app.

Acerca de los tipos de compilación

De manera predeterminada, existen dos tipos de compilación disponibles para cada app de Android: uno para depurar tu app (compilación de depuración) y otro para lanzar tu app a los usuarios (compilación de lanzamiento). El APK resultante de cada compilación debe firmarse con un certificado antes de poder instalarlo en un emulador o dispositivo. La compilación de depuración se firma automáticamente con una clave de depuración proporcionada por las herramientas del SDK (es poco segura y no puedes publicar este APK en Google Play Store) y la compilación de lanzamiento debe firmarse con tu propia clave privada.

Si deseas compilar un APK para el lanzamiento, es importante que primero leas Firmar tu app. En esa página, se describe el procedimiento para generar una clave privada y luego aplicarla a la firmar de tu archivo de APK. Sin embargo, si estás dando los primeros pasos, puedes ejecutar rápidamente tus apps en un emulador o un dispositivo conectado compilando un APK de depuración.

También puedes definir un tipo de compilación personalizado en tu archivo build.gradle y configurar dicha compilación para firmarla como compilación de depuración incluyendo debuggable true. Para obtener más información, consulta Configurar variantes de compilación.

Compilar un APK de depuración

Para probar y depurar la app de forma inmediata, puedes compilar un APK de depuración. Dicho APK se firma con una clave de depuración proporcionada por las herramientas del SDK y permite realizar la depuración mediante adb.

Para compilar un APK de depuración, abre una línea de comandos y navega hasta la raíz del directorio de tu proyecto, desde Android Studio, y selecciona View > Tool Windows > Terminal. Para iniciar una compilación de depuración, invoca la tarea assembleDebug:

gradlew assembleDebug

De esta forma, se crea un APK con el nombre module_name-debug.apk en project_name/module_name/build/outputs/apk/. El archivo ya está firmado con la clave de depuración y alineado con zipalign, por lo que puedes instalarlo inmediatamente en un dispositivo.

Si deseas compilar el APK e instalarlo inmediatamente en un dispositivo conectado o emulador en ejecución, invoca installDebug:

gradlew installDebug

La parte “Debug” de los nombres de tareas anteriores es solo una versión del nombre de la variante de compilación según la convención de mayúsculas y minúsculas, por lo que se puede reemplazar por cualquier variante de compilación que desees instalar. Por ejemplo, si tienes una clase de producto “demo”, puedes compilar la versión de depuración con la tarea assembleDemoDebug.

Si deseas ver las tareas de compilación e instalación disponibles para cada variante (incluidas las tareas de desinstalación), ejecuta la tarea tasks.

Además, consulta la sección Ejecutar tu app en el emulador y Ejecutar tu app en un dispositivo.

Compilar un APK de lanzamiento

Cuando estés listo para lanzar y distribuir tu app, debes compilar un APK de lanzamiento que esté firmado con tu clave privada.

Para obtener más información, consulta Firmar tu app.

Ejecutar tu app en el emulador

Para usar el emulador de Android, debes crear un dispositivo virtual Android (AVD) por medio de Android Studio.

Una vez que cuentes con un AVD, inicia el emulador de Android e instala la app como se describe a continuación:

  1. En una línea de comandos, dirígete a android_sdk/tools/ e inicia el emulador especificando tu AVD:

    emulator -avd avd_name

    Si no estás seguro del nombre del AVD, ejecuta emulator -list-avds.

  2. Ahora podrás instalar tu app mediante las tareas de instalación de Gradle mencionadas antes o la herramienta adb:
    adb install path/to/your_app.apk
    

    Todos los APK compilados se almacenan en project_name/module_name/build/outputs/apk/.

Para obtener más información, consulta Ejecutar apps en el emulador de Android.

Ejecutar tu app en un dispositivo

Para poder ejecutar tu app en un dispositivo, debes habilitar la depuración USB en tu dispositivo. Puedes encontrar la opción en Settings > Developer options.

Nota: En Android 4.2 y versiones posteriores, Developer options está oculto de forma predeterminada. Para que esté disponible, dirígete a Settings > About phone y toca Build number siete veces. Cuando regreses a la pantalla anterior, verás Developer options.

Una vez que tu dispositivo esté configurado y conectado mediante USB, puedes instalar tu app mediante las tareas de instalación de Gradle mencionadas antes o la herramienta adb:

adb -d install path/to/your_app.apk

Todos los APK compilados se almacenan en project_name/module_name/build/outputs/apk/.

Para obtener más información, consulta Ejecutar apps en un dispositivo de hardware.

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!

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)