README

AM++


  简体中文 | English



  Apple Music 的 Android 增强模块：平板双栏、歌词定制与液态玻璃。



  
  
  
  
  



  没有lsposed和root？不妨试试npatch 嵌入版



目录

1. 项目简介
2. 功能
3. 效果展示
4. 安装
5. 使用
6. 从源码构建
7. 项目结构
8. 路线图
9. 贡献
10. 隐私与权限
11. 许可证与致谢
12. Star History
13. 支持项目



 项目简介

安装后，在 Apple Music → 设置 → AM++ 模块设置 中管理功能。

支持导入 ZIP 插件扩展功能，详见 插件开发手册。

 功能

| 功能 | 默认 | 说明 |
| --- | --- | --- |
| 平板双栏播放器 | 开启 | 横屏时并排显示播放控件与实时歌词。 |
| 强制显示蜂窝数据入口 | 关闭 | 在设置中显示原生蜂窝数据选项。 |
| 双向歌词模糊 | 开启 | 当前歌词保持清晰，前后歌词渐变模糊，支持调节强度（Android 12+）。 |
| CJK 长尾歌词动画 | 开启 | 为中日韩歌词加入辉光动画。 |
| 歌曲名显示修正 | 关闭 | 按歌曲原地区、中国大陆或日本显示歌曲名与相关信息。 |
| 自定义歌词 | 关闭 | 导入、编辑 TTML 歌词，支持在线获取。 |
| 自动实时补全 | 开启 | 启用自定义歌词后，为缺词、非逐字或缺翻译的歌曲自动查找歌词。 |
| 歌词字体 | 关闭 | 导入 TTF/OTF 字体，随时恢复原字体。 |
| 液态玻璃底栏 | 关闭 | 为导航栏和迷你播放器加入液态玻璃效果（Android 13+）。 |
| ios底栏动画 | 开启 | 手机端随启用ios同款底栏动画，实时生效。 |

 效果展示

 自定义歌词注入


  
  


 字体替换


  


 平板双栏播放器与歌词模糊


  


 液态玻璃底栏


  


 安装

 Xposed 模块（推荐）

需要 Apple Music 和支持 libxposed API 102 的 Xposed 框架。

1. 从 Releases 下载并安装 AM++ APK。
2. 在 LSPosed 或兼容的 Xposed 管理器中启用 AM++。
3. 作用域只勾选 Apple Music（com.apple.android.music）。
4. 强制停止并重新打开 Apple Music。
5. 打开 Apple Music → 设置 → “AM++ 模块设置”。

 npatch 嵌入版

没有lsposed和root？不妨试试npatch 嵌入版，无法与官方版共存。

安装包文件名包含 AM++ 版本、Apple Music 版本和构建号，按需选择即可。

 使用

部分设置需强制停止并重新打开 Apple Music 后生效。

 自定义歌词

1. 打开“自定义歌词”，启用“自定义歌词替换”。
2. 点“获取 ID”读取当前歌曲，或手动填写 Apple Music ID。
3. 粘贴或导入 TTML，也可从 AMLL、AM-Lyrics、Lunabeat 在线获取。
4. 保存并启用该歌曲的歌词。
5. 强制停止并重新打开 Apple Music。

歌词支持搜索、编辑、删除和 ZIP 备份恢复；恢复时可选择覆盖或保留已有歌词。手动编写 TTML 可参考 格式说明。

 歌词字体

1. 在“歌词字体”中选择 TTF 或 OTF 文件。
2. 导入完成后，强制停止并重新打开 Apple Music。
3. 点“恢复原字体”并重开 Apple Music 即可还原。

字体仅应用于播放器歌词。

 液态玻璃底栏

打开“液态玻璃底栏”，强制停止并重新打开 Apple Music，即可为导航栏和迷你播放器应用玻璃效果。

可调节背景模糊强度；手机端还可开启“ios底栏动画”，让底栏随页面滚动自动收起、展开。

 歌曲名显示修正

打开“歌曲名显示修正”，选择地区模式后重开 Apple Music。关闭时跟随 Apple Music 账号地区。

 从源码构建

环境：JDK 21、Android SDK 37、Build Tools 37.0.0，使用项目自带的 Gradle Wrapper。

Windows：

powershell
.\gradlew.bat test :app:lintDebug :app:lintVitalRelease :app:assembleRelease


Linux 或 macOS：

bash
chmod +x gradlew
./gradlew test :app:lintDebug :app:lintVitalRelease :app:assembleRelease


生成的 Release APK 位于：

text
app/build/outputs/apk/release/app-release.apk


构建 Release 前，将 keystore.properties.example 复制为 keystore.properties 并填写签名信息；无需签名配置可构建 Debug APK。

 项目结构

text
app/src/main/java/        模块入口、设置页与功能装配
app/src/main/resources/   libxposed 模块元数据
core/                     配置、歌词、网络来源与布局策略
host-api/                 宿主能力与事件接口
hook-runtime/             Xposed 封装与日志
host-applemusic/           Apple Music 版本适配
glass/                    液态玻璃渲染
backdrop/                 上游 Backdrop 库
docs/                     使用与开发文档
scripts/                  开发辅助脚本


 路线图

- [x] 平板横屏双栏播放器
- [x] 双向歌词模糊
- [x] 自定义歌词注入与备份恢复
- [x] 歌词字体导入与恢复
- [x] 液态玻璃底栏与迷你播放器
- [x] 歌曲名显示修正
- [ ] 持续适配后续 Apple Music 版本

 贡献

欢迎提交 Issue 和 Pull Request。代码改动请通过测试与构建；反馈界面问题时，请附设备型号、系统及 Apple Music 版本、截图或录屏。

开发与适配请参阅 文档目录 和 宿主适配手册。

 隐私与权限

- 仅声明 INTERNET 权限，用于歌词获取、翻译补全和歌曲信息查询。
- 不申请存储或通知运行时权限，本地文件通过系统文件选择器导入。
- 不含分析服务，也没有独立启动图标。
- 设置、歌词与字体保存在 Apple

Top issues

Latest release

- Apple Music 7.0.0（1614）适配。
- 新增自动歌词来源排序。
- 新增 LLM 歌词翻译的思考强度设置，支持默认、低、高、最高四档；开启模型思考后生效。
- 修复本地上传资料库歌曲的自定义歌词注入问题。
- 修复原生 AM 逐行歌词不显示 v1、v2 的问题。
- 优化部分被拆分的英文长词的辉光动画。
- 改进 CJK 歌词辉光判断。