Programación

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.

Referencias visuales: Android Studio · Composición editorial.

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

  1. Descarga Android Studio desde su web oficial y revisa los requisitos del equipo, incluido el emulador si lo usarás.
  2. Crea un proyecto con la plantilla Empty Activity de Compose. Anota nombre, paquete, ubicación y Minimum SDK.
  3. Espera a que termine la sincronización de Gradle y resuelve los errores antes de cambiar código.
  4. 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.

Tres ajustes diferentes
AjusteQué controla
Minimum SDKVersión mínima de Android admitida para instalar.
Compile SDKAPIs disponibles al compilar.
Target SDKVersió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.

kotlin · Contador e imports necesarios

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.

kotlin · Contenido del Scaffold existente

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

Una prueba con resultados concretos
AcciónQué observar
Abre la appPulsaciones: 0 y Sumar una.
Pulsa tres vecesPulsaciones: 3.
Gira el dispositivoSigue en 3 al recrearse y restaurarse la actividad.
Aumenta el tamaño de fuenteTexto y botón utilizables, sin solaparse.
Usa lector de pantallaTexto 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
kotlin · Añadir dentro de Column

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.

Para seguir leyendo

Volver a UnaCosa