迁移到 Compose for TV

如需从 Leanback 界面工具包迁移到 Compose for Android TV,请按以下步骤操作:

  • 评估您当前的 Leanback 实现:确定您使用的组件(包括预构建 fragment 中提供的组件),了解界面的结构以及数据在应用中的流动方式。

  • 将 TV 应用的各个屏幕迁移到 Compose,以便您逐步学习和适应 Compose。

    • 虽然您可以在同一个应用中同时使用 Leanback 和 Compose 以实现渐进式迁移过程,但建议您先一次替换整个 fragment,以便将 TV 应用转换为单个 activity。

    • 先从小规模测试开始。请勿尝试一次迁移所有内容。从较小的组件(例如设置或账号界面)开始,逐步完成整个应用。

    • 请参阅资源部分中列出的资源中的文档和示例。

  • 使用 Jetpack 库利用 Compose for TV 中的专用组件。请参阅我们的设计指南,了解如何自定义和扩展现成的可组合项,以构建美观的 TV 界面。

  • 调整数据和状态管理,以支持 Compose 声明式编程范式。适应可能需要您更改在应用中管理数据和状态的方式。请使用 ViewModel 和 Jetpack Compose 内部状态管理机制来管理应用中的数据和状态。

  • 在迁移应用中更复杂的部分时,请测试并迭代

如需解决遇到的任何 bug,请与活跃的 Android Stack Overflow 开发者社区互动,或通过我们的公开 bug 跟踪器提交 bug。

资源

无论您是刚开始接触 Compose,还是正在迁移到 Compose,我们都提供了丰富的资源来帮助您学习使用现代 Android 开发工具包 Jetpack Compose 构建 TV 界面的最佳实践: