TV 文件盒

TVFileBox 项目完整总结 一、项目基础信息 TVFileBox 是开发者  w1lli4m666-droid  开源、纯Java编写的轻量化安卓TV文件管理器，仓库地址：https://github.com/w1lli4m666-droid/TVFileBox，最新版本v1.2.3，发布于2026-08-11，仅1名贡献者，项目暂未设置开源许可证，第三方依赖遵循各自协议。 基础适配门槛 - 最低系统：Android 4.0（API14），兼容老旧电视盒子 - 目标SDK：28，保留旧设备原生文件路径访问逻辑，不适合上架Google Play，仅用于侧载安装 - 架构：无原生so库，3个架构安装包（armeabi-v7a/arm64-v8a/universal）代码完全一致，universal通用版推荐普通用户使用 - 安装包为调试签名，可覆盖同签名旧版本 二、核心功能（TV遥控器深度适配） 1. 本地文件管理 1. 浏览设备公共存储 /storage/emulated/0 ，支持新建文件夹、文件/文件夹重命名、永久删除（二次弹窗确认） 2. 遥控器快捷键逻辑： - 上下方向键：切换文件焦点 - OK/确认键：打开文件/进入文件夹；长按删除 - 返回键：返回上级目录；主页按钮一键回到根目录 - 设置/菜单键：呼出选中项重命名、删除菜单 3. 支持直接调用系统安装器打开APK（安卓8+需手动开启“未知来源应用”权限） 2. 局域网远程传输（核心特色） 1. 打开远程传输页面自动生成带随机token的访问二维码，同局域网手机浏览器扫码即可上传文件到电视 2. 内置轻量HTTP服务，仅远程传输页面打开时运行，退出即关闭服务 3. 上传可视化：显示实时进度、完整存储路径、上传历史，支持对已上传文件打开/删除 4. 默认上传目录为应用私有目录 getExternalFilesDir("uploads") ，卸载App会清空该文件夹 三、存储与设备兼容限制 1. 普通无Root权限，无法访问 /data 等系统保护目录 2. Android 4.4设备读写外置SD卡会受固件限制 3. 路由器开启AP隔离会阻断手机与电视局域网互通，导致远程传输失败 4. 部分厂商遥控器占用设置键，软件兼容Menu键作为备选 四、安全设计 1. 上传链接附带随机会话token，防止他人随意访问 2. 文件名做过滤处理，杜绝路径穿越漏洞 3. 文件先写入临时 .part 文件，完整传输完成后再重命名落地，避免损坏文件 4. 强制同一局域网才能传输，无公网访问能力 五、第三方依赖与素材 1. 图标：谷歌Material  folder_open 图标，Apache 2.0协议 2. 核心组件：NanoHTTPD（内置文件上传服务）、ZXing（生成传输二维码） 3. 第三方组件完整协议、源码说明存放于 THIRD_PARTY_NOTICES.md  六、本地编译方式 1. 开发环境：Android Studio，同步Gradle依赖 2. 运行方式：连接电视盒子/模拟器，直接运行 app 模块 3. Windows打包命令（指定JDK路径）： plaintext $env:JAVA_HOME='C:\Program Files\Android\Android Studio\jbr' .\gradlew.bat clean testDebugUnitTest lintDebug assembleDebug   七、项目文件结构 仓库包含安卓标准工程目录： app 源码目录、gradle编译配置、中英文双版README、更新日志、第三方协议说明，提交记录共4次，2026-08-04发布v1.2.0初始版，2026-08-11更新优化开机自动聚焦远程传输功能。 TVFileBox v1.2.3 发布页内容总结 一、版本基础信息 1. 发布主体：开发者 w1lli4m666-droid，发布时间2026年08月11日，提交哈希  630c50d ，为当前仓库最新版本。 2. 最低系统要求：Android 4.0（API 14），兼容老旧电视盒子。 3. 签名与兼容性：所有安装包为调试签名，可覆盖安装同签名旧版TVFileBox；软件无原生 .so 库，三个架构包代码完全一致，SHA-256哈希完全相同。 二、本次版本更新改动（三大优化） 1. 启动焦点逻辑调整 应用打开后，顶部工具栏默认选中「远程传输」按钮，不再默认选中首页，贴合局域网传文件高频使用场景。 2. UI焦点显示bug修复 文件条目仅在文件列表获得实际焦点时才显示选中高亮，修复启动时双重光标、视觉错乱的问题。 3. 文档同步更新 同步更新英文版、简体中文版README文档，适配v1.2.3新版说明。 三、安装包区分与推荐 提供3款APK文件，内核完全相同，仅标注适配架构： 1.  armeabi-v7a.apk ：32位ARM老旧电视盒子 2.  arm64-v8a.apk ：64位ARM电视/盒子设备 3.  universal.apk ：通用全兼容包，官方推荐普通用户使用 四、构建测试说明 - 单元测试、Android Lint代码检查、Debug构建流程全部通过； - 本次发布未开展模拟器、ADB真机实机功能测试。 五、安全校验 三款安装包SHA-256校验码完全一致：  0508014792DAA58EF8F5BFFAC267F4708B23CB805C932B7170A64150E105C2B5