参考 TV 应用

某些类别的 Android TV 设备（例如平板电视和运营商机顶盒）需要安装可播放电视直播内容的 TV 应用。参考应用的源代码可在 Android 开源项目中获取。

本文总结了如何基于 Live TV 为您的 Android 电视设备构建和自定义系统 TV 应用。

依赖项

Live TV 应用是 TV 输入框架 (TIF) 的一个组件，不能独立于其他 TIF 组件使用。应用的不同分支所依赖的 Android API 级别也不同：

分支	目标 API 级别	最低 API 级别
main	24 (Android 7.0)	23
android-live-tv	23 (Android 6.0)	21
android-live-tv-l-mr1	22 (Android 5.1)	21

获取源代码

首先，请从 Git 中选择一个 Live TV 版本。以下说明适用于当前版本的 Live TV。如需使用早期版本，请切换到上表中列出的某个 Git 分支。

mkdir live-tv && cd live-tv
repo init -u https://android.googlesource.com/platform/manifest -b main
repo sync -j8 -c

构建

若要构建 Live TV 代码，请运行以下代码：

. build/envsetup.sh
tapas LiveTv x86
make LiveTv

推送

使用以下代码将 Live TV 推送到测试设备：

adb install -r -d $OUT/system/priv-app/LiveTv/LiveTv.apk

如果您想让 Live TV 应用拥有系统权限，请在首次安装时使用以下代码将该应用推送到 /system/priv-app：

adb push $OUT/system/priv-app/LiveTv/LiveTv.apk  /system/priv-app/LiveTv/

测试

将 Live TV 安装到设备上后，除了对该 TV 应用运行兼容性测试套件和 CTS 验证程序测试外，还可以使用下文中的测试来测试该应用是否已正确集成。您必须连接设备或模拟器才能运行所有类型的测试。

单元测试

adb shell logcat -c
m LiveTv TVTestInput TVUnitTests -j20 &&\
adb install -r -d $OUT/system/priv-app/LiveTv/LiveTv.apk &&\
adb install -r -d $OUT/system/app/TVTestInput/TVTestInput.apk && \
adb install -r -d $OUT/data/app/TVUnitTests/TVUnitTests.apk && \
adb shell pm clear com.android.providers.tv && \
adb shell pm clear com.android.tv && \
adb shell am instrument \
  -e testSetupMode unit \
  -w com.android.tv.testinput/.instrument.TestSetupInstrumentation &&\
adb shell input keyevent KEYCODE_HOME &&\
adb shell am instrument \
  -w 'com.android.tv.tests/android.support.test.runner.AndroidJUnitRunner'

功能测试

adb shell logcat -c
m LiveTv TVTestInput TVFuncTests -j20 &&\
adb install -r -d $OUT/system/priv-app/LiveTv/LiveTv.apk &&\
adb install -r -d $OUT/system/app/TVTestInput/TVTestInput.apk && \
adb install -r -d $OUT/data/app/TVFuncTests/TVFuncTests.apk && \
adb shell pm clear com.android.providers.tv && \
adb shell pm clear com.android.tv && \
adb shell am instrument \
  -e testSetupMode func \
  -w com.android.tv.testinput/.instrument.TestSetupInstrumentation &&\
adb shell input keyevent KEYCODE_HOME &&\
adb shell am instrument \
  -w 'com.android.tv.tests.ui/android.support.test.runner.AndroidJUnitRunner'

卡顿测试

卡顿测试会检查是否存在丢帧和呈现延迟的情况。

adb shell logcat -c
m LiveTv TVTestInput TVJankTests -j20 &&\
adb install -r -d $OUT/system/priv-app/LiveTv/LiveTv.apk &&\
adb install -r -d $OUT/system/app/TVTestInput/TVTestInput.apk &&\
adb install -r -d $OUT/data/app/TVJankTests/TVJankTests.apk &&\
adb shell pm clear com.android.providers.tv &&\
adb shell pm clear com.android.tv &&\
echo "Creating a lot of channels and EPG data, this may take a while" &&\
adb shell am instrument \
  -e testSetupMode jank \
  -w com.android.tv.testinput/.instrument.TestSetupInstrumentation &&\
adb shell input keyevent KEYCODE_HOME &&\
adb shell am instrument \
  -w 'com.android.tv.tests.jank/android.support.test.runner.AndroidJUnitRunner'