播放器首页空白与签名冲突排查
装完开源播放器后，被问得最多的两句是：「打开怎么什么都没有」和「为什么装不上」。这篇按现象归类，把 TVBox 这类播放器壳最常撞上的几种情况逐条给出判断办法。
一、首页空白：先分清「没内容」和「没装好」
首页空白是这类应用被误判最多的现象。它自身不带任何影视内容，未配置时首页空白正是正常样子。两步判断：
- 空白 + 能进设置页 + 能播本地文件 → 应用没问题，缺的只是配置。配置是一份由外部提供的 JSON，写明站点、解析、直播等条目，由使用者自行准备；它存在应用本地、不跟账号走，换设备要各自填一遍；
- 空白 + 连设置页都进不去、或打开就闪退 → 才是安装问题，看下一节。
还有一点要提前知道：配置失效后首页会重新变空，这属于机制本身的特性，重装应用解决不了，白折腾一轮还会把播放记录清掉。
二、装不上：多半卡在签名与架构
| 现象 | 常见原因 | 处理 |
|---|---|---|
| 提示「应用未安装」「签名不一致」 | 设备里已有同包名、不同签名的变体 | 先卸载旧的那个再装 |
| 一点开就退回桌面 | 系统低于 Android 5.0，或芯片不是 ARM | 换设备，或换匹配的构建 |
| 安装包点不开、解析失败 | 文件没下完 | 重新下载一遍安装包 |
同一支播放器的版本升级可以直接覆盖安装，播放记录和已填配置通常都保留 —— 反过来讲，能覆盖安装的才算是同一支；不同包名的变体属于不同应用，换过去等于重新开始，数据不会带过去。
三、能播但有毛病：别急着重装
- 画面卡、花屏、音画不同步：先换播放内核，再试切软解；盒子性能弱于手机，同一片源手机流畅、盒子卡顿多半是硬件差异；
- 字幕挂不上或乱码：先核对外挂字幕是否与视频同目录、主文件名相同，再看编码是不是 UTF-8，最后才考虑换内核；
- 局域网共享连不上：确认播放设备与共享设备在同一网段、账号有读权限、地址和端口填对。
以上按顺序排查完仍无解，再考虑卸载重装。相关安装步骤与设备要求，见电视盒子怎么装第三方播放器；功能界面与整体介绍，可以看 TVBox 观影手记。