遷移至 Compose for TV

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

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

  • 將 TV 應用程式的個別畫面遷移至 Compose，逐步學習及適應 Compose。

    • 您可以在同一個應用程式中使用 Leanback 和 Compose，逐步遷移應用程式，但請先一次替換整個片段，目標是將電視應用程式轉換為單一活動。

    • 從小型資料開始。請勿嘗試一次遷移所有內容。先從較小的元件開始，例如設定或帳戶畫面，然後逐步完成整個應用程式。

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

  • 利用 Compose for TV 的專用元件，使用 Jetpack 函式庫。請參閱設計指南，瞭解如何自訂及擴充可立即使用的可組合函式，建構美觀的 TV 使用者介面。

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

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

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

資源

無論您是剛接觸 Compose，還是已開始遷移至 Compose，我們的大量資源都能協助您學習如何運用新式 Android 開發工具包 Jetpack Compose，建構 TV UI 的最佳做法：

上一頁
打造電視版面配置