ZL-Music

ZL‑Music‑TV（ZL_Musicos）项目总结 该项目是开源仓库 kaosZL/ZL_Musicos ，基于lx‑music‑mobile 1.8.4二次开发的Android TV音乐播放器，仅用于学习研究，无内置版权音乐资源，UI参考Apple Music TV风格。 核心功能与TV端改造 1. 遥控器完整适配：支持方向键、OK确认、返回、播放/暂停、切歌等电视遥控器按键；优化焦点高亮描边、滚动跟随，解决焦点乱跳、选中态被背景淹没的问题；提供npm调试命令，可通过ADB/模拟器模拟遥控按键。 2. 界面重构 - 播放页：左专辑封面、右侧歌词、底部进度条，右下角圆形模式切换按钮，支持顺序/循环/随机/单曲循环。 - 首页、排行榜、搜索、设置页全部做大屏适配；搜索页简化移除音源标签；设置页列表内部滚动，避免布局溢出。 3. 4K大屏适配：针对75寸4K电视（3840×2160）做UI缩放限制，提升远距离阅读效果，降低背景渲染开销。 4. 兼容性优化：APK清单声明Wi‑Fi、触摸屏等硬件特性非必需，减少电视提示应用不兼容。 技术与构建信息 - 技术栈：TypeScript(73.1%)、JavaScript、Java，React‑Native，需要Node20+、JDK17、Android SDK环境。 - 源码目录： src/components/TV 存放TV组件； src/screens/TV 为各个大屏页面； scripts 提供构建、安装、遥控调试脚本。 - 构建产物：可编译出 arm64‑v8a 、 x86 、 universal 等多架构APK； universal 包适合不清楚设备架构的电视盒子，x86用于模拟器。 - 部署方式：支持npm脚本一键打包、部署到模拟器；也可adb手动安装启动。 版本与仓库信息 - 提交：共10次提交，2026‑06‑25初始化，2026‑07‑04更新焦点与遥控体验，最新版本v1.8.8‑tv。 - 授权：继承原项目Apache‑2.0协议；单人维护。 - 输出产物在GitHub Releases发布，提供多架构APK下载。 注意事项 项目仅做学习个人体验，不提供版权音乐，若存在版权问题可联系删除。 ZL‑Music‑TV v1.8.8‑tv Release总结 发布时间：2026‑07‑04，对应提交哈希： cd44b07 。 主要更新内容 1. 新增TV设置页手动更新功能：TV模式移除启动自动更新检查，仅保留手动版本检查更新入口。 2. 更新机制改造：改用 publish/tv‑version.json 静态清单，减少GitHub API调用，规避API限流问题。 3. ABI架构自动匹配：程序可识别设备CPU架构，自动匹配 arm64‑v8a / armeabi‑v7a / x86 / x86_64 / universal 对应APK包。 APK下载选型建议 - 夜神模拟器 / Android x86设备：选择 x86 或 x86_64 包 - 电视、电视盒子真机：优先 arm64‑v8a ；不清楚设备架构使用 universal 通用包。 签名说明 项目没有配置正式keystore，继续沿用项目fallback本地release签名，保持和上一版签名一致。 结合上一份文档：该版本是在v1.8.7基础之上迭代，前面版本重点优化遥控器焦点、4K大屏UI；v1.8.8‑tv主要聚焦TV端应用更新能力的完善。