Attention: Here be dragons
This is the latest
(unstable) version of this documentation, which may document features
not available in or compatible with released stable versions of Godot.
Checking the stable version of the documentation...
Zásady vydání Godotu
Zásady vydávání Godotu se neustále vyvíjí. Níže uvedený popis poskytuje obecnou představu o tom, co lze očekávat, nicméně co se skutečně stane, závisí na volbách hlavních přispěvatelů a potřebách komunity v danou chvíli.
Verzování Godotu
Godot volně následuje Sémantické verzování se systémem verzování major.minor.patch, i když s výkladem jednotlivých termínů přizpůsobeným složitosti herního enginu:
Verze
majorse zvyšuje, když dojde k závažným porušením kompatibility, které by znamenaly značnou práci při přechodu projektů z jedné major verze do druhé.Například převedení Godot projektů z verze Godot 3.x na Godot 4.x vyžaduje aplikaci konverzního nástroje a následné ruční provedení řady dalších úprav toho, co nástroj nemohl udělat automaticky.
Verze
minorse zvyšuje pro verze funkcí, které zásadním způsobem nenarušují kompatibilitu. V minor verzích může dojít k drobným narušením kompatibility ve velmi specifických oblastech, ale naprostá většina projektů by neměla být ovlivněna nebo vyžadovat významnou práci při přechodu.Důvodem je, že Godot jako herní engine pokrývá mnoho oblastí, jako jsou vykreslování, fyzika, skriptování apod. a oprava chyb nebo implementace nových funkcí v dané oblasti může někdy vyžadovat změnu chování funkce nebo úpravu rozhraní dané třídy, i když zbytek API enginu zůstává zpětně kompatibilní.
Tip
Přechod na novou minor verzi se proto doporučuje všem uživatelům, je ale nutné provést testování, abyste se ujistili, že se váš projekt bude i nadále chovat podle očekávání.
Verze
patch("záplata") je zvyšována u údržbových verzí, které se zaměřují na opravy chyb a bezpečnostních problémů, implementaci nových požadavků na podporu platforem a zpětnou podporu bezpečných vylepšení použitelnosti. Vydání patch jsou zpětně kompatibilní.Patch verze mohou obsahovat drobné nové funkce, které nemají vliv na stávající rozhraní API, a tudíž nehrozí, že by ovlivnily stávající projekty.
Tip
Aktualizace na nové patch verze je proto považována za bezpečnou a důrazně doporučována všem uživatelům dané stabilní větve.
Kombinace major.minor nazýváme stabilní větve. Každá stabilní větev začíná vydáním major.minor verze (bez 0 pro patch) a je dále vyvíjena udržovacími verzemi ve stejnojmenné větvi Gitu (například patche pro stabilní větev 4.0 jsou vyvíjeny ve větvi Gitu 4.0).
Časová osa podopory jednotlivých vydání
Stabilní větve jsou podporovány nejméně do doby, než je vydána další stabilní větev a než obdrží první opravnou aktualizaci. V praxi podporujeme stabilní větve na základě nejvyšší snahy tak dlouho, dokud mají aktivní uživatele, kteří potřebují udržovací aktualizace.
Kdykoli je vydána nová hlavní verze, převedeme předchozí stabilní větev na dlouhodobě podporovanou verzi a snažíme se jak nejlépe umíme poskytovat opravy problémů, se kterými se setkali uživatelé této větve, kteří nemohou převést složité projekty do nové hlavní verze. Tak tomu bylo v případě větve 2.1 a je tomu tak i v případě nejnovější stabilní větve 3.x.
V dané řadě minor vydání obdrží podporu pouze nejnovější patch vydání. Pokud se setkáte s problémem při použití staršího patch vydání, aktualizujte na nejnovější patch vydání této řady a před nahlášením problému na GitHubu znovu otestujte.
Verze |
Datum vydání |
Úroveň podpory |
Godot 4.7 (master) |
Q2/Q3 2026 (estimate) |
|
Godot 4.6 |
January 2026 |
|
Godot 4.5 |
September 2025 |
|
Godot 4.4 |
March 2025 |
|
Godot 4.3 |
Srpen 2024 |
|
Godot 4.2 |
Listopad 2023 |
|
Godot 4.1 |
Červenec 2023 |
|
Godot 4.0 |
Březen 2023 |
|
Godot 3.7 (3.x) |
Prozatím bez očekávaného času vydání |
|
Godot 3.6 |
Září 2024 |
|
Godot 3.5 |
Srpen 2022 |
|
Godot 3.4 |
Listopad 2021 |
|
Godot 3.3 |
Duben 2021 |
|
Godot 3.2 |
Leden 2020 |
|
Godot 3.1 |
Březen 2019 |
|
Godot 3.0 |
Leden 2018 |
|
Godot 2.1 |
Červenec 2016 |
|
Godot 2.0 |
Únor 2016 |
|
Godot 1.1 |
Květen 2015 |
|
Godot 1.0 |
Prosinec 2014 |
|
Legenda: 
Plná podpora - 
Částečná podpora - 
Žádná podpora (konec životaschopnosti) - 
Vývojová verze
Vývojové verze Godota nejsou určeny k použití v produkčním prostředí a jsou poskytovány pouze pro testovací účely.
Viz také
Pro pokyny k přechodu projektu z Godot 3.x na 4.x viz Upgrading from Godot 3 to Godot 4.
Jakou verzi bych měl/a použít pro nový projekt?
Pro nové projekty doporučujeme používat Godot 4.x, protože série Godot 4.x bude podporována dlouho poté, co 3.x v budoucnu přestane dostávat aktualizace. Jednou výhradou je, že mnoho dokumentací třetích stran zatím nebylo pro Godot 4.x aktualizováno. Pokud musíte postupovat podle návodu navrženého pro Godot 3.x, doporučujeme ponechat Upgrading from Godot 3 to Godot 4 otevřené v samostatné záložce, abyste zjistili, které metody byly přejmenovány (pokud se při pokusu o použití konkrétního uzlu nebo metody, která byla přejmenována v Godot 4.x, objeví chyba skriptu).
Pokud váš projekt vyžaduje funkci, která ve 4.x chybí (například GLES2/WebGL 1.0), měli byste pro nový projekt použít Godot 3.x.
Mám aktualizovat svůj projekt pro využití nových verzí enginu?
Poznámka
Aktualizace softwaru během práce na projektu je ze své podstaty riskantní, proto před pokusem o aktualizaci zvažte, zda je to pro váš projekt dobrý nápad. Také si svůj projekt zálohujte nebo použijte správu verzí, abyste zabránili ztrátě dat v případě, že se aktualizace nepovede.
Děláme nicméně, co je v našich silách, abychom udrželi menší a zejména opravná vydání kompatibilní se stávajícími projekty.
Obecně se doporučuje aktualizovat svůj projekt tak, aby používal nová patch vydání, jako je přechod z 4.0.2 na 4.0.3. Tak získáte opravy chyb, aktualizace zabezpečení a aktualizace podpory platforem (což je zvláště důležité pro mobilní platformy). Získáte také nepřetržitou podporu, protože pouze poslední vydání opravy dostává podporu na oficiálních komunitních platformách.
U minor verzí byste měli rozhodnout, zda je aktualizace dobrý nápad, případ od případu. Vynaložili jsme velké úsilí, aby byl proces aktualizace co nejplynulejší, ale v minor vydáních mohou být přítomny některé zásadní změny spolu s větším rizikem regresí. Některé opravy zahrnuté v menších vydáních mohou také změnit očekávané chování třídy, když to vyžaduje oprava některých chyb. To je zejména případ tříd označených v dokumentaci jako experimentální.
Major verze přinášejí mnoho nových funkcí, ale také odstraňují dříve existující funkce a mohou zvýšit požadavky na hardware. Jejich aktualizace také vyžaduje mnohem více práce ve srovnání s minor verzemi. V důsledku toho doporučujeme držet se hlavní verze, se kterou jste svůj projekt zahájili, pokud jste spokojeni s tím, jak váš projekt aktuálně funguje. Pokud byl váš projekt například zahájen s 3.5, doporučujeme v budoucnu aktualizovat na 3.5.2 a možná 3.6, nikoli však na 4.0+, pokud váš projekt skutečně nepotřebuje nové funkce, které 4.0+ nabízí.
Kdy vyjde další verze?
Přestože přispěvatelé Godotu nepracují v žádných termínech, snažíme se vydávat minor vydání poměrně často.
In particular, after the very long release cycle for 4.0, we are pivoting to a faster-paced development workflow, 4.1 released 4 months after 4.0, and 4.2 released 4 months after 4.1.
Častější minor verze nám umožní dodávat nové funkce rychleji (potenciálně jako experimentální), rychle získávat zpětnou vazbu od uživatelů a iterovat nad těmito funkcemi a jejich použitelností. Stejně tak se bude obecná uživatelská zkušenost zlepšovat stabilněji, s rychlejší cestou ke koncovým uživatelům.
Udržovací (patch) vydání jsou vydávána podle potřeby s potenciálně velmi krátkými vývojovými cykly, aby uživatelům aktuální stabilní větve poskytly nejnovější opravy chyb pro jejich produkční potřeby.
V současné době neexistuje plánované datum vydání pro další minor 3.x verzi, 3.7. Aktuální stabilní verze 3.6 může být poslední stabilní větví Godotu 3.x. Godot 3.x je podporován na základě nejvyšší snahy, dokud jej budou přispěvatelé nadále udržovat.
Jaká jsou kritéria kompatibility mezi verzemi enginu?
Poznámka
Tato sekce je určena pro přispěvatele k určení, které změny jsou pro dané vydání bezpečné. Seznam není vyčerpávající, pouze nastiňuje nejčastější situace, se kterými se během vývoje Godotu setkáte.
V patch vydáních jsou přijatelné následující změny:
Oprava chyby způsobem, který nemá zásadní negativní dopad na většinu projektů, jako jsou vizuální nebo fyzikální chyby. Fyzikální engine Godotu není deterministický, takže opravy fyzikálních chyb nejsou považovány za porušení kompatibility. Má-li oprava chyby negativní dopad, který by mohl ovlivnit mnoho projektů, měla by být volitelná (např. pomocí nastavení projektu nebo samostatné metody).
Přidání nového volitelného parametru metody.
Malá vylepšení použitelnosti editoru.
Obvykle jsme konzervativnější s opravami, které povolujeme v každém následujícím vydání opravy. Například verze 4.0.1 může získat zásadnější opravy než verze 4.0.4.
Následující změny jsou přijatelné v minor vydáních, ale ne v patch vydáních:
Významné nové funkce.
Přejmenování parametru metody. V C# lze parametry metody předávat jménem (v GDScriptu však ne). To může ve výsledku narušit některé projekty, které používají C#.
Označení metody, členské proměnné nebo třídy za zastaralou. To se provádí přidáním příznaku zastaralé k referenční dokumentací jeho třídy, který se zobrazí v editoru. Když je metoda označena jako zastaralá, je plánováno její odstranění v příštím major vydání.
Změny, které ovlivňují vzhled výchozího motivu projektu.
Opravy chyb, které výrazně mění chování nebo výstup s cílem lépe splnit očekávání uživatelů. Ve srovnání s tím v patch vydáních můžeme upřednostňovat zachování chybného chování, abychom nenarušili stávající projekty, které pravděpodobně již na chybu spoléhají nebo používají náhradní řešení.
Optimalizace výkonu, které vedou k vizuálním změnám.
Následující změny jsou považovány za narušující kompatibilitu a lze je provést pouze v nové major verzi:
Přejmenování nebo odebrání metody, členské proměnné nebo třídy.
Úprava stromu dědičnosti uzlu jeho děděním z jiné třídy.
Změna výchozí hodnoty nastavení projektu způsobem, který ovlivní existující projekty. Chcete-li ovlivnit pouze nové projekty, měl by správce projektů namísto toho vytvořit upravený
project.godot.
Jelikož větev pro Godot 5.0 ještě nebyla vytvořena, v současnosti nedoporučujeme provádět změny tohoto druhu, které narušují kompatibilitu.
Poznámka
Při jakékoli úpravě signatury metody (včetně přidání volitelného parametru) musí být vytvořena metoda kompatibility s GDExtension. Tím je zajištěno, že stávající GDExtension budou nadále fungovat napříč opravami a menšími vydáními, takže je uživatelé nebudou muset znovu kompilovat. Pro další informace viz Handling compatibility breakages.