安装到手机或平板
根据设备类型选择官方发布的安装包：Android 手机和平板使用移动端 APK，电视使用 TV APK。首选项目发布页；网络不方便时，可尝试开发者提供的蒲公英备用分发入口。
- 将对应的 APK 下载到手机或平板，点击文件进行安装；如出现限制，请仅为可信下载应用开启安装授权。
- 首次进入应用时设定家长管理密码；随后再根据用途决定是否开放屏幕覆盖、使用记录等权限。
- 家长可在另一部设备上，与受控设备接入相同局域网，扫描屏幕二维码，并使用管理密码连接管理面板。
- 需要重新打开配对界面时，可在受控设备上连续点击学习页的标题五次；电视遥控器可尝试短按向上键五次，接着验证管理密码。
第一步：开启 ADB 调试
以下说明用于在 Android 电视上安装 TV 应用。建议先检查电视是否允许安装 APK；部分设备直接使用 U 盘更方便。
1. 找到开发者模式
进入电视的系统设置，在设备信息界面寻找版本号或内部版本号；多次点击（常见为七次）后，返回设置菜单检查是否出现开发者选项。
2. 允许调试
在开发者选项中打开 USB 调试。计划使用局域网连接的设备，还要按厂商设置打开网络 ADB 或无线调试功能。
3. 查询局域网地址
在网络设置里记下电视的 IP，例如 192.168.1.100。此处只是示例，实际操作必须使用电视显示的地址。
三种连接方式
| 方式 | 电视侧设置 | 电脑侧示例 |
|---|---|---|
| 无线网络 | 电视允许网络调试，确认实际 ADB 端口 | adb connect 192.168.1.100:5555 |
| 有线连接 | 开启 USB 调试，确认电视支持相应的数据连接 | 连接电脑后运行 adb devices |
| Android 11+ 配对模式 | 无线调试界面获得一次性配对码和配对端口 | adb pair 192.168.1.100:37861，配对完成后连接调试端口 |
unauthorized 时，先检查是否遗漏了这一步。配对端口和连接端口不一定相同。不同品牌的开发者菜单
| 品牌 | 查找方向 |
|---|---|
| 小米 / Redmi | 设置中的设备信息或产品型号页 |
| TCL / 雷鸟 | 本机信息、更多设置；少数机型要使用遥控器方向键组合 |
| 索尼 | 设备偏好设置里的系统版本信息 |
| 海信 / Vidda | 关于本机或隐藏的开发者功能菜单 |
| 创维 / 酷开 | 系统信息及开发者相关选项 |
| 康佳 / 长虹 | 以实际机型的开发者菜单为准 |
| OPPO | 系统及设备信息，部分型号需要组合操作 |
第二步：电视装包
确认 TV 安装包和设备调试方式后，按自己的操作习惯选一种即可，不需要四种方法全部执行。
方式 a：让可操作终端的 AI 助手协助
已经在电脑上运行且具有终端权限的 AI 编程助手，可协助检查 ADB 连接、安装并启动应用。可以将以下任务清单交给助手，执行前核对它给出的命令。
目标：在一台 Android 电视安装 StudyOnTV TV 版。
设备 IP：请填写电视显示的实际地址。
1. 从项目正式发行页获取 TV APK，并核对安装包来源。
2. 使用 adb connect 连接正确的电视 IP 与调试端口。
3. 执行 adb devices，确认设备处于 device 状态。
4. 安装 APK，检查命令是否返回 Success。
5. 使用 com.studyontv.tv 启动应用。
6. 提醒我根据实际需求设置悬浮窗、使用情况、无障碍和自启动。
出现错误时停止并说明错误原文及下一步操作，不绕过设备授权。方式 b：在电脑上手动执行 ADB
电脑需预先配置 Android SDK Platform Tools。将 IP、端口及 APK 文件名换成真实值；APK 不在当前文件夹时需写完整路径。
adb connect 192.168.1.100:5555
adb devices
adb install -r StudyOnTV.apk
adb shell monkey -p com.studyontv.tv -c android.intent.category.LAUNCHER 1adb devices 返回正常的 device 状态后，才继续安装。完成安装后，建议关闭电视上临时打开的网络调试。方式 c：图形化 ADB 工具
不熟悉命令的用户，可以借助第三方电视管理软件完成连接和 APK 安装。下面是原项目列举的工具及其定位，使用前应检查对应项目的许可、来源与适配情况。
| 工具 | 使用环境 | 用途 |
|---|---|---|
| tvhelper-docker | Docker / NAS | 通过网页控制电视并上传 APK |
| SmartTV-Toolkit | Windows | 适配部分国内电视设备的实用工具 |
| android-tv-toolkit | ADB 工具环境 | 连接和调试故障排查 |
| Android-TV-Desktop-Toolkit | Windows / macOS | 图形化安装及遥控功能 |
| TvToolsPro | Android 手机 | 从手机连接兼容的电视调试服务 |
方式 d：直接使用 U 盘
- 下载 TV APK，把它复制到电视能读取的 U 盘中；若无法识别，可尝试 NTFS 文件系统。
- 将 U 盘接入电视，使用文件管理器找到 APK 并运行安装。
- 出现“禁止安装未知应用”时，在安全设置中授权安装来源，再试一次。
按需开启权限
安装后可先体验学习与家长设置，再决定哪些管控权限需要打开。权限授权并非全部为必选项，但会改变应用识别、计时和拦截效果。
| 权限 | 通常在系统哪里设置 | 用途 |
|---|---|---|
| 悬浮显示 | 应用 → 特殊权限 → 显示在其他应用上层 | 需要学习时覆盖其他界面 |
| 应用使用记录 | 应用 → 特殊权限 → 使用情况访问 | 辅助识别当前应用及计算使用时长 |
| 无障碍服务（可选） | 无障碍 → 已安装的服务 | 提高应用切换识别与学习页出现的及时性 |
| 开机自启动 / 后台白名单 | 系统的启动管理与电池管理 | 减少后台进程被厂商系统清理 |
| 设备管理员（可选） | App 防卸载配置及系统设备管理功能 | 在支持的机型上增加卸载保护步骤 |
只有悬浮显示而未授权应用使用记录时，软件可能按离开学习页面后的亮屏时长计时，停留在桌面的时间也可能被包含。没有授权上述权限时通常还能正常进入学习和家长设置，但不会完整控制其他应用。
电视找不到悬浮窗授权入口
部分精简系统隐藏了图形化入口。设备已完成 ADB 授权、且用户了解其作用时，可使用下列命令：
adb shell appops set com.studyontv.tv SYSTEM_ALERT_WINDOW allow如果安装的是调试版，包名需按调试版实际包名调整。授权后重新打开 App，在家长管理的设备管控能力页面核对悬浮、使用情况与服务状态。
系统设置保护与家长连接
系统设置拦截能力依赖具体授权组合；家长通过受控设备上的二维码进入管理页，并输入初次设定的密码。单独启用悬浮窗时，对系统设置的准确识别可能不足。
开机启动与应用更新
设备开机后是否自动恢复？
应用会尝试响应正常启动及更新后的相关系统事件，以重新开启管理服务。但一些电视具有深度待机、后台限制或特殊关机机制，因此不应默认认为每次都能自动恢复。如果管理失效，先检查厂商的后台运行、自启动设置，再主动打开一次应用。
怎样更新应用？
家长管理面板可提供检查更新功能。请区分电视包与手机/平板包；下载后确认软件包身份和签名一致，覆盖安装通常保留本地资料。若电视要求修改安装来源权限，应先通过家长验证进入系统设置。
装不上？常见情况排查
| 现象 | 可能原因 | 可以怎么做 |
|---|---|---|
| 应用无法解析或安装 | 系统不兼容、APK 包损坏或版本选错 | 确认 Android 版本、下载完整性和 TV / 移动版选择 |
| 找不到未知应用安装权限 | 厂商设置名称不同 | 搜索系统设置中的应用安装、安全相关菜单 |
| 网络 ADB 连接超时 | 网络调试未开启，地址或端口错误 | 重新核对电视的 IP 和调试入口 |
| ADB 未授权且无弹窗 | 调试授权记录或厂商连接机制异常 | 撤销调试授权后重连，必要时参考电视工具的重握手说明 |
| U 盘没有显示 | 电视不识别其格式或文件管理器 | 检查 U 盘格式，或使用 ADB 安装 |
| 安装后立即退出 | 系统组件（如 WebView）过旧或其他兼容问题 | 记录电视型号、Android 版本及错误日志反馈开发者 |
| 无法在非安卓系统安装 | 系统并不兼容 Android APK | 不能直接使用普通 APK；参见下一节 |
系统版本
| 系统 | 项目当前说明 |
|---|---|
| Android 5.0 或更新版本 | 列为受支持系统，具体功能仍受厂商 ROM 限制 |
| Android 4.x 及更早系统 | 尚未在项目支持范围内 |
| HarmonyOS NEXT、Tizen、webOS | 不能直接按 Android APK 的方式部署 |