Android Studio: tu primera pantalla con Kotlin y Compose
Crea un proyecto, añade un contador y comprueba pulsaciones, rotación y tamaño de texto antes de ampliar la aplicación.
Un contador permite recorrer lo esencial de una primera app: proyecto, interfaz, estado y prueba. Vas a crear una pantalla con Kotlin y Compose en Android Studio, ejecutarla y comprobar qué ocurre al interactuar o girar el dispositivo.
Qué necesitas y qué crea cada herramienta
Android Studio es el entorno oficial. El SDK aporta herramientas y APIs; Gradle y Android Gradle Plugin construyen el proyecto; el emulador ejecuta un dispositivo virtual. La vista previa ayuda a diseñar, pero no sustituye ejecutar la app.
La iniciación oficial para un proyecto nuevo utiliza Kotlin y Jetpack Compose. Java sigue formando parte del ecosistema y de muchos proyectos existentes. Un tutorial de consola Java no se convierte automáticamente en una app Android.
Crea una base que compile antes de modificarla
- Descarga Android Studio desde su web oficial y revisa los requisitos del equipo, incluido el emulador si lo usarás.
- Crea un proyecto con la plantilla Empty Activity de Compose. Anota nombre, paquete, ubicación y Minimum SDK.
- Espera a que termine la sincronización de Gradle y resuelve los errores antes de cambiar código.
- Ejecuta la plantilla en un dispositivo virtual o teléfono preparado para desarrollo. Confirma que aparece la pantalla inicial.
Las plantillas pueden cambiar. Conserva las versiones y estructura que genera una plantilla actual compatible; no mezcles números de Gradle, plugins y SDK tomados de artículos distintos.
| Ajuste | Qué controla |
|---|---|
| Minimum SDK | Versión mínima de Android admitida para instalar. |
| Compile SDK | APIs disponibles al compilar. |
| Target SDK | Versión de comportamiento de Android que la app declara como objetivo. |
Añade un contador en Compose
En MainActivity.kt conserva la declaración package y los imports de la plantilla. Añade los imports del ejemplo si faltan y la función Contador fuera de la clase MainActivity. Evita duplicar imports.
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.Button
import androidx.compose.material3.Text
import androidx.compose.runtime.Composable
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
import androidx.compose.ui.Modifier
import androidx.compose.ui.unit.dp
@Composable
fun Contador(modifier: Modifier = Modifier) {
var cuenta by rememberSaveable { mutableStateOf(0) }
Column(
modifier = modifier.padding(24.dp),
verticalArrangement = Arrangement.spacedBy(16.dp)
) {
Text("Pulsaciones: $cuenta")
Button(onClick = { cuenta += 1 }) {
Text("Sumar una")
}
}
}En setContent conserva el tema. Si la plantilla usa Scaffold, sustituye su contenido de ejemplo por Contador y pásale el padding que proporciona. Así evitas poner contenido bajo las barras del sistema.
Scaffold(modifier = Modifier.fillMaxSize()) { innerPadding ->
Contador(modifier = Modifier.padding(innerPadding))
}Este fragmento usa Scaffold de Material 3, Modifier y las extensiones fillMaxSize y padding de androidx.compose.foundation.layout. Conserva o añade esos imports. La vista previa puede llamar a Contador() dentro del tema.
Qué sucede al pulsar
cuenta conserva el número. mutableStateOf permite que Compose observe el cambio y vuelva a representar el texto que depende de él. El botón incrementa dentro de onClick. No necesitas buscar un elemento de pantalla y reemplazar su texto a mano.
rememberSaveable conserva este pequeño estado mediante el mecanismo de estado guardado. Permite restaurarlo, por ejemplo, al recrear la actividad tras una rotación. No es una base de datos ni promete guardarlo después de cualquier cierre o borrado.
Comprueba comportamiento y presentación
| Acción | Qué observar |
|---|---|
| Abre la app | Pulsaciones: 0 y Sumar una. |
| Pulsa tres veces | Pulsaciones: 3. |
| Gira el dispositivo | Sigue en 3 al recrearse y restaurarse la actividad. |
| Aumenta el tamaño de fuente | Texto y botón utilizables, sin solaparse. |
| Usa lector de pantalla | Texto y botón con nombres comprensibles. |
Si la pantalla no cambia, comprueba que el botón modifica el estado leído por el texto. Si no se abre, consulta el error de compilación o Logcat. Un breakpoint dentro de onClick permite comprobar si llega la acción y qué valor cambia.
Ejercicio: volver a cero
Añade un segundo botón debajo del primero para reiniciar. Debe mostrar una etiqueta clara y modificar el mismo estado.
Solución
Button(onClick = { cuenta = 0 }) {
Text("Reiniciar")
}Pulsa Sumar una dos veces y después Reiniciar: debe volver a cero. Gira y comprueba que se conserva ese nuevo valor.
De este ejercicio a una aplicación real
Para conservar datos entre usos necesitas almacenamiento apropiado. Para varias pantallas, navegación. Para red, estados de carga y error. Añade una necesidad cada vez y comprueba cómo se recupera la app de interrupciones.
Una ejecución local demuestra el comportamiento probado. Distribuir exige además firma, pruebas, requisitos del canal y revisión de los datos que maneja la aplicación.


