【亲测免费】 Android TV Leanback 框架入门教程

本教程将指导你了解并开始使用 androidtv-Leanback 开源项目，这是一个由 Google 提供的用于构建 Android TV 应用的库。

1. 项目目录结构及介绍

项目根目录

• app/: 示例应用模块，包含了 Leanback 库的使用示例。
  • src/: 应用的源代码。
    • main/: 主模块资源和代码。
      • java/com/example/android/tvodemo/: 包含主Activity和其他相关类。
      • res/: 应用资源文件，包括布局、图标等。
  • build.gradle: 应用模块的构建脚本。
• library/: Leanback 库本身，包含了核心组件和视图。
  • src/: 库的源代码。
    • main/: 核心组件和视图的 Java 文件。
  • build.gradle: 库模块的构建脚本。
• settings.gradle: 项目配置，包含了所有模块的引用。

重点文件/模块

• app/src/main/java/com/example/android/tvodemo/BrowseSupportFragment.java: 示例了如何使用 BrowseFragment 来展示目录和内容。
• app/src/main/res/layout/activity_main.xml: 主Activity的布局文件，通常包含 BrowseFragment 或其他 Leanback 相关组件。

2. 项目的启动文件介绍

启动文件是 app/src/main/java/com/example/android/tvodemo/SampleApplication.java 中的 SampleApplication 类。这个类是应用的入口点，并设置了全局的应用配置。然而，真正执行 Leanback 示例代码是在 BrowseSupportFragment 类中。

BrowseSupportFragment 是一个扩展自 Leanback 的 BaseBrowserFragment，它展示了如何构造一个典型的浏览界面，左侧是分类导航，右侧展示选定分类的内容。onCreate() 方法里初始化了数据和视图，onCreateLoader() 和 onLoadFinished() 处理数据加载。

3. 项目的配置文件介绍

Gradle 构建文件

• app/build.gradle: 此文件定义了应用模块的依赖和构建设置。其中，包含了 Leanback 库的依赖：

  dependencies {
      implementation 'androidx.leanback:leanback:1.0.0'
      // ...
  }
  

• library/build.gradle: 库模块的构建脚本，通常用来指定库的编译目标和版本。

AndroidManifest.xml

• app/src/main/AndroidManifest.xml: 应用的清单文件，声明了应用的基本信息、权限和其他元数据。对于 Leanback 应用，可能需要声明以下几项：

  <uses-feature android:name="android.software.leanback" android:required="true"/>
  <application ...>
      <activity android:name=".MainActivity">
          <intent-filter>
              <action android:name="android.intent.action.MAIN"/>
              <category android:name="android.intent.category.LAUNCHER"/>
              <category android:name="android.intent.category.LEANBACK_LAUNCHER"/>
          </intent-filter>
      </activity>
      <!-- ... -->
  </application>
  

  上述代码表明应用支持 Leanback 功能，并设置了启动Activity。

有了这些基本信息，你现在可以克隆项目，导入 Android Studio 并开始探索 Leanback 库在实际项目中的应用。记得先确保你的 Android SDK 工具和构建工具是最新的，以便顺利编译和运行示例应用。祝你学习愉快！