Cómo usar Jetpack Compose en Android TV

Compose para TV es el enfoque moderno para crear interfaces de usuario de Android TV. Compose para TV desbloquea todos los beneficios de Jetpack Compose de Android para tus apps para TV, lo que facilita mucho la compilación de IU atractivas y funcionales para tu app.

Estos son algunos beneficios específicos de usar Compose para TV:

• Flexibilidad: Compose se puede usar para crear cualquier tipo de IU, desde diseños simples hasta animaciones complejas. Los componentes funcionan de inmediato, pero también se pueden personalizar y adaptar a las necesidades de tu app.
• Desarrollo simplificado y acelerado: Compose es compatible con el código existente y permite que los desarrolladores compilen apps de manera más eficiente con menos código.
• Intuitiva: Compose usa una sintaxis declarativa que te permite realizar cambios en la IU, así como depurar, comprender y revisar el código.

Si nunca usaste el kit de herramientas de Jetpack Compose, consulta la ruta de aprendizaje de Compose. Muchos de los principios de desarrollo de Compose para dispositivos móviles también se aplican a la TV. Consulta Por qué Compose para obtener más información sobre las ventajas generales de un framework de IU declarativo. Si quieres obtener más información, consulta también el repositorio de muestras de Compose para TV en GitHub.

Compatibilidad

Compose para TV funciona en Android TV con Android 5.0 (nivel de API 21) o versiones posteriores. El uso de la versión 1.0 de Compose para TV requiere la versión 1.3.0 de las bibliotecas androidx.compose y Kotlin 1.7.10.

Configuración

El uso de Jetpack Compose en Android TV es similar a usar Jetpack Compose para cualquier otro proyecto de Android. La diferencia principal es que Compose para TV agrega bibliotecas que ofrecen componentes optimizados para TV y facilitan la creación de interfaces de usuario personalizadas para TV. En algunos casos, esos componentes comparten el mismo nombre que sus equivalentes que no son para TV, como androidx.tv.material3.Button y androidx.compose.material3.Button.

Dependencias del kit de herramientas de Jetpack Compose

Si quieres usar Compose para TV, incluye las dependencias del kit de herramientas de Jetpack Compose en el archivo build.gradle de tu app de la siguiente manera:

dependencies {
   val composeBom = platform("androidx.compose:compose-bom:2024.06.00")
   implementation(composeBom)

   // General compose dependencies.
   implementation("androidx.activity:activity-compose:1.9.0")

   implementation("androidx.compose.ui:ui-tooling-preview")
   debugImplementation("androidx.compose.ui:ui-tooling")

   // Compose for TV dependencies.
   implementation("androidx.tv:tv-foundation:1.0.0-alpha10")
   implementation("androidx.tv:tv-material:1.0.0-beta01")
}

dependencies {
   def composeBom = platform('androidx.compose:compose-bom:2024.06.00')
   implementation composeBom

   // General compose dependencies.
   implementation 'androidx.activity:activity-compose:1.9.0'

   implementation 'androidx.compose.ui:ui-tooling-preview'
   debugImplementation 'androidx.compose.ui:ui-tooling'

   // Compose for TV dependencies.
   implementation 'androidx.tv:tv-foundation:1.0.0-alpha10'
   implementation 'androidx.tv:tv-material:1.0.0-beta01'
}

Qué cambió

Usa la versión para TV de las APIs siempre que sea posible. Si bien es técnicamente posible usar la versión para dispositivos móviles de Compose Material, no está optimizada para el estilo único de las interacciones en Android TV. Además, combinar Compose Material con Compose Material de Compose para TV puede generar un comportamiento inesperado. Por ejemplo, debido a que cada biblioteca tiene su propio objeto MaterialTheme, existe la posibilidad de que los colores, la tipografía o las formas sean inconsistentes si se usan ambas versiones.

En la siguiente tabla, se describen las diferencias de dependencia entre la TV y los dispositivos móviles:

Recursos adicionales

• Ejemplo de catálogo de material de TV
  Una app de catálogo que muestra cómo implementar los principios de Material Design con Compose para TV.

• Ejemplo de JetStream
  Una app de transmisión de contenido multimedia que demuestra el uso de TV Compose con una app típica de Material y una arquitectura real.

• Introducción a Compose para TV
  En este codelab, se explica cómo compilar una app de reproductor de video con una pantalla de navegador de catálogos y una pantalla de detalles.

Lecturas adicionales

Explora estas guías y descubre cómo crear excelentes experiencias optimizadas para TV para:

• Pantalla de navegación del catálogo
• Pantalla de detalles