跳至主内容

测试 10.9.0 版本

· 1 分钟阅读
Joshua Boniface
Project Leader
非官方测试版翻译

本页面由 PageTurner AI 翻译(测试版)。未经项目官方认可。 发现错误? 报告问题 →

我们很高兴地宣布,10.9.0 版本现已进入功能冻结期!这意味着从现在起到正式发布期间,我们将专注于合并错误修复和其他改进,而所有新功能开发将暂停直至版本最终确定。

这也意味着测试工作即将启动。正如我们上一篇博客所述,本次发布流程有所调整,本文将详细介绍协助测试新版本的具体步骤。

若您希望参与测试,请继续阅读!

—— Joshua

不同之处与发布计划

首先简要说明与以往版本的不同之处。在过去的几个主要版本中,我们反复使用 -beta-rc 标签进行预发布,但考虑到两年前 10.8.0 版本的复杂性,我们决定后续放弃这种做法。虽然预发布标签很有价值,但我们认为在当前阶段及后续工作中,采用每周更新的不稳定版本(unstable builds)是更优解决方案,可避免预发布流程带来的额外负担。

因此,我们的每周不稳定版本现在将同时承担 beta/候选版本的角色。以下是未来几周的版本映射计划:

  • 20240325:首个"beta"版本,功能冻结期开始

  • 20240401:第二个"beta"版本,冻结一周后发布

  • 20240408:第三个"beta"版本,冻结两周后发布,预计修复大部分明显缺陷

  • 20240415:首个"候选发布"(release candidate)版本,预计基本达到发布状态,仅存少量遗留问题

  • 20240422:第二个(理想情况下也是最终)"候选发布"版本

  • 10.9.0:正式版本,计划于 4 月 26-28 日周末发布

当然,以上计划基于顺利推进的前提。虽然我们对此持乐观态度,但不可预见的因素可能导致计划调整,因此我们将根据每周实际情况灵活应对。

信息

更新(2024-05-04): 因部分关键问题,我们决定推迟 10.9.0 版本的发布,确保正式发布时所有功能正常运行。

如何参与测试

本次测试流程较以往版本更为简便。由于预发布版本等同于我们的不稳定版本,您只需遵循常规的"不稳定版本"安装流程即可参与测试。

具体操作:访问我们的主服务器下载页面,在顶部中央选择您需要的平台,然后在右上角选择"Unstable"。此时显示的说明和链接将对应不稳定版本。您还可以在文档中找到额外的测试指南

对于 Docker,这仅意味着拉取镜像的 unstable 标签。对于 Debian 和 Ubuntu 仓库,这意味着在您现有的 jellyfin.sources 条目中添加 unstable。对于其他平台,请查阅提供的说明,因为并非所有平台都支持不稳定版本。

重要提示:安装不稳定版本前,请务必备份现有服务器配置!由于存在大量数据库变更,版本降级将不可行。只需简单复制配置目录即可,具体路径取决于您的运行平台。

Next, if you use plugins, install the unstable plugin repository. Due to compatibility issues, we distribute plugins for unstable in a separate manifest, so this must be added manually, and on first start all incompatible plugins (i.e. all existing plugins on an upgrade) will be upgraded. To add the repository, navigate to the Administration Dashboard, Advanced, Plugins, then click the Repositories tab at the top. Click the "+" Add button, and enter "Unstable" for the name and "https://repo.jellyfin.org/files/plugin-unstable/manifest.json" for the Repository URL. We also recommend that you disable/remove the Stable repository at this time, as it's possible they will conflict, and under 10.9.0 the repository URL will change. After the initial update you may need to manually restart your Jellyfin instance one further time to ensure all plugins are activated properly.

最后,安装不稳定版本并运行。升级将在后台无缝完成,之后您即可正常登录Jellyfin实例。请务必在浏览器执行硬刷新(hard refresh),并重启所有客户端应用。

待 10.9.0 版本正式发布后,您只需重新安装新的稳定版本,并切换回稳定版插件清单 (URL "https://repo.jellyfin.org/files/plugin/manifest.json") 即可轻松完成回退。

如何报告错误

运行不稳定预发布版本时,报告错误至关重要。毕竟如果我们不知道问题存在,就无法着手修复!

首先,如果遇到错误,请确认您运行的是最新版本,并尝试复现问题。若无法复现,可能是偶发情况;但若再次出现,请务必提交报告!

错误可报告至我们的GitHub issues页面论坛

除常规信息外,报告中请包含两项关键内容:第一,注明主控制台页面显示的"构建版本号",这有助于精确定位问题根源——若后续不稳定版本出现新错误,此信息尤为重要。第二,请明确说明您运行的是不稳定版本而非稳定版,并注明是升级安装还是全新安装,这些信息至关重要。

提交报告后,请及时查看是否有额外信息请求,我们将全力争取尽快修复。

第三方客户端须知

当前功能冻结阶段,API应保持稳定,但未来几周仍需进行细微修复调整。欢迎开始测试兼容性,发现任何问题请向我们反馈。

贡献者须知

若您有未合并的功能PR,请不必担心。10.9.0发布周期异常漫长(我们不愿再出现这种情况),您的修改必将随10.10.0版本上线——预计最迟6个月内发布。

若您希望提交错误修复,请尽快操作。我们计划在未来约3周内合并并测试尽可能多的修复,为发布预留至少2周最终测试期。请明确标注为错误修复,并确保修改范围严格限于问题本身。在最终版本发布前,错误修复PR应指向master分支;发布后将改至release-10.9.z分支用于后续补丁版本。