某些类别的 Android TV 设备(例如平板电视和运营商机顶盒)需要播放直播电视内容的电视应用程序。 Android 开源项目中提供了参考应用程序的源代码。
本页总结了如何为 Android 电视设备构建和自定义基于 Live TV 的系统电视应用程序。
依赖关系
Live TV 应用程序是TV 输入框架 (TIF)的一个组件,不能独立于其他 TIF 组件使用。应用程序的不同分支对 Android API 级别有不同的依赖关系:
分支 | 目标 API 级别 | 最低 API 级别 |
---|---|---|
main | 24(安卓7.0) | 23 |
android-live-tv | 23(安卓6.0) | 21 |
android-live-tv-l-mr1 | 22(安卓5.1) | 21 |
获取源码
首先,从 Git 选择直播电视版本。以下说明适用于当前版本的 Live TV。要使用早期版本,请切换到上表中列出的 Git 分支之一。
mkdir live-tv && cd live-tv
repo init -u https://android.googlesource.com/platform/manifest -b main
repo sync -j8 -c
建造
要构建直播电视代码,请运行:
. build/envsetup.sh
tapas LiveTv x86
make LiveTv
推
使用以下代码将直播电视推送到您的测试设备:
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 后,除了兼容性测试套件和电视应用程序的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'