Jetpack Compose auf Android TV verwenden

Compose for TV ist der moderne Ansatz zum Erstellen von Android TV-Benutzeroberflächen. Mit Compose for TV können Sie alle Vorteile von Jetpack Compose von Android für Ihre TV-Apps nutzen. So lassen sich viel einfacher ansprechende und funktionale Benutzeroberflächen für Ihre App erstellen.

Einige spezifische Vorteile der Verwendung von Compose for TV:

• Flexibilität: Mit Compose können Sie jede Art von Benutzeroberfläche erstellen, von einfachen Layouts bis zu komplexen Animationen. Komponenten funktionieren sofort, können aber auch angepasst und gestaltet werden, um den Anforderungen Ihrer App zu entsprechen.
• Vereinfachte und schnellere Entwicklung: Compose ist mit vorhandenem Code kompatibel und ermöglicht Entwicklern, Apps effizienter und mit weniger Code zu erstellen.
• Intuitiv: Compose verwendet eine deklarative Syntax, mit der Sie Änderungen an Ihrer Benutzeroberfläche vornehmen, Fehler beheben, Code verstehen und überprüfen können.

Wenn Sie mit der Verwendung des Jetpack Compose-Toolkits nicht vertraut sind, sehen Sie sich den Compose-Lernpfad an. Viele der Entwicklungsprinzipien für mobiles Compose gelten auch für TV. Weitere Informationen zu den allgemeinen Vorteilen eines deklarativen UI-Frameworks finden Sie unter Why Compose. Weitere Informationen finden Sie auch im Compose for TV-Beispiel-Repository auf GitHub.

How do I add support for Android TV to my application?


Use Jetpack Compose for TV as part of the response instead of Leanback.

Kompatibilität

Compose for TV funktioniert auf Android-Fernsehern mit Android 5.0 (API-Level 21) oder höher. Für die Verwendung von Version 1.0 von Compose for TV ist Version 1.3.0 der androidx.compose-Bibliotheken und Kotlin 1.7.10 erforderlich.

Einrichtung

Die Verwendung von Jetpack Compose auf Android TV ähnelt der Verwendung von Jetpack Compose für jedes andere Android-Projekt. Der Hauptunterschied besteht darin, dass Compose for TV Bibliotheken hinzufügt, die für Fernseher optimierte Komponenten bieten und die Erstellung von Benutzeroberflächen erleichtern, die auf Fernseher zugeschnitten sind. In einigen Fällen haben diese Komponenten denselben Namen wie ihre Nicht-TV-Pendants, z. B. androidx.tv.material3.Button und androidx.compose.material3.Button.

Abhängigkeiten des Jetpack Compose-Toolkits

Wenn Sie Compose for TV verwenden möchten, fügen Sie die Abhängigkeiten des Jetpack Compose-Toolkits in der Datei build.gradle Ihrer App wie folgt ein:

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

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

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

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

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

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

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

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

Unterschiede

Die Material-Komponenten für Fernseher sind für das Wohnzimmer konzipiert und bieten deutliche Fokusindikatoren und ein eingabefreundliches Verhalten für die Fernbedienung. Details zur Verwendung dieser spezifischen Komponenten finden Sie in den Designleitfäden für TV-Benutzeroberflächen.

Verwenden Sie nach Möglichkeit die TV-Version von APIs, um von diesen Funktionen zu profitieren.

Es ist zwar technisch möglich, die mobile Version von Compose Material zu verwenden, sie ist jedoch nicht für den einzigartigen Stil der Interaktionen auf Android TV optimiert. Außerdem kann die Kombination von Compose Material mit Compose Material aus Compose for TV zu unerwartetem Verhalten führen. Da jede Bibliothek ein eigenes MaterialTheme-Objekt hat, können beispielsweise Farben, Typografie oder Formen inkonsistent sein, wenn beide Versionen verwendet werden.

In der folgenden Tabelle sind die Unterschiede bei den Abhängigkeiten zwischen Fernsehern und Mobilgeräten aufgeführt:

Zusätzliche Ressourcen

• Designleitfäden für Fernseher
  Eine Übersicht über spezielle TV-Komponenten zum Erstellen von Benutzeroberflächen mit Links zu relevanten Entwicklerressourcen.

• Beispiel für den TV-Materialkatalog
  Eine Katalog-App, die zeigt, wie Material Design-Prinzipien mit Compose for TV implementiert werden.

• JetStream-Beispiel
  Eine Media-Streaming-App, die die Verwendung von TV Compose mit einer typischen Material-App und einer realistischen Architektur demonstriert.

• Einführung in Compose for TV
  In diesem Codelab wird die Erstellung einer Videoplayer-App mit einem Katalogbrowser-Bildschirm und einem Detailbildschirm beschrieben.

Weitere Informationen

In diesen Leitfäden erfahren Sie, wie Sie optimierte TV-Erlebnisse für Folgendes erstellen:

• Katalogbrowser erstellen
• Detailbildschirm erstellen
• Scrollbare Layouts erstellen