Crea y ejecuta tu primera app para Android

1. Introducción

En este codelab, crearás tu primera app para Android (Happy Birthday) a partir de una plantilla de apps básica de Android Studio. También explorarás la apariencia de un proyecto de Android y aprenderás a usar diferentes ventanas en Android Studio.

Requisitos previos

Conocimientos básicos para configurar, ajustar y usar aplicaciones, como un procesador de texto o una hoja de cálculo

Qué aprenderás

Cómo crear un proyecto de app para Android en Android Studio a partir de una plantilla

Qué compilarás

Una app básica para Android a partir de una plantilla

Requisitos

Una computadora con Android Studio instalado

2. Crea tu primera app

En esta tarea, crearás una app para Android a partir de una plantilla de proyecto de Android Studio.

Plantillas de proyectos

En Android Studio, una plantilla de proyecto es una app para Android que tiene todos los componentes necesarios, pero que no ejecuta muchas tareas en sí. Tiene por objetivo ayudarte a comenzar más rápido y ahorrarte algo de trabajo. Algunos ejemplos de plantillas de Android Studio son una app con un mapa y una app con varias pantallas.

Cómo crear un proyecto de Actividad Vacía

Estos pasos te ayudarán a crear un nuevo proyecto en Android Studio con la plantilla Empty Activity para tu app nueva.

Haz clic en el ícono de Android Studio para iniciar el entorno (si no está abierto aún):

Se abrirá la ventana de bienvenida Welcome to Android Studio. Haz clic en New project.

Se abrirá la ventana New Project con una lista de plantillas que ofrece Android Studio.

Haz clic en las pestañas de la parte superior y desplázate por las plantillas para tener una idea de lo que podrías hacer. Hay plantillas para muchos tipos de dispositivos distintos (como teléfonos, tablets y relojes) y para diferentes tipos de apps: con pantallas en las que es posible desplazarse, con mapas y con navegación sofisticada.
En la parte superior izquierda de la ventana, haz clic en la pestaña Phone and Tablet.
En la fila superior, haz clic en la plantilla Empty Activity para armar tu proyecto con ella.

La plantilla Empty Activity es la más simple que se puede usar para crear una app. Tiene una sola pantalla y muestra un mensaje simple: "Hello World!".

En la parte inferior de la ventana, haz clic en Next. Se abrirá el diálogo New Project.

Configura tu proyecto como se indica a continuación:

Name es el nombre de tu app. En el cuadro que se encuentra debajo de Name, ingresa Happy Birthday como nombre de tu proyecto.
Package name es el nombre que usa el sistema Android para identificar tu app de forma exclusiva. Por lo general, el valor predeterminado es el nombre de tu organización seguido del nombre de la app, todo en minúsculas (en este caso, "com.example.happybirthday").
En Save location se indica la ubicación en la que se guardan todos los archivos relacionados con tu proyecto. Toma nota de esa ubicación para encontrar tus archivos. Por ahora, no necesitas modificar la ubicación de guardado.
En Language, se define el lenguaje de programación que quieres usar para tu proyecto. Asegúrate de seleccionar Kotlin en Language.
Minimum SDK indica la versión mínima de Android en la que se puede ejecutar tu app. Selecciona API 19: Android 4.4 (KitKat) en la lista desplegable.

Consulta la nota debajo de Minimum SDK, que informa la cantidad de dispositivos en los que se puede ejecutar tu app con el nivel de API elegido. Si te interesa, haz clic en el vínculo Help me choose para ver una lista de diferentes versiones de Android, como se muestra a continuación. Luego, vuelve a la ventana New Project.

En la ventana Create New Project, asegúrate de que no esté marcada la opción Use legacy android.support libraries. Haz clic en el signo de interrogación para obtener más detalles sobre este tema.
Haz clic en Finish.

Android Studio abrirá el proyecto y todos sus archivos.

Cuando abras Android Studio por primera vez, verás tres ventanas:

(1) En la ventana Project, se muestran los archivos y las carpetas de tu proyecto.

(2) En la ventana Editing, se edita el código.

(3) En la ventana What's New, encontrarás novedades y sugerencias útiles.

En la esquina inferior derecha de Android Studio, aparece una barra de progreso o un mensaje que indica si aún se está configurando tu proyecto. Por ejemplo:

Espera hasta que Android Studio termine de configurar tu proyecto. En la esquina inferior izquierda, verás un mensaje que te avisará cuando el proyecto esté completo, como el que se muestra a continuación.

3. Ejecuta tu app en un dispositivo virtual (emulador)

En esta tarea, usarás el Administrador de dispositivos para crear una versión de software (un emulador) de un dispositivo móvil y ejecutarla en tu computadora. Un dispositivo virtual, o emulador, simula la configuración de un tipo de dispositivo Android determinado, como un teléfono, que puede ser cualquier teléfono o tablet que ejecute las versiones de sistema Android que elijas. Luego, usarás el dispositivo virtual para ejecutar la app que creaste con la plantilla Empty Activity.

Cómo crear un dispositivo virtual de Android (AVD)

El primer paso para ejecutar un emulador en tu computadora es crear una configuración para el dispositivo virtual.

En la barra de menú de Android Studio, selecciona Tools > Device Manager.

