Flowtone v0.15.0

开发预览版本 · Development Preview

Flowtone v0.15.0 是进入内部测试阶段前的一次重要开发里程碑。

自 v0.14.4 以来，Flowtone 进一步完善了在线音乐扩展生态、多来源曲库、媒体播放与预载机制，同时重构了扩展管理、网络权限和凭据授权体系。

本版本也带来了全新的声流品牌图标、启动动画、应用更新提醒和多项界面交互改进。

虽然 Flowtone 已经具备较为完整的本地播放能力，并能够通过扩展访问部分在线音乐内容，但仍有部分功能和视觉细节需要进一步测试与完善。

• 将扩展格式升级至 Manifest v2，采用标准化能力声明与运行时权限模型。

• 完善在线音乐 Provider 的搜索、歌曲解析与在线播放能力。

• 扩展在线歌曲、专辑和部分歌单的浏览能力，支持通过扩展读取并播放对应内容。

• 建立本地与在线歌曲统一的持久身份模型，使在线歌曲能够加入喜欢和自定义歌单。

• 重构在线媒体播放逻辑队列，改进播放切换、进度同步及媒体会话状态管理。

• 新增在线资源预载及部分音频内容缓存，并开放相关设置。

• 优化歌曲元信息、歌词和封面的预载范围及加载时机。

• 完善扩展安装预览、更新检查及权限变化审阅。

• 支持扩展独立配置页面、配置字段校验和配置持久化。

• 引入运行必须、推荐和可选三类配置要求，并改进配置提示与保存反馈。

• 规范化扩展网络权限，支持按协议、主机范围和端口声明访问权限。

• 新增扩展网络详情页面，完善网络权限展示和安全性提示。

• 新增账户密码、WebDAV 等凭据来源管理能力。

• 使用 Android Keystore 加密保护敏感凭据，并通过系统身份认证控制敏感信息查看。

• 建立凭据授权、撤销与失效管理机制，完善扩展更新、卸载及凭据删除时的授权生命周期。

• 重构在线扩展首页、扩展详情、安装与更新页面的布局和交互。

• 新增动态曲库来源选择器，支持在本地音乐与扩展来源之间切换。

• 完善不同来源的歌曲、专辑及歌单内容展示。

• 优化曲库来源选择状态保持和来源切换动画。

• 改进 MiniPlayer 切歌时的封面加载、旧封面保留和交叉渐变逻辑。

• 完善播放器播放进度、缓冲状态和进度条视觉反馈。

• 修复从歌词跳转播放位置时，进度条可能先发生跳变再执行动画的问题。

• 修复进入歌词页面时，部分隐藏的歌手名称仍能响应点击的问题。

• 持续优化 MiniPlayer 展开、收起与全屏状态之间的动画衔接。

• 引入全新的声流品牌图标，并替换原有实验性应用图标。

• 添加应用图标及相关品牌设计素材。

• 新增品牌启动动画，并接入 AndroidX SplashScreen。

• 更新关于页面中的品牌图标与视觉表现。

• 优化播放器背景云层的运动方式和视觉效果。

• 重构在线管理、扩展详情和设置页面的信息层级。

• 统一卡片、设置选项、开关、弹窗与遮罩的视觉样式。

• 改善不同主题下的页面配色和组件对比度。

• 为扩展页面完善背景取色、元素配色及云层视觉。

• 优化二级页面导航、返回操作和页面转场。

• 修复部分动画被中断时的异常时长、显示闪烁及状态交接问题。

• 改进关于页面和开源组件页面的卡片样式。

• 新增应用版本更新检查页面。

• 新增发现新版本时的更新提示弹窗。

• 完善 GitHub Android Release 构建流程，并修复 Release 构建中的 R8 兼容性问题。

• 建立 GitHub 到 Gitee 的代码镜像与 Release 同步机制。

• 新增 GitHub Issue 模板，支持结构化提交 Bug 反馈和功能建议。

• 补充扩展格式、安全权限、配置管理、页面状态及播放器相关测试。

• 扩展格式存在不兼容变更：Manifest v1 已不再受支持，旧版扩展需要迁移至 Manifest v2。

• 在线歌曲、专辑和歌单功能取决于对应扩展提供的实际能力，不保证所有扩展都支持全部功能。

• 在线歌单目前主要支持读取与播放，完整编辑、跨来源迁移等功能仍未完成。

• 凭据安全存储与授权管理已经建立，但通过 Host 向扩展代理提供凭据的能力仍在开发中。

• 部分播放器动画、扩展功能和设备兼容性仍需要进一步验证。

• 本版本尚未经过完整内部测试，不建议将其视为稳定发行版。

本版本提供签名的 Android APK。

• 文件名称：Flowtone-v0.15.0.apk
• 最低 Android 版本：Android 9（API 28）
• 版本名称：0.15.0
• 发布类型：Pre-release

