把ShizuStore装进电视:Android TV适配与遥控器导航实战
把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 步搞定
- 获取 APK:从 ShizuStore 的发布页下载 APK(ShizuStore 自身也作为可安装应用列在自己的商店里)
- 安装到电视:首次安装需在电视设置中允许"安装未知来源应用";安装后电视启动器会出现带紫色横幅的应用入口
- 遥控器浏览与安装:方向键移动焦点,OK 打开详情页。安装第三方应用时电视会弹出系统安装确认界面,按 OK 确认即可完成。再在设置中打开"定时检查更新",Shizuku 应用的更新会在后台自动处理,坐在沙发上不用动手。💡
注意:电视上通常没有 Shizuku 环境,安装会走系统标准确认流程,比手机一键安装多一步确认,但完全可用。
手机 vs 电视:体验对照一览
| 能力 | 手机 | Android TV |
|---|---|---|
| 启动入口 | 应用图标 | 电视启动器横幅(tv_banner) |
| 输入方式 | 触屏 | 方向键 + OK / 蓝牙键盘 |
| 搜索 | 虚拟键盘 | 物理键盘输入,不弹软键盘 |
| 安装应用 | 可用 Shizuku 静默安装 | 系统安装确认界面 |
| 更新检查 | 定时后台检查 | 相同,建议保持仅 Wi-Fi 后台活动 |
源码位置速查
想深入看 Android TV 适配和遥控器导航的实现,可以从这些文件入手:
- 清单声明(leanback、banner、LEANBACK_LAUNCHER):AndroidManifest.xml
- 遥控器输入检测与页签自动聚焦:MainScreen.kt
- 全局焦点环主题:Theme.kt
- 搜索框键盘检测:AppListScreen.kt
- 截图查看器焦点处理:ScreenshotGallery.kt
- 项目架构与 TV 适配背景:docs/HANDOFF.md
ShizuStore 的电视支持是一次"低成本、高回报"的适配:几行清单声明、一张横幅图,外加一系列焦点细节处理,就换来一个可以完全坐在沙发上操作的应用商店。🎬