El Administrador de dispositivos se muestra en la siguiente imagen. (Si ya creaste un dispositivo virtual, aparecerá en la lista).

Haz clic en Create device.

Aparecerá la ventana Select Hardware.

La ventana Select Hardware muestra una lista de dispositivos configurados previamente, organizados por categoría en Category, entre los que puedes elegir. La tabla proporciona una columna que muestra el tamaño de visualización (Size), la resolución de pantalla en píxeles (Resolution) y la densidad de píxeles (Density) para cada dispositivo.

Selecciona la categoría Phone.
Selecciona un teléfono (por ejemplo, Pixel 5) y haz clic en Next. Puedes elegir cualquier teléfono, pero para este codelab selecciona uno de los dispositivos más recientes.

Aparecerá la ventana System Image. Aquí, elige la versión del sistema Android que se ejecutará en tu dispositivo virtual. Esto te permitirá probar tu app en diferentes versiones del sistema.

En la pestaña Recommended, selecciona S como la versión del sistema Android que se ejecutará en el dispositivo virtual. Esta era la versión de Android más reciente que había disponible cuando se escribió esta guía, pero puedes elegir cualquier versión posterior que sea estable. Aquí puedes consultar la lista de versiones estables.

Presiona Siguiente.

Se abrirá la ventana Android Virtual Device (AVD), donde puedes seleccionar detalles de configuración adicionales para tu dispositivo.

En el campo AVD Name, ingresa un nombre para tu dispositivo virtual de Android. No modifiques lo demás.
Haz clic en Finish.

El nuevo dispositivo virtual se mostrará en la ventana Device Manager y estará listo para usarse.

Cómo ejecutar tu app en el dispositivo virtual

Pon Android Studio en primer plano, si aún no está allí.
En Android Studio, ve al menú desplegable del dispositivo virtual de la barra de herramientas (se verá similar al ejemplo que aparece a continuación) y, en la lista desplegable, selecciona el dispositivo virtual que creaste. (También puedes hacer clic en Run > Select Device.. y, luego, seleccionar tu dispositivo virtual entre los que se encuentran disponibles en la ventana emergente).
En Android Studio, selecciona Run > Run app o haz clic en el ícono Run ubicado en la barra de herramientas. El dispositivo virtual se encenderá e iniciará de la misma manera que un dispositivo físico. Según la velocidad de la computadora, este proceso puede tardar un poco.

Cuando tu app esté lista, se abrirá en el dispositivo virtual, como en la imagen que se muestra a continuación.

¡Bien hecho! Tu dispositivo virtual ya está listo y ejecutándose. Verás que ahora el título es "Happy Birthday" y que en la pantalla se muestra "Hello World!".

4. Busca los archivos de tu proyecto

Cuando configuras un proyecto, Android Studio crea una carpeta en tu computadora llamada AndroidStudioProjects para todos tus proyectos de Android. En la carpeta AndroidStudioProjects, también se crea una carpeta con el nombre de tu app (en este caso, HappyBirthday).

HappyBirthday es la carpeta de tu proyecto. Android Studio guarda en la carpeta del proyecto los archivos que crea y los que tú creas.

En Android Studio, observa la ventana Project ubicada a la izquierda. En la ventana Project, se muestran los archivos y las carpetas de tu proyecto.

Los archivos de la ventana Project están organizados de modo que faciliten la navegación entre los archivos del proyecto cuando escribes el código. Sin embargo, si accedes a los archivos desde un navegador, como Finder o Windows Explorer, la organización de la jerarquía es muy distinta.

En esta tarea, explorarás estas dos vistas diferentes de la jerarquía de las carpetas del proyecto.

En Android Studio, en la ventana Project, selecciona Android en el menú desplegable de la esquina superior izquierda.

Deberías ver una lista de archivos parecida a esta:

Esta vista y organización de tus archivos son útiles cuando escribes código para tu proyecto.

También puedes ver los archivos tal como aparecerían en un navegador de archivos, como Finder (para macOS) o Explorer (para Windows).

En el menú desplegable de la ventana Project, selecciona Project Source Files.

Verás que el título cambia al de la carpeta en la que se almacenan los archivos del proyecto.

Ahora puedes navegar entre los archivos del mismo modo que lo harías con cualquier explorador.

Para volver a la vista anterior, en la ventana Project, vuelve a seleccionar Android.

¡Excelente! Ahora puedes crear y ejecutar una app a partir de una plantilla y encontrar los archivos de tu proyecto.

5. Resumen

Para crear un proyecto nuevo, inicia Android Studio, haz clic en + Start a new Android Studio project, asigna un nombre a tu proyecto, selecciona una plantilla y completa los detalles.
Para crear un dispositivo virtual de Android (un emulador) que ejecute tu app, elige Tools > Device Manager y usa el Administrador de dispositivos para seleccionar un dispositivo de hardware y una imagen del sistema.
Para ejecutar tu app en un dispositivo virtual, asegúrate de haber creado uno, selecciónalo en el menú desplegable de la barra de herramientas y, luego, haz clic en el ícono Run de la barra de herramientas para ejecutar tu app.
Para encontrar los archivos de tu proyecto, selecciona Project Source Files en el menú desplegable de la ventana Project.