Spotube 中文文档 下载 App

Spotube Nightly 版异常——比 Stable 更新、也更容易坏

Nightly 为什么容易坏

Nightly 是每天自动从 dev 分支构建的版本。dev 分支是开发前沿:

正常现象:Nightly 出现崩溃、UI 错乱、某些功能按钮消失——这些都是 Spotube 团队在开发期预期内的"正常"。Stable 版才是生产级的。

常见 Nightly 异常和处理

1. 启动即崩溃

症状:双击图标 → 一闪就没了。

最常见原因:数据库 schema 变了,Nightly 升级后旧数据格式不兼容。

临时处理:

  1. 关掉 Spotube
  2. 备份数据库文件(spotube.db)
  3. 删掉数据库文件(Spotube 启动时会自动重建空数据库)
  4. 启动 → 正常了,但播放列表和收藏会丢(因为数据库重建了)

不推荐的处理:

2. UI 错乱(按钮消失 / 布局重叠 / 文字乱码)

症状:界面看起来"缺了一块"或"挤在一起"。

原因:Nightly 正在做 UI 重构(Spotube v5 期间做过多次),某天的 Nightly 可能是重构到一半的状态。

处理:

3. 插件不兼容

症状:插件启用后 Spotube 崩 / 插件页显示版本不匹配。

原因:Nightly 可能引入了 plugin_interfaces 的 breaking change(接口签名变了),社区插件没跟进。

处理:

4. 功能缺失

症状:Stable 上有的按钮在 Nightly 上找不到。

原因:重构时暂时移除了某个功能(还没加回来),或改了位置。

处理:

导出 debug log 给维护者

Spotube 设置 → Debug → Export debug log。Nightly 问题一定带 debug log 报告——维护者只靠 log 就能定位绝大多数崩溃。

导出的 log 文件里重点搜这些关键字:

回退 Stable 版

当 Nightly 持续崩:

  1. 下载对应平台的 Stable 版安装包
  2. 不要删旧版数据——Stable 可能能正常读取
  3. 直接覆盖安装(Stable 通常能向下兼容 Nightly 的数据格式)
  4. 如果 Stable 也崩溃了,再用上面的方法删数据库

如何决定用不用 Nightly

情况建议
你是普通用户,只想正常听歌用 Stable,永远
你是早期 adopters,想提前测新功能可以用,但接受崩溃
你是插件开发者,需要最新 plugin_interfaces用 nightly,但每开新版本先删数据库
你在为 Spotube 报告 Bug用 nightly(维护者要求 bug 在 dev 分支可复现)

Nightly 的稳定性保证

Spotube 团队不做任何稳定性承诺。Nightly 就是用来让"想测、愿意测、能忍 bug"的人测的。如果你用 nightly 遇到 bug,维护者希望你报告——但他们不会因为 nightly 崩了就觉得是自己的问题,这是 nightly 的设计本意。

快速切换回 Stable 的最短路径

  1. 下载 Stable
  2. 关掉 Nightly
  3. 安装 Stable 到同一目录(覆盖)
  4. 启动 Stable → 检查数据是否正常 → 不行就删数据库重建
  5. 继续正常用 Stable,等下一个 Stable Release(每 3~4 个月)