遷移至 Compose for TV

如要從 Leanback UI 工具包遷移至 Compose for Android TV，請按照下列步驟操作：

  • 評估目前的 Leanback 實作：找出您使用的元件 (包括預先建構的片段中提供的元件)，並瞭解 UI 的結構和資料在應用程式中的流動方式。

  • 將 TV 應用程式的個別畫面遷移至 Compose，以便逐步瞭解並適應 Compose。

    • 雖然您可以在同一個應用程式中同時使用 Leanback 和 Compose，以便逐步遷移，但建議您一開始就逐步取代整個片段，目標是將 TV 應用程式轉換為單一活動。

    • 從小額開始出價。請勿一次遷移所有內容。請從較小的元件 (例如設定或帳戶畫面) 開始，然後逐步完成整個應用程式。

    • 請參閱「資源」一節中列出的資源說明文件和範例。

  • 使用 Jetpack 程式庫，善用 Compose for TV 的專屬元件。請參閱設計指南，瞭解如何自訂及擴充現成的可組合項，打造精美的電視 UI。

  • 調整資料和狀態管理方式，以支援 Compose 宣告式程式設計典範。為了進行調整，您可能需要變更應用程式中資料和狀態的管理方式。請使用 ViewModel 和 Jetpack Compose 內部狀態管理機制，管理應用程式中的資料和狀態。

  • 在遷移應用程式中較複雜的部分時，請測試並反覆進行。

如有任何錯誤，請與 Stack Overflow 上的活躍 Android 開發人員社群互動，或透過我們的公開錯誤追蹤器提交錯誤。

資源

無論您是 Compose 新手，還是已在遷移至 Compose 的過程中，我們都提供大量資源，協助您瞭解使用新式 Android 開發工具包 Jetpack Compose 建構 TV UI 的最佳做法：

上一頁
打造電視版面配置