Releases: 1-20182/melodyflow-android
Releases · 1-20182/melodyflow-android
Release list
MelodyFlow v3.9.0
MelodyFlow v3.7.0
v3.7.0 (2026-07-28)
新功能
- 新增 Bug 反馈 & 新功能建议通道：首页横幅、宣传弹窗、设置页均可直达 QQ 群
- QQ 音乐电台卡片新增登录入口，未登录状态与网易云电台卡片大小一致
- 新增 11 种 GLSL 视觉预设着色器
界面与体验优化
- 反馈横幅文字加粗加大（13sp + 强调色），更醒目
- 启动动画延长至 3 秒，文字淡入 + 信号线 + 整体淡出更从容
- 启动页状态栏/导航栏深色适配，MIUI 切换动画不再覆盖
问题修复
- 修复未登录状态下个性电台和 QQ 音乐电台卡片高度不一致
- 修复 MIUI 系统启动动画被系统 Activity 切换动画覆盖导致不显示
清理
- 移除 AI 痕迹文件（AGENTS.md）
- 更新 .gitignore 排除临时/原型文件
v3.6.1
v3.6.0
新增
- 自定义背景热更换：选择渐变/图片背景后点击「确认使用此背景」立即生效，无需重启应用
- 背景变更自动刷新：所有页面在恢复时检测背景更新，即时切换
优化
- 背景刷新逻辑优化：仅在背景确实变更时才刷新，减少不必要的重绘
- 网易云反向收藏同步：同步前先等待登录态刷新完成，彻底解决首次同步必失败的问题
- 二维码/Cookie 登录用户：同步前验证登录态有效性，过期时提前提示重新登录
- 网易云接口遇登录过期立即中止，避免后续操作全部失败
修复
- 修复自定义背景设置后需重启应用才能生效——新增确认按钮，预览→确认→立即生效
- 修复网易云反向收藏首次同步 100% 失败——根因：登录态异步刷新竞态，同步时新凭证未就绪
- 修复二维码/Cookie 登录用户反向收藏永远失败——无法自动刷新登录态，现增加有效性检查并提示
清理
- 删除 8 个无用的布局文件
- 清理空方法和未使用变量
v3.5.0
v3.4.0
v3.4.0 更新内容
✨ 新功能
- 🔄 自动更新检查：启动时自动检测新版本，一键下载安装，支持5条镜像线路
- 🌐 下载线路选择：5条预设线路 + 一键测速，自动选择最快线路下载APK
- 💖 启动宣传弹窗：每次启动用娇滴滴的文案请求用户点Star/分享/投喂开发者
- 🎵 频谱蓝牙兼容：改用 Visualizer API，无需录音权限，蓝牙耳机自动回退到 output mix
- 🎯 新手教程重写：动态 View 定位替代硬编码坐标，11步引导更精准
🔧 问题修复
- 💾 修复数据恢复失败（Gson null值导致 HistoryEntity NPE 崩溃）
- 📱 修复未登录时个性电台元素显示不完全（ConstraintLayout GONE 约束失效）
- 🎯 修复新手教程高亮位置偏移
🎨 界面与体验优化
- 🌐 设置页代理配置改为线路选择+测速，不再需要手动填写代理地址
- 💖 宣传弹窗频率可配置（每次启动/每天一次/从不）
- 🍜 投喂按钮直接跳转赞赏码界面
📦 技术细节
- UpdateChecker: 新增 ProxyLine 数据类、testLatency() 测速、getSelectedLine()/saveSelectedLine()
- BackupManager: null-safe 操作符修复 Gson 反序列化 null 值问题
- OnboardingStep: 新增 targetViewId + highlightFallback 字段
- BeatAnalyzer: Visualizer(sessionId) 失败时回退 Visualizer(0)
- 版本号: 3.3.0 → 3.4.0 (versionCode 20 → 21)
v3.3.0
v3.3.0 更新内容
✨ 新功能
- 🎵 首页唱片频谱条真实音频驱动，每根条独立反映对应频率的能量
- 🎨 频谱条视觉增强：更高、更密集、新增矿石青发光层
- 💿 唱片 sleeve 卡片显示正在播放歌曲标题和歌手名
- 🔍 首页标签（流行/电子/民谣/摇滚/R&B/古典）点击跳转搜索页并自动搜索
🎨 界面与体验优化
- 📱 竖屏模式下首页旋转唱片和频谱条正常显示
- 🎵 频谱条从假动画改为真实 FFT 分频数据驱动，跟随音乐变化
- 🏷️ Chip 标签位置下移，不再与频谱条重叠
🔧 问题修复
- 🎵 修复竖屏模式下首页唱片和频谱条不显示
- 📊 修复频谱条不跟随实际音乐变化
- 🏷️ 修复 Chip 标签与频谱条重叠
- ⏱️ 修复 BeatAnalyzer 启动时序问题
- 🔐 修复 RECORD_AUDIO 权限缺失导致 Visualizer 初始化失败
v3.1.0
v3.1.0 (2026-07-02)
✨ 新功能
- 🔍 专辑搜索：搜索 Tab 从 2 个增至 3 个（歌曲/歌手/专辑），专辑按同名聚合为卡片，点击播放整张专辑
- 🎬 页面动画优化：Activity 过渡统一淡入微位移，列表项错峰渐入
🎨 界面与体验优化
- 🔄 搜索三路并行（歌曲/歌手/专辑），总延迟大幅降低
- 📱 ViewPager 页面切换改为线性交叉淡入，更纯净无穿帮
- 🎨 背景设计回归纯净白/暗色（跟随系统设置），移除自定义背景/渐变/动态星河
🔧 问题修复
- ⏰ 修复定时关闭无法使用（横屏平板上更多选项对话框折叠，定时器按钮不可见）
- 🖼️ 修复横屏首页背景色与其他页面不一致
- 🔀 修复 ViewPager 相邻页面元素穿透叠加
MelodyFlow v2.3.4
更新日志
所有项目的显著变更都将记录在此文件中。
格式基于 Keep a Changelog，
并且本项目遵循 语义化版本。
[Unreleased]
[2.3.4] - 2026-06-22
Fixed
- 修复 AISettingsActivity、PlaylistActivity 与 CachedSongsActivity 因主题 ActionBar 与 Toolbar 共用导致的潜在闪退
- 统一为所有调用 setSupportActionBar 的 Activity 应用 Theme.MelodyFlow.NoActionBar
[2.3.3] - 2026-06-22
Fixed
- 修复「我的」页面点击「已缓存歌曲」时 CachedSongsActivity 因主题 ActionBar 与 Toolbar 冲突导致的闪退（issue #1）
[2.3.2] - 2026-06-22
Fixed
- 修复 release 构建中 RecyclerView setHasFixedSize 与 wrap_content 冲突的 lint 错误（彻底固化）
[2.3.1] - 2026-06-22
Fixed
- 修复从数据库 v5 升级到 v7 时缺少迁移路径导致的启动崩溃
- 补充 MIGRATION_5_6 与 MIGRATION_5_7，覆盖旧版本数据库直升到当前 v7 结构
[2.3.0] - 2026-06-21
Added
- 引入 ViewModel 层：PlayerViewModel、HomeViewModel、SearchViewModel、LibraryViewModel、FavoritesViewModel、SettingsViewModel
- MusicService 全面迁移到 StateFlow 状态管理（currentSongFlow / isPlayingFlow / playbackProgressFlow / playbackDurationFlow / playModeFlow / playlistFlow）
- 新增音频焦点管理，来电或其他音频播放时自动暂停
- 新增外部公共目录歌曲缓存
/sdcard/MelodyFlow/cache/，卸载应用后缓存不丢失 - 新增智能缓存容量管理：LRU 淘汰策略 + 收藏歌曲保护
- 新增缓存一致性校验：启动时自动清理幽灵条目和孤立文件
- 新增本地歌曲扫描服务 LocalScanService，支持增量扫描和自定义扫描目录
- Library 页新增"在线收藏"和"本地歌曲"双 Tab
- 新增 JSON 歌曲存档备份/导入系统（收藏、历史、日历事件、音乐日记、AI 配置）
- 新增自动备份功能：收藏变更后 5 分钟防抖自动导出
- 新增启动时恢复引导：数据库为空且检测到备份时提示恢复
- 新增 Material You MD3 动态颜色主题与深色模式完整适配
- 新增播放器封面圆形裁剪与 FAB 风格播放按钮
- 新增 MD3 Slider 进度条和 MD3 SearchBar 搜索框
Changed
- 优化横屏播放器布局：歌曲信息移至顶部居中显示
- 优化歌曲列表布局：歌曲名称和歌手显示在卡片中间
- 优化歌词界面关闭按钮层级，避免被遮挡
- 优化播放队列高亮更新为局部刷新，不再重建 Adapter
Fixed
- 修复 LyricsFocusAdapter 双绑定崩溃
- 修复缓存恢复 url=null 导致重新缓存失败
- 修复历史记录无限增长，新增按歌曲 ID 去重与自动清理
- 修复取消收藏同时删除缓存的问题
- 修复 SearchFragment 清除单条历史误清全部
- 修复 PlayerActivity 进度更新频率过高（50ms → 200ms）
- 修复 AnimatorSet 缩放动画两组同时播放的问题
- 修复 SleepTimer 生命周期绑定错误，移至 MusicService
- 修复横屏播放队列内容不同步与点击崩溃
- 修复背景图片/渐变被 Fragment 不透明层遮挡的问题
- 修复 PlayerActivity viewModel 未初始化导致的崩溃
Security
- 数据库升级使用 Migration(v6 → v7)，移除 fallbackToDestructiveMigration，避免升级丢数据
[0.1.0] - 2024-06-11
Added
- 初始版本发布
- 基础音乐播放功能
- 音乐搜索功能
- 歌词显示功能
- 收藏管理功能
- 本地音乐扫描
- 横竖屏适配
- Material Design 3 UI
MelodyFlow v2.3.3
更新日志
所有项目的显著变更都将记录在此文件中。
格式基于 Keep a Changelog，
并且本项目遵循 语义化版本。
[Unreleased]
[2.3.3] - 2026-06-22
Fixed
- 修复「我的」页面点击「已缓存歌曲」时 CachedSongsActivity 因主题 ActionBar 与 Toolbar 冲突导致的闪退（issue #1）
[2.3.2] - 2026-06-22
Fixed
- 修复 release 构建中 RecyclerView setHasFixedSize 与 wrap_content 冲突的 lint 错误（彻底固化）
[2.3.1] - 2026-06-22
Fixed
- 修复从数据库 v5 升级到 v7 时缺少迁移路径导致的启动崩溃
- 补充 MIGRATION_5_6 与 MIGRATION_5_7，覆盖旧版本数据库直升到当前 v7 结构
[2.3.0] - 2026-06-21
Added
- 引入 ViewModel 层：PlayerViewModel、HomeViewModel、SearchViewModel、LibraryViewModel、FavoritesViewModel、SettingsViewModel
- MusicService 全面迁移到 StateFlow 状态管理（currentSongFlow / isPlayingFlow / playbackProgressFlow / playbackDurationFlow / playModeFlow / playlistFlow）
- 新增音频焦点管理，来电或其他音频播放时自动暂停
- 新增外部公共目录歌曲缓存
/sdcard/MelodyFlow/cache/，卸载应用后缓存不丢失 - 新增智能缓存容量管理：LRU 淘汰策略 + 收藏歌曲保护
- 新增缓存一致性校验：启动时自动清理幽灵条目和孤立文件
- 新增本地歌曲扫描服务 LocalScanService，支持增量扫描和自定义扫描目录
- Library 页新增"在线收藏"和"本地歌曲"双 Tab
- 新增 JSON 歌曲存档备份/导入系统（收藏、历史、日历事件、音乐日记、AI 配置）
- 新增自动备份功能：收藏变更后 5 分钟防抖自动导出
- 新增启动时恢复引导：数据库为空且检测到备份时提示恢复
- 新增 Material You MD3 动态颜色主题与深色模式完整适配
- 新增播放器封面圆形裁剪与 FAB 风格播放按钮
- 新增 MD3 Slider 进度条和 MD3 SearchBar 搜索框
Changed
- 优化横屏播放器布局：歌曲信息移至顶部居中显示
- 优化歌曲列表布局：歌曲名称和歌手显示在卡片中间
- 优化歌词界面关闭按钮层级，避免被遮挡
- 优化播放队列高亮更新为局部刷新，不再重建 Adapter
Fixed
- 修复 LyricsFocusAdapter 双绑定崩溃
- 修复缓存恢复 url=null 导致重新缓存失败
- 修复历史记录无限增长，新增按歌曲 ID 去重与自动清理
- 修复取消收藏同时删除缓存的问题
- 修复 SearchFragment 清除单条历史误清全部
- 修复 PlayerActivity 进度更新频率过高（50ms → 200ms）
- 修复 AnimatorSet 缩放动画两组同时播放的问题
- 修复 SleepTimer 生命周期绑定错误，移至 MusicService
- 修复横屏播放队列内容不同步与点击崩溃
- 修复背景图片/渐变被 Fragment 不透明层遮挡的问题
- 修复 PlayerActivity viewModel 未初始化导致的崩溃
Security
- 数据库升级使用 Migration(v6 → v7)，移除 fallbackToDestructiveMigration，避免升级丢数据
[0.1.0] - 2024-06-11
Added
- 初始版本发布
- 基础音乐播放功能
- 音乐搜索功能
- 歌词显示功能
- 收藏管理功能
- 本地音乐扫描
- 横竖屏适配
- Material Design 3 UI