一起,让体验更好。
CurrentMusicX 的源码、版本与问题追踪在 GitHub 维护。这里是阅读、构建与贡献的起点。
项目概览
CurrentMusicX 是 CurrentMusic 的原生 Android 客户端,基于 Kotlin、Jetpack Compose 和 Miuix。源码位于 本仓库 main 分支,同时维护于 CurrentMusic 的 app 分支。
| 界面 | Jetpack Compose · Miuix |
|---|---|
| 最低系统 | Android 8.0 / API 26 |
| 目标系统 | Android 16 / API 36 |
| 正式包架构 | arm64-v8a |
构建与设备测试
先阅读仓库的 BUILDING.md,按其当前要求准备 JDK、Android SDK 与本地配置。具体构建任务、签名和测试流程以该文档为准。
git clone https://github.com/bileizhen/CurrentMusicX.git cd CurrentMusicX
自行构建的签名通常与正式版不同,无法直接覆盖安装。设备验证请使用文档中的独立测试包方案,避免影响日常账号、曲库和播放状态。
反馈与贡献
欢迎提交 Issue 或 Pull Request。请描述要解决的问题,按独立功能或修复拆分提交,并说明实际验证结果。
- 问题反馈:提供应用版本、设备型号、Android 版本和明确的复现步骤。
- 界面问题:附截图或录屏,说明深浅主题、横竖屏与相关设置。
- 播放问题:说明音源、歌词来源、网络情况与账号权限,不要提交账号凭据。
- 验证结果:区分编译、自动化测试和真机运行,不以构建通过代替实际体验验证。
隐私说明
本机账号凭据加密保存。应用按服务分别请求网易云、CurrentMusic 或 Navidrome 接口;音频、MV 与图片从对应服务返回的地址加载。下载文件保存在你选择并授权的目录。
完整数据用途及保存方式请阅读 应用隐私说明。分享诊断日志前请检查并遮挡个人信息。
本官网不设置账号登录或广告追踪。下载区域会请求 GitHub 的公开 Releases API 以显示最新正式版;失败时保留 Releases 页面入口。
许可证与致谢
既有代码按 GPL-3.0-only 分发;Folia 莫奈歌词动画与播放暂停渐变移植组件按 AGPL-3.0-only 分发,组合遵循两份许可证第 13 节。各上游组件保留自己的版权与许可。
完整依赖、许可与版权声明见 THIRD_PARTY_NOTICES.md。
感谢 CurrentMusic、Folia、Miuix,以及所有相关开源项目和贡献者。
官网视觉结构参考 Folia 官网,使用 CurrentMusicX 自身的品牌与真实应用截图独立实现。