把ShizuStore装进电视:Android TV适配与遥控器导航实战

原创2026-11-16 14:22:321,850 阅读

把ShizuStore装进电视:Android TV适配与遥控器导航实战

ShizuStore 是一款免费的 Android 应用商店,专注于发现、安装和更新 Shizuku 应用,APK 直接从开发者的官方来源下载。如果你想在 Android TV 电视盒或智能电视上运行这款应用商店,只靠遥控器就能浏览和管理应用,这篇指南将带你了解 ShizuStore 的 Android TV 适配方案与遥控器导航的实战细节。📺

为什么要在电视上跑应用商店?

  • 电视也是 Android 设备:电视盒子和多数智能电视运行 Android TV,可以安装第三方 APK,但没有触摸屏,一切操作依赖遥控器
  • 应用发现与更新不只属于手机:ShizuStore 按分类组织应用并支持定时检查更新,装在电视上,它就是一个随时待命的"Shizuku 应用库"
  • 一个 APK,手机电视两用:ShizuStore 通过清单声明支持 Android TV,同一份 APK 手机可装、电视也可装,手机上显示图标,电视启动器则显示横幅

Android TV 适配清单:3 个关键声明

ShizuStore 的电视适配完全靠清单声明 + 一张横幅图实现,核心在 AndroidManifest.xml:

声明 作用
uses-feature + android.software.leanback(required="false") 声明"可用于 Android TV",设为可选,不影响手机安装
uses-feature + android.hardware.touchscreen(required="false") 声明没有触摸屏也能运行
MainActivity 的 LEANBACK_LAUNCHER 分类 让应用出现在电视启动器中(电视不认普通的 LAUNCHER)
android:banner="@drawable/tv_banner" 电视上焦点落在应用时显示的 16:9 横幅

核心其实就两行:

<uses-feature android:name="android.software.leanback" android:required="false" />
<!-- MainActivity 的 intent-filter 内 -->
<category android:name="android.intent.category.LEANBACK_LAUNCHER" />

电视横幅素材位于 artwork/androidtv/,实际打进包中的资源是 tv_banner.png(320×180)。

遥控器导航实战:4 个让遥控器真正好用的细节

装进电视后,遥控器操作体验如何?ShizuStore 在代码里做足了功课:

1. 每个控件都有可见的焦点环

Theme.kt 为整个应用注入了内嵌焦点环配置:所有支持波纹效果的按钮、列表行、输入框,在方向键移动焦点时都会显示清晰的高亮描边,你随时知道"当前选中的是哪个",不用猜。

2. 启动时自动聚焦当前页签

MainScreen.kt 会检测"是否使用遥控器/硬件键盘"(键盘类型非空或设备为电视),启动时直接把焦点放到当前底部页签上——按下 OK 键即可直接进入列表,不需要先"找"焦点。

3. 搜索框不再乱弹软键盘

手机上聚焦搜索框总会弹出虚拟键盘,电视上这会非常碍事。AppListScreen.kt 会检查硬件键盘:只有不存在物理键盘时才自动弹出软键盘。给电视接一个蓝牙键盘,搜索体验就和手机几乎一样了。

4. 截图查看器也能用方向键

详情页的截图查看器中,关闭、上一张、下一张按钮均可获焦,用方向键就能一张张翻看应用截图,无需触屏。

遥控器按键速查:

按键 作用
上 / 下 / 左 / 右 移动焦点环,切换列表行、按钮和页签
OK(中间键) 确认:打开应用、开始安装、切换页签
返回键 返回上一级(应用详情 → 列表 → 首页)
蓝牙键盘 搜索物理输入,配合焦点导航效率更高

电视上手安装:3 步搞定

  1. 获取 APK:从 ShizuStore 的发布页下载 APK(ShizuStore 自身也作为可安装应用列在自己的商店里)
  2. 安装到电视:首次安装需在电视设置中允许"安装未知来源应用";安装后电视启动器会出现带紫色横幅的应用入口
  3. 遥控器浏览与安装:方向键移动焦点,OK 打开详情页。安装第三方应用时电视会弹出系统安装确认界面,按 OK 确认即可完成。再在设置中打开"定时检查更新",Shizuku 应用的更新会在后台自动处理,坐在沙发上不用动手。💡

注意:电视上通常没有 Shizuku 环境,安装会走系统标准确认流程,比手机一键安装多一步确认,但完全可用。

手机 vs 电视:体验对照一览

能力 手机 Android TV
启动入口 应用图标 电视启动器横幅(tv_banner)
输入方式 触屏 方向键 + OK / 蓝牙键盘
搜索 虚拟键盘 物理键盘输入,不弹软键盘
安装应用 可用 Shizuku 静默安装 系统安装确认界面
更新检查 定时后台检查 相同,建议保持仅 Wi-Fi 后台活动

源码位置速查

想深入看 Android TV 适配和遥控器导航的实现,可以从这些文件入手:

ShizuStore 的电视支持是一次"低成本、高回报"的适配:几行清单声明、一张横幅图,外加一系列焦点细节处理,就换来一个可以完全坐在沙发上操作的应用商店。🎬

登录后查看全文
ShizuStore