Release Roadmap voor 10.10.0

Onofficiële Beta-vertaling

Deze pagina is vertaald door PageTurner AI (beta). Niet officieel goedgekeurd door het project. Een fout gevonden? Probleem melden →

We zijn verheugd aan te kondigen dat we nu beginnen met het proces voor de 10.10.0-release, met een geplande releasedatum van zaterdag 26 oktober (bijgewerkt - zie onder), 2024! We spraken in onze 10.9.0-releaseberichten over 6 maanden, en we houden ons daaraan! De definitieve feature freeze start volgende week, met vandaag een zachte "nieuwe PR-freeze". Daarom vind je hier de tijdlijn en een samenvatting van hoe je ons kunt helpen met het testen van 10.10.0 vóór release. Onthoud: hoe meer mensen helpen testen vóór release, des te minder bugs we na release vinden. Dus start die secundaire servers op en waarschuw je gebruikers: 10.10.0 komt eraan!

Ontwikkelaars/bijdragers en gebruikers die wat meer informatie willen, lees vooral verder!

- Joshua

De Release

Wat is er deze keer anders?

Bijna niets! We volgen grotendeels hetzelfde proces als bij de 10.9.0-release, maar met een licht aangepaste tijdlijn en beter gedefinieerde stappen.

De Release-tijdlijn

• Maandag 9 september 2024 (unstable 20240909): Laatste kans voor feature-PR's, eerste bèta. Nieuwe feature-PR's moeten nú worden ingediend om de feature freeze niet te missen. Dit is je waarschuwing van 1 week! Ontwikkelaars/bijdragers: blijf op de hoogte van feedback op je PR's, anders kan je PR deadlines missen en moet wachten tot 10.11.0.

• Maandag 16 september 2024 (unstable 20240916): Feature freeze, tweede bèta. Nieuwe feature-PR's moeten na dit moment wachten tot 10.11.0 (over ~6 maanden). Feature-PR's in behandeling kunnen nog worden meegenomen, mits alle feedback vóór de API-freeze is verwerkt. Nogmaals: ontwikkelaars/bijdragers, blijf op de hoogte van feedback op je PR's. Nieuwe PR's moeten na dit punt alleen bugfixes zijn. Gebruikers kunnen veilig serieus beginnen met testen via deze unstable.

• Maandag 23 september 2024 (unstable 20240923): API-freeze, derde bèta. Alle feature-PR's moeten nu zijn samengevoegd. Zo niet, dan worden ze verplaatst naar het 10.11.0-project en pas samengevoegd met master na release van 10.10.0. De API is nu zacht bevroren, zodat clientontwikkelaars zeker kunnen beginnen met benodigde aanpassingen voor 10.10.0.

• Maandag 30 september 2024 (unstable 20240930): API-lock, eerste releasekandidaat. Grote bugfix-PR's zouden nu hopelijk zijn samengevoegd of goed onderweg moeten zijn. Na dit punt alleen bugfixes die de API niet wijzigen. We zouden nu een concept moeten hebben voor een blogpost met feature-overzicht.

• Maandag 7 oktober 2024 (unstable 20241007): Laatste geplande unstable, tweede releasekandidaat. De release zou eigenlijk klaar moeten zijn, en resterende bugfix-PR's moeten vóór deze unstable zijn samengevoegd.

• Zaterdag 12 oktober 2024: Release van 10.10.0!

Mogelijke Tijdlijnwijzigingen

BEWERKING 2024-10-12: We hebben gekozen voor een tweewekelijkse vertraging vanwege noodzakelijke Web-wijzigingen. We plannen nu een release op 26 oktober.

Omdat dit een veel kleinere en snellere release is dan 10.8.0 of 10.9.0, hopen we dat deze periode voldoende is om alles op orde te krijgen. Maar mocht dit niet het geval zijn, behouden we ons het recht voor om een extra week in te lassen op een of beide volgende momenten:

• Na de Feature freeze, als er nog belangrijke bugfixes openstaan die meer tijd nodig hebben om te mergen vóór de API freeze.

• Na de API lock, als er nog niet-API-brekende bugfixes openstaan die meer tijd nodig hebben om te mergen vóór de laatste unstable.

Als geen van beide scenario's zich voordoet, gaat de release door zoals gepland. Anders voegen we een extra stap toe in de tijdlijn na de genoemde momenten, vergelijkbaar met de vorige fase. Dit kan de laatste unstable verschuiven naar 14 of 21 oktober, en de definitieve release naar 19 of 26 oktober. Als dit voor jou relevant is, houd dan ons Announcements Matrix-kanaal in de gaten voor updates.

Informatie voor externe clients

Na de API freeze zou onze API idealiter stabiel moeten blijven, hoewel er mogelijk kleine wijzigingen zijn tot de API lock stap. Je kunt nu gerust compatibiliteitstests starten en problemen aan ons melden. Houd deze data in de gaten voor de definitieve API-specificatie.

