Aerial TV 安装教程
从下载 APK、开启 ADB 调试到接管电视主页键，按照步骤完成 Aerial 安装。不同品牌的设置入口可能不同，请先确认电视系统及型号。
安装前检查
在操作之前，确认以下准备工作：
- 一台使用兼容 Android 系统的电视、盒子或投影设备。
- 对应 Android 版本的 Aerial APK。
- 如果需要 ADB 配置，一台电脑或支持 ADB 的手机。
- 电脑和电视连接到可以相互访问的局域网。
- 知道电视的局域网 IP 地址，并能够在电视上确认调试授权。
根据系统选择安装包
先确认系统，再选安装包。
选择电视的系统版本与安装情况，找到合适的安装包。
Android 5.0+ 设备优先选择标准版。
下载 Standard APK →方式一：使用 U 盘安装
- 下载 APK。在下载中心获取适合电视版本的安装包。
- 复制到 U 盘。将 APK 放入 U 盘，插入电视 USB 接口。
- 打开 APK 安装。使用电视文件管理器打开安装包，根据提示允许安装。
- 设置主屏幕。安装完成后按 HOME 键。如果弹出默认桌面选择，选择 Aerial 并设置为「始终」。
方式二：电脑 ADB 安装
01 · 开启电视 ADB 调试
先选择品牌查看入口，具体设置以电视当前固件为准。
小米 / Redmi
设置 → 关于 → 连续按「产品型号 / 产品类型」进入开发者模式；再到设置 → 账号与安全，开启 ADB 调试与安装未知来源的应用。
IP 查找：设置 → 网络 → 已连接的网络 → IPv4 地址。菜单名称会随型号与固件变化；只有 USB 调试开关不代表一定开放网络端口。
TCL / 雷鸟
设置 → 关于 → 本机信息，快速依次按「上、下、左、右」，在底部出现的「更多」中打开 ADB。部分新固件只提供无线调试，需要按配对或数据线方式连接。
IP 查找：设置 → 网络 → 已连接的网络 → IPv4 地址。菜单名称会随型号与固件变化；只有 USB 调试开关不代表一定开放网络端口。
索尼 / Google TV
设置 → 设备偏好设置（或系统）→ 关于，连续按「内部版本号」7 次；回到开发者选项开启 USB 调试。仅有无线调试时请先配对，端口以电视显示为准。
IP 查找：设置 → 网络 → 已连接的网络 → IPv4 地址。菜单名称会随型号与固件变化；只有 USB 调试开关不代表一定开放网络端口。
创维 / 酷开
先在设置 → 关于核对机型和 Android 版本，检查开发者选项、调试和安装权限。各固件入口差异较大，没有统一验证的开启路径；找不到入口时查看原项目机型记录，不套用其他品牌按键组合。
IP 查找：设置 → 网络 → 已连接的网络 → IPv4 地址。菜单名称会随型号与固件变化；只有 USB 调试开关不代表一定开放网络端口。
其他安卓电视
设置 → 设备偏好设置 → 关于 → 连续按「内部版本号」7 次，再在开发者选项查找 USB 调试或网络调试。厂商可能隐藏或关闭这些入口，无法开启时先查机型限制。
IP 查找：设置 → 网络 → 已连接的网络 → IPv4 地址。菜单名称会随型号与固件变化；只有 USB 调试开关不代表一定开放网络端口。
02 · 获取电视 IP 与准备 ADB
在电视「设置 → 网络 → 已连接的网络」查找 IPv4 地址，例如 192.168.1.20。不要填写 MAC 地址或外网 IP。电脑与电视需要在可互相访问的局域网中。
从 Android 官方下载 Platform-Tools ↗，解压后在该目录打开终端，先检查：
adb version已连接的网络
实际网络设置界面依电视品牌与固件不同。
03 · 连接电视
常规网络 ADB 使用电视实际开放的端口。以下为常见 5555 端口示例；电视弹出授权时选择「允许」，再检查连接状态。
adb connect 192.168.1.20:5555
adb devices仅提供 Android 无线调试的设备
进入开发者选项 → 无线调试 → 使用配对码配对设备。先执行配对，按提示输入配对码，再用无线调试主页上的连接端口建立连接。两组端口不同，不要直接套用 5555。
adb pair 192.168.1.20:配对屏端口
adb connect 192.168.1.20:无线调试主页端口
adb devices若固件没有配对码入口，可能需要先用设备支持的数据线连接电脑授权。请参照原项目对应机型说明，不猜测端口。
04 · 核对系统并安装 APK
adb shell getprop ro.build.version.release
adb install -r aerial-standard.apk终端输出 Success 表示 APK 安装完成。若系统提示不允许安装桌面类应用，先核对兼容说明，再尝试 Guard；Android 4.0–4.4 应使用 Lite。
05 · 配置默认桌面与必要权限
先从应用列表打开 Aerial，按照「设为主屏幕」引导选择默认 HOME 应用；如果固件锁定主页键，按设备能力开启 Aerial 的无障碍桌面守护与通知使用权。
- 在电视设置中找到 Aerial 对应的默认桌面、无障碍和通知使用权入口。
- 只对 Aerial 开启所需权限；不要关闭已有的其他无障碍服务。
- 设置界面缺少入口时，按原项目当前版本的手动安装第 3–8 步完成 ADB 授权与配置。Standard 与 Guard 的 HOME 设置方式可能不同。
展开：完整版手动授权与接管步骤
以下命令根据原项目安装说明整理，适用于包名为 app.orchard.tv 的完整版；Lite 不执行这组配置。执行前记录自己修改的设置与原值，逐条查看输出。个别固件不提供对应权限或系统命令，报错时核对当前项目说明。
① 授予必要权限
adb shell pm grant app.orchard.tv android.permission.ACCESS_FINE_LOCATION
adb shell pm grant app.orchard.tv android.permission.WRITE_SECURE_SETTINGS
adb shell appops set app.orchard.tv SYSTEM_ALERT_WINDOW allow
adb shell appops set app.orchard.tv WRITE_SETTINGS allow
adb shell appops set app.orchard.tv REQUEST_INSTALL_PACKAGES allow
adb shell appops set app.orchard.tv GET_USAGE_STATS allow
adb shell appops set app.orchard.tv android:get_usage_stats allow
adb shell cmd notification allow_listener app.orchard.tv/app.orchard.tv.guard.RevivalListener② TCL / 雷鸟的自启动配置
只有相应固件识别以下操作项；其他电视无需执行。不同 TCL 固件可能只识别其中部分项目。
adb shell appops set app.orchard.tv APP_AUTO_START allow
adb shell appops set app.orchard.tv APP_ASSOC_START allow
adb shell appops set app.orchard.tv AUTO_START allow
adb shell appops set app.orchard.tv ASSOC_START allow③ 启动应用与默认桌面
adb shell am start -W -n app.orchard.tv/.MainActivityStandard 可尝试设置 HOME 角色；Guard 跳过此项。部分国产固件会忽略默认桌面设置，需要继续检查守护。
adb shell cmd role add-role-holder --user 0 android.app.role.HOME app.orchard.tv老系统不支持 HOME 角色时，可按项目说明尝试：
adb shell cmd package set-home-activity --user 0 app.orchard.tv/.MainActivity④ 检查并启用桌面守护
adb shell settings get secure enabled_accessibility_services输出应包含 app.orchard.tv/app.orchard.tv.guard.HomeGuardService。优先从电视无障碍设置中开启。如果需要用 ADB 添加，先保留输出的所有原有服务，再用英文冒号连接 Aerial 服务；不可直接覆盖其他服务。原值为 null 或空时，仅写 Aerial 服务名。
adb shell "settings put secure enabled_accessibility_services '原有服务列表:app.orchard.tv/app.orchard.tv.guard.HomeGuardService'"
adb shell settings put secure accessibility_enabled 1上方“原有服务列表”是必须替换的占位内容；PowerShell 中原值若含 $ 需按终端规则转义。命令卡住或无输出时，停止重复执行，按项目对应机型文档检查。
⑤ 可选：由 Aerial 管理屏保
先查询系统是否启用屏保并记录原设置；只有启用值为 1，且希望使用 Aerial 屏保时，再执行后两条。
adb shell settings get secure screensaver_enabled
adb shell settings get secure screensaver_componentsadb shell settings put secure screensaver_components app.orchard.tv/app.orchard.tv.dream.AerialDream
adb shell am broadcast -a app.orchard.tv.CONFIG -n app.orchard.tv/.guard.ConfigReceiver --ez own_screensaver true其他机型专属设置（如海信 HOME 属性）、保持 ADB 常开和安装限制处理，请参照原项目对应章节，记录原值后再操作。无须卸载或停用原系统桌面。
06 · 验证桌面接管
- 用实体遥控器按 HOME 键，确认是否返回 Aerial。
- 正常待机后唤醒，检查是否恢复 Aerial；部分固件需要等待。
- 保存当前操作后自行重启电视，检查开机表现。不要仅凭 APK 安装成功判断接管成功。
adb shell settings get secure enabled_accessibility_services
adb shell dumpsys window第一条可检查守护服务是否列在已启用服务中，第二条用于观察当前窗口；输出格式随 Android 版本不同。请结合电视实际画面判断。
07 · 完成安装
主页键、待机唤醒和重启表现都检查后，就可以开始整理自己的桌面。
开始设置桌面可选：使用手机 ADB 安装
部分手机 ADB 工具可安装 APK 并进行授权。手机与电视需在可互访的网络中，按电视实际提供的调试方式连接，在电视确认授权，然后安装对应 APK。
不同工具的命令、文件传输和配对能力存在差异，并非所有机型都能完成完整接管。连接同一个 Wi-Fi 不等于可以一键替换电视桌面。安装后仍需验证 HOME 键、待机及重启表现。
安装故障排查
| 问题 | 排查方向 |
|---|---|
| 无法连接电视 | 核对 IPv4 地址、端口、ADB 开关与局域网互通；只有无线调试时先配对。 |
| 电视没有授权弹窗 | 查看 adb devices 是否已授权；检查调试开关、已有授权记录与连接方式。 |
| APK 拒绝安装 | 确认系统版本及未知来源权限；桌面类应用限制可尝试 Guard，TCL 验证失败需查看原项目分品牌说明。 |
| HOME 键回原桌面 | 检查默认桌面选择与无障碍桌面守护授权。 |
| 重启后进入原桌面 | 检查自启动限制和对应固件兼容记录。 |
| 待机后失效 | 查看后台清理、守护状态；部分设备恢复需要等待。 |
| Lite 无法接管 | Lite 没有完整版守护能力；固件必须允许选择第三方默认桌面。 |
机型兼容说明
不要按品牌整体判断兼容。以下仅摘录原项目的具体机型反馈；适配状态可能随 Aerial 版本和设备固件改变。
| 品牌 / 型号 | Android 版本 | 适配状态 | 备注 |
|---|---|---|---|
| 雷鸟 55S595C Ultra / MT9655 | 以设备实际版本为准 | 存在接管限制 | 原项目说明：能装，但无法稳定接管主页键 |
| 小米 MFTP0 低内存机型 | Android 9 | 待机恢复存在延迟 | 恢复表现与项目版本、系统后台策略有关 |
| 创维 7T631_T60 | Android 13 | 安装权限受限的用户反馈 | 原项目标注未在该机型真机验证 |
来源：原项目安装说明 · 常见情况。以上为限制与反馈记录，不是兼容保证。完整机型请查看 项目设备文档 ↗。