如果此前安装的是 Debug 签名的开发构建，可能无法直接覆盖安装本版本。卸载前请注意备份重要的本地应用数据。

这是 Flowtone 进入内部测试阶段之前的一次开发预览发布。

本版本主要用于记录当前开发成果，并为后续测试、问题修复和功能完善提供统一的版本基线。

Flowtone 仍处于活跃开发阶段，未来将继续完善扩展生态、在线音乐能力、播放体验及界面动画。

---

完整代码变更：v0.14.4...v0.15.0

Flowtone v0.14.4

Flowtone v0.14.4

自 v0.14.0 以来，Flowtone 进一步完善了页面导航、在线 Provider 能力与扩展运行时，并逐步将在线内容接入现有本地音乐体验。

• 重构页面过渡动画系统：统一 Secondary 页面、TopBar、列表元素与背景的进出场生命周期，支持过渡中途反向，并修复多处闪烁、错位和状态提前释放问题。
• 完善歌单详情体验：加入稳定的歌单元信息 Header、主题色封面与编辑交互，并优化快速进入 / 返回时的连续动画表现。
• 新增本地与 Provider 专辑详情能力，建立统一 Album secondary destination，并加入专辑封面、黑胶唱片及背景云层等视觉表现。
• 重做 Artist 页面及导航结构，将 Artist 纳入统一 SecondaryNavigation，支持 Artist → Album 层级导航、状态保持与一致的返回行为。
• 扩展 Provider Artist Profile：支持别名、Biography、歌曲数、专辑数与 Banner，并加入资料卡展开、Focus 模式、图片缓存和完整的页面过渡动画。
• 完善在线搜索体系：支持 Provider 选择、本地 / 在线来源区分、分类分页与懒加载，并优化搜索结果切换、图片加载及渐入渐出表现。
• 建立 Provider Song / Album / Playlist 实体能力，统一在线实体身份、集合缓存与详情数据读取；在线歌单与专辑现在可以进入详情页并以完整集合队列播放。
• 支持在线搜索结果直接播放，并完善在线封面、大图 / 缩略图预载、pending 状态及异步请求失效处理。
• 引入 PersistentTrack，统一本地与在线歌曲的持久身份，支持在线歌曲加入 Flowtone Likes、自定义歌单，以及 Local / Online 混合歌单的持久化与恢复。
• 完善扩展受控媒体播放能力，包括 Provider 在线队列、按需媒体解析及 HLS 播放，并继续保持所有网络访问由 Flowtone Host 管理。
• 新增 Extension Runtime / Sandbox 热重载机制：扩展安装、更新或删除后无需重启 Flowtone，即可完整销毁并重建扩展运行环境。
• 为扩展运行时加入 generation 与生命周期失效机制，取消旧 runtime 请求并阻止过期 Promise、Provider 或异步结果回写当前状态。
• runtime 重载不会主动中断已经交给 Media3 的当前播放；后续在线资源解析会自动使用最新 Provider 实例。
• 持续修复 Artist、Album、搜索、封面冷加载及 TopBar 动画中的视觉与状态同步问题，并补充相关 JVM / Android 测试。

Flowtone v0.14.0

Flowtone v0.14.0

自 v0.12.0 以来的一次较大阶段更新。

• 完成本地歌词系统：支持 LRC、逐句同步、双语歌词、自定义歌词目录与预载，并完善歌词切歌、定位、手势、实时进度、高亮及特殊歌词动画。
• 重构并完善曲库与歌单交互：加入歌曲多选、批量操作、删除与排序，调整歌单页、曲库页、播放队列及折叠标题等界面与动画。
• 持续优化播放器体验：改善 MiniPlayer、全屏播放器、进度条、切歌动画、页面返回逻辑与多处交互细节。
• 改进本地音乐元数据读取、缓存和来源识别，并修复特殊字符等元数据问题。
• 加入启动、歌词渲染和切歌等性能优化与性能采样工具，并启用 R8 优化及 fast 开发构建变体。
• 初步建立 Flowtone 在线扩展运行时：支持 .flowtone 扩展包安装、受限 JavaScript Sandbox、Host HTTP、网络权限与日志。
• 为扩展加入私有持久 KV Cache、请求去重、歌手头像能力及持久头像结果缓存。
• 扩展图片统一经过 Flowtone Host 获取并支持 Coil 磁盘缓存，避免重复网络请求。
• 建立扩展远程媒体受控播放通道，支持 Media3 流式读取、Range/Seek，并保持网络访问由 Host 统一控制。
• 加入全局扩展网络资源保险丝，限制整个 Extension Runtime 的 active 与 in-flight 请求数量，防止扩展耗尽宿主资源。
• 补充大量 JVM 与 Android instrumentation 测试，扩展运行时、图片缓存、远程媒体与网络资源限制均已在 Android 16 真机验证。

Flowtone v0.12.0

Flowtone v0.12.0

本次版本集中重构三个主页面的视觉结构与内容组织，让首页、曲库和“我的”拥有更鲜明且连续的页面身份。

主要更新：

• 为首页、曲库和“我的”加入展开式页面 Header。
• 页面滚动后，大标题与副标题逐步收束为紧凑顶栏。
• 三个主页面使用各自的主题色云，并随页面切换改变颜色与位置。
• 重新设计首页内容结构，加入“推荐给你”“常听歌单”和“最近新增”等内容模块。
• 调整搜索入口，使其能够同时适配展开 Header 与折叠顶栏状态。
• 重整曲库页的内容层级，区分本地曲库、系统歌单与用户创建的歌单。
• 在用户歌单区域加入“我的歌单”分组标题。
• 优化主页面在浅色与深色模式下的背景、留白和内容衔接。
• 保持现有 MiniPlayer、全屏播放页与播放业务逻辑不变。

说明：

• 本标签为开发阶段里程碑，不代表最新公开预览版。
• 页面主题色、歌单固有色及部分视觉细节仍可能继续调整。

Flowtone v0.10.3

Flowtone 0.10.3

此版本包含以下修改：

fix:

修复了曲库页歌单的滚动与动画问题

修复了封面倾斜时的边缘锯齿

修复了歌曲背景流云在切歌的时候会fallback的问题

feat:

加入了可用的歌单系统

添加了无封面时播放器封面的fallback

添加了暂停时封面倾斜的开关

添加了记录阈值与相应时间设置

添加了识别曲师的能力

持久化播放队列的排序偏好

优化播放队列的默认焦点位置为当前播放

添加了播放顺序的列表

style:

优化曲库页歌单卡片的淡入淡出

优化了全屏下更多按钮的收起与动画逻辑

修改了“歌曲记录阈值”窗口的动画

添加了封面暂停时的动画

优化了曲师选择窗口的背景变暗动画

优化播放队列的动画效果

为各形态的MiniPlayer添加切歌动画

为全屏的MiniPlayer添加了下拉箭头按钮

优化全屏后的元素比例

chore

重构了SettingsScreen.kt，OpenSourceScreen.kt

重构了 FlowtoneApp.kt 文件

优化流云取色性能

将 tag 文本模板添加到 Git 提交记录

Install

下载 Flowtone-v0.10.3.apk 后安装即可。

该文件为通用 APK（universal APK），可在不同架构的 Android 设备上安装。

Flowtone v0.10.0

Flowtone 0.10.0

fix:
解决了首次启动时，顶栏动画不加载的问题
修复了列表被 MiniPlayer 覆盖的问题
解决了顶栏中长文本动画抖动的问题
修复了顶栏路径的实现问题
修改了顶栏路径中的“/”渐入渐出动画
修复了子页面的渐入渐出实现问题

feat:
增添了“开源组件”里的内容
添加了下滑让 MiniPlayer 收起的功能
添加了播放被打断时，音乐暂停的行为
添加了可被通话打断播放的行为，并增添相关设置项
添加了流云在暂停时静止的功能
优化了封面的淡入淡出时机
缩小了关于卡片的大小
添加了手动切换深浅色模式的功能
优化返回操作跟手性
添加了 MiniPlayer 的全屏功能

style:
修正 MiniPlayer 的底部为直角
修改了曲库 Item 的渐出动画

chore:
修改版本号到 0.10.0
更改文案“查看许可证全文”->“查看许可证”

Flowtone v0.9.0

增添了顶栏分页与多页面动画

添加了一个占位用应用图标，这不代表最终图标风格。

Flowtone v0.8.3

修改版本号为0.8.3

修改CD构建产物文件名

Flowtone v0.8.2

Flwotone v0.8.2已提交。

更改：

标准化了Flowtone播放链路

添加了 CI/CD 工作流

本次tag也是测试 CI\CD 的一部分。

Flowtone 0.7.1

Flowtone 0.7.1

Changes

• Added release signing configuration.
• Built signed release APK.
• Version code: 70100
• Version name: 0.7.1

Install

Download Flowtone-v0.7.1.apk and install it on Android 9+.

If you previously installed a debug build, uninstall it before installing this release build because debug and release signatures are different.

Flowtone 0.7.1

更新内容

• 新增发布签名配置。

• 构建已签名的发布版 APK。

• 版本代码：70100

• 版本名称：0.7.1

安装

下载 Flowtone-v0.7.1.apk 并将其安装到 Android 9 及更高版本上。

如果您之前安装过调试版本，请在安装此发布版本之前将其卸载，因为调试版本和发布版本的签名不同。