Informatie voor bijdragers

Als je bijdraagt aan Jellyfin en je feature-PR's de deadline missen, geen paniek. We hanteren deze kortere releasecyclus voor grote versies, dus 10.11.0 komt over ongeveer 6 maanden. Je functie zal uiteindelijk alsnog worden opgenomen.

Als je een bugfix wilt indienen, doe dit dan zo snel mogelijk. We streven ernaar zoveel mogelijk fixes vóór de API lock te mergen en testen, zodat er minstens 2 weken testtijd overblijft. Vermeld duidelijk dat het een bugfix betreft en beperk wijzigingen tot het absolute minimum. Bugfix-PR's richten zich op de master branch tot de definitieve release, waarna ze overgaan naar de release-10.10.z branch voor toekomstige puntreleases.

Hoe je kunt testen

Het testen van deze release verloopt vergelijkbaar met 10.9.0 en is eenvoudig. Onze prereleases zijn simpelweg de unstable-versies, dus je hoeft alleen de normale unstable-installatieprocedure te volgen.

Bezoek hiervoor onze hoofdpagina voor serverdownloads, selecteer je platform bovenaan in het midden, en kies rechtsboven voor "Unstable". De instructies en links gelden nu voor de unstable release. Je vindt ook extra testdocumentatie in onze docs.

Voor Docker betekent dit simpelweg de unstable-tag van de image pullen. Voor Debian- en Ubuntu-repositories voeg je unstable toe aan je bestaande jellyfin.sources-vermelding. Voor andere platforms raadpleeg je de instructies daar niet alle platforms unstable ondersteunen.

Maak altijd een back-up van je serverconfiguratie vóór installatie van een unstable-release. Terugdraaien ter plekke is onmogelijk door databasewijzigingen. Een eenvoudige kopie van je configuratiemappen met gestopte Jellyfin volstaat. De locatie hiervan verschilt per platform.

Als je plugins gebruikt, installeer dan de onstabiele plugin-repository. Vanwege compatibiliteitsproblemen distribueren we plugins voor onstabiele versies via een apart manifest. Dit moet handmatig worden toegevoegd. Bij de eerste opstart worden alle incompatibele plugins (d.w.z. bestaande plugins bij een upgrade) bijgewerkt. Voeg de repository toe door naar het Beheerdersdashboard te gaan, vervolgens naar Geavanceerd > Plugins, en klik bovenaan op het tabblad Repositories. Klik op de "+" knop en vul "Unstable" in als naam en "https://repo.jellyfin.org/files/plugin-unstable/manifest.json" als Repository-URL. We raden aan om tegelijkertijd de stabiele repository uit te schakelen of te verwijderen, omdat deze mogelijk conflicteren kunnen veroorzaken. Na de eerste update moet je mogelijk je Jellyfin-instantie nog een keer handmatig herstarten om zeker te weten dat alle plugins correct geactiveerd zijn.

Installeer ten slotte de instabiele versie en draai deze. De upgrade zou naadloos op de achtergrond moeten verlopen, waarna je weer normaal kunt inloggen op je Jellyfin-instantie. Voer een volledige verversing uit in je browser en herstart alle clients.

Zodra 10.10.0 volledig is uitgebracht, kun je eenvoudig terugschakelen door de nieuwe stabiele versie opnieuw te installeren en terug te gaan naar het stabiele plugin-manifest (URL "https://repo.jellyfin.org/files/plugin/manifest.json"). Onstabiele releases worden minimaal 2 weken gepauzeerd na de officiële release, zodat je ruim de tijd hebt om over te schakelen.

Hoe bugs te melden

Tijdens het draaien van instabiele pre-releases is het melden van bugs essentieel. Als we namelijk niet van bugs weten, kunnen we ze niet oplossen!

Controleer eerst of je de nieuwste onstabiele versie gebruikt als je een bug tegenkomt, en probeer deze enkele keren te reproduceren. Als dat niet lukt, kan het een eenmalig incident zijn, maar bij herhaling is een melding essentieel.

Bugs kun je melden op onze GitHub-issuespagina of op ons forum.

Voeg twee belangrijke details toe aan je bugrapport. Ten eerste: vermeld altijd de "Build Version" zoals getoond op het hoofddashboard. Dit helpt om te bepalen in welke onstabiele build het probleem optrad, vooral als een bug later verschijnt. Ten tweede: geef duidelijk aan dat je onstabiele builds gebruikt (niet stabiele) en of dit een upgrade of schone installatie betreft, want dat is vaak essentieel.

Controleer na je melding regelmatig of er aanvullende informatie wordt gevraagd. We hopen het probleem snel op te lossen!

Bedankt voor je hulp, en veel kijkplezier!