Назад к блогу

Godot 4.8 Beta 3 уже вышел? Прогоните миграционные тесты, пока сцены не сломались

Опубликовано 13 ноября 2026 г.
Godot 4.8 Beta 3 уже вышел? Прогоните миграционные тесты, пока сцены не сломались Создано с помощью ИИ

Коротко о главном

Прогоните миграционные тесты Godot 4.8 beta 3 и проверьте сцены, физику, сериализацию и GDScript, чтобы ловить регрессии до выхода стабильного релиза.

Снапшот Godot 4.8 beta 3 только что вышел, и команда сообщает, что они приближаются к фазе release candidate. А значит, окно для поиска и репорта регрессий быстро закрывается. Если вы поддерживаете проект на Godot — неважно, релиз у вас в следующем месяце или через год, — сейчас самое время открыть вашу кодовую базу в этом билде и посмотреть, что ломается.

Большинство разработчиков не тестируют беты систематически. Они клонируют билд, открывают проект, просматривают пару сцен глазами и считают, что всё в порядке. А потом выходит stable: физика ощущается иначе, сейвы десериализуются неправильно, а у игрока вылезает малозаметная ошибка парсинга GDScript, которая ни разу не всплывала при разработке. Решение — не героическая отладка после релиза, а повторяемый протокол тестирования, который ловит такие проблемы уже сейчас.

В этом гайде — конкретный рабочий процесс: скрипт миграционного теста, который можно запустить уже сегодня, три конкретные ловушки, которые стоит проверить, и структура репорта о регрессии, которая действительно привлечёт внимание команды Godot.


Почему Beta 3 — ваш дедлайн для тестирования

Beta 3 — последняя бета перед переходом команды Godot к release candidate. Релиз-кандидаты нужны для полировки, а не для обнаружения того, что move_and_slide() ведёт себя иначе на склонах круче 45°. Когда выйдет RC1, новые регрессии будут рассматриваться как блокеры, только если они достаточно серьёзны, чтобы задержать релиз.

Ваша задача в окне беты проста:

  • Находить регрессии, пока они не стали невидимыми в stable-сборке
  • Документировать критические изменения, характерные для кодовой базы вашего проекта
  • Репортить баги с минимальными шагами воспроизведения, чтобы мейнтейнеры могли их исправить

На прошлой неделе команда Godot была на GodotFest и всё равно продолжала пушить фиксы оставшихся release-блокеров. Такой темп. Хотите влиять на то, как 4.8 будет выглядеть на запуске? Тестируйте сейчас.


Настройка ветки для миграционного тестирования

Прежде чем открывать что-либо в beta 3, создайте чистое тестовое окружение:

# Create a dedicated testing branch from your stable codebase
git checkout -b beta/4.8-testing
git push -u origin beta/4.8-testing

Почему отдельная ветка важна: файлы сцен Godot (.tscn) основаны на тексте и содержат метаданные, специфичные для движка. Когда вы открываете сцену в 4.8 beta 3 и сохраняете её, хэш файла меняется. Если вы мержитесь с коллегами на других версиях Godot, это создаёт болезненные merge-конфликты. Держите бета-тестирование изолированным.


Создание скрипта миграционного теста

Самая большая проблема в тестировании, с которой сталкиваются разработчики, — отсутствие базовой линии. Вы открываете проект, он «выглядит нормально», и вы идёте дальше. Проблема в том, что «выглядит нормально» пропускает дрейф физики, отличия в компиляции шейдеров и изменения поведения GDScript, которые проявляются только в определённых условиях.

Вот скрипт миграционного теста, который можно добавить в любой проект Godot 4.x. Он проверяет базовое поведение движка на соответствие ожидаемым значениям:

@tool
extends SceneTree

## Godot 4.8 Beta 3 Migration Test Suite
## Run with: godot --headless -s migration_test.gd
##
## This script validates that core engine behaviors match
## expectations from Godot 4.7.x stable. Run it in both
## the stable build and beta 3, then compare output.

var results: Array[Dictionary] = []

func _init() -> void:
	print("\n╔══════════════════════════════════════════════╗")
	print("║   Godot 4.8 Beta 3 — Migration Test Suite   ║")
	print("╚══════════════════════════════════════════════╝\n")
	
	test_vector_math()
	test_json_parsing()
	test_scene_serialization()
	test_input_map_registration()
	test_color_conversion()
	test_file_access_permissions()
	
	print_summary()
	quit(get_exit_code())

func record(test_name: String, passed: bool, detail: String) -> void:
	results.append({
		"name": test_name,
		"passed": passed,
		"detail": detail
	})

func test_vector_math() -> void:
	# Vector2 operations — regression-prone area in minor releases
	var a := Vector2(3.0, 4.0)
	var b := Vector2(1.0, 0.0)
	
	# Length should be exactly 5.0
	record(
		"Vector2.length()",
		abs(a.length() - 5.0) < 0.001,
		"Expected 5.0, got %.6f" % a.length()
	)
	
	# Normalized vector should have length 1.0
	var normalized := a.normalized()
	record(
		"Vector2.normalized()",
		abs(normalized.length() - 1.0) < 0.001,
		"Expected length 1.0, got %.6f" % normalized.length()
	)
	
	# Dot product: (3,4)·(1,0) = 3.0
	record(
		"Vector2.dot()",
		abs(a.dot(b) - 3.0) < 0.001,
		"Expected 3.0, got %.6f" % a.dot(b)
	)

func test_json_parsing() -> void:
	var test_cases := [
		'{"score": 1500, "level": 12, "name": "TestPlayer"}',
		'{"nested": {"value": true}, "array": [1, 2, 3]}',
		'{"special": "chars: \\\"quotes\\\" and \\\\backslash"}',
	]
	
	for i in test_cases.size():
		var json := JSON.new()
		var error := json.parse(test_cases[i])
		record(
			"JSON.parse() case %d" % i,
			error == OK and json.data is Dictionary,
			"Parse error: %s" % error_string(error) if error != OK else "Parsed successfully with %d keys" % json.data.size()
		)

func test_scene_serialization() -> void:
	# Create a minimal scene and verify round-trip serialization
	var root := Node.new()
	root.name = "TestRoot"
	
	var child := Node2D.new()
	child.name = "TestChild"
	child.position = Vector2(100.5, 200.75)
	child.rotation = 1.5708  # ~90 degrees
	child.scale = Vector2(2.0, 2.0)
	root.add_child(child)
	
	# Test that properties are preserved
	record(
		"Node2D.position precision",
		abs(child.position.x - 100.5) < 0.01 and abs(child.position.y - 200.75) < 0.01,
		"Expected (100.5, 200.75), got (%.2f, %.2f)" % [child.position.x, child.position.y]
	)
	
	record(
		"Node2D.rotation",
		abs(child.rotation - 1.5708) < 0.001,
		"Expected ~1.5708, got %.6f" % child.rotation
	)
	
	root.free()

func test_input_map_registration() -> void:
	var action_name := "__migration_test_action_7f3a"
	var event := InputEventKey.new()
	event.keycode = KEY_SPACE
	
	InputMap.add_action(action_name)
	InputMap.action_add_event(action_name, event)
	
	record(
		"InputMap.add_action()",
		InputMap.has_action(action_name),
		"Action registered: %s" % InputMap.has_action(action_name)
	)
	
	var events := InputMap.action_get_events(action_name)
	record(
		"InputMap.action_get_events()",
		events.size() == 1 and events[0] is InputEventKey,
		"Expected 1 InputEventKey, got %d event(s)" % events.size()
	)
	
	InputMap.erase_action(action_name)
	record(
		"InputMap.erase_action()",
		not InputMap.has_action(action_name),
		"Action erased: %s" % (not InputMap.has_action(action_name))
	)

func test_color_conversion() -> void:
	# Colors can serialize differently across versions
	var red := Color(1.0, 0.0, 0.0, 1.0)
	var hex := red.to_html()
	
	record(
		"Color.to_html()",
		hex == "ff0000ff",
		"Expected 'ff0000ff', got '%s'" % hex
	)
	
	var from_html := Color.html("00ff00ff")
	record(
		"Color.html()",
		abs(from_html.g - 1.0) < 0.001 and abs(from_html.a - 1.0) < 0.001,
		"Expected green (0,1,0,1), got (%.2f, %.2f, %.2f, %.2f)" % [from_html.r, from_html.g, from_html.b, from_html.a]
	)

func test_file_access_permissions() -> void:
	# Verify user:// directory is writable
	var test_path := "user://_migration_test.tmp"
	var file := FileAccess.open(test_path, FileAccess.WRITE)
	record(
		"FileAccess user:// write",
		file != null if true else FileAccess.get_open_error() == OK,
		"File opened for writing: %s" % ("OK" if file != null else error_string(FileAccess.get_open_error()))
	)
	
	if file:
		file.store_string("migration_test_4.8_beta3")
		file.close()
		
		# Read it back
		var reader := FileAccess.open(test_path, FileAccess.READ)
		if reader:
			var content := reader.get_as_text()
			reader.close()
			record(
				"FileAccess user:// read",
				content == "migration_test_4.8_beta3",
				"Read back: '%s'" % content
			)
		
		DirAccess.remove_absolute(test_path)

func print_summary() -> void:
	var passed_count := 0
	for result in results:
		var icon := "✅" if result["passed"] else "❌"
		print("%s  %s: %s" % [icon, result["name"], result["detail"]])
		if result["passed"]:
			passed_count += 1
	
	print("\n────────────────────────────────────────────")
	print("Results: %d / %d tests passed" % [passed_count, results.size()])
	
	if passed_count < results.size():
		var failed := results.size() - passed_count
		print("⚠️  %d test(s) failed." % failed)
		print("   Compare output against Godot 4.7.1 stable.")
		print("   File regressions: https://github.com/godotengine/godot/issues")
	else:
		print("✅  All core behaviors match expected values.")
		print("   This does NOT guarantee full compatibility,")
		print("   but it confirms fundamental APIs are stable.")

func get_exit_code() -> int:
	for result in results:
		if not result["passed"]:
			return 1
	return 0

Запустите его в обоих билдах и сравните вывод:

# In Godot 4.7.1 stable:
godot --headless -s migration_test.gd > results_stable.txt

# In Godot 4.8 beta 3:
godot --headless -s migration_test.gd > results_beta3.txt

# Compare:
diff results_stable.txt results_beta3.txt

Если diff показывает одинаковые результаты pass/fail, ваше базовое поведение пережило апгрейд. Расхождения напрямую указывают на изменение API.


Три миграционные ловушки, которые стоит проверить

Ловушка 1: парсинг GDScript и вывод типов

Парсер GDScript обновляется в каждом минорном релизе. В 4.8 обратите внимание на эти области:

  • Приведение типизированных массивов — поведение конвертации Array[int] и PackedByteArray в последних версиях ужесточили. Если ваш код полагается на неявную конвертацию между типизированными и упакованными массивами, явно протестируйте эти пути выполнения.
  • Порядок выполнения @tool-скриптов — EditorScripts, которые зависят от конкретного порядка инициализации, могут вести себя иначе, если изменились тайминги выполнения.
  • Синтаксис подключения сигналов — паттерн signal.connect(callable) стабилен, но строковые подключения ("signal_name") объявлены устаревшими и могут выдавать предупреждения или ошибки.
# Check your project for these patterns:

# AVOID — string-based signal connections (deprecated):
# node.connect("body_entered", self, "_on_body_entered")

# USE — callable-based connections:
node.body_entered.connect(_on_body_entered)

# AVOID — implicit typed array coercion:
var bytes: PackedByteArray = [72, 101, 108]  # May warn in 4.8

# USE — explicit construction:
var bytes: PackedByteArray = PackedByteArray([72, 101, 108])

Как обнаружить: прогоните grep по проекту на эти паттерны:

# Find deprecated signal connections
grep -rn '\.connect("' --include="*.gd" .

# Find string-based export hints
grep -rn 'export(' --include="*.gd" .

# Find untyped variables that may trigger new warnings
grep -rn 'var [a-z_]* =' --include="*.gd" . | grep -v ':'

Ловушка 2: метаданные файлов сцен

Когда вы открываете файл .tscn в редакторе 4.8 beta 3, сцена сохраняется заново с обновлёнными метаданными. Количество load_steps, значения uid и порядок секций [resource] могут измениться. Обычно это безвредно, но ломает git blame и усугубляет merge-конфликты.

Перед открытием сцен в beta 3:

  1. Экспортируйте текущие хэши сцен: git ls-files '*.tscn' | xargs md5sum > scene_hashes_stable.txt
  2. Откройте проект в beta 3, просмотрите несколько сцен и сохраните их
  3. Повторно экспортируйте: git ls-files '*.tscn' | xargs md5sum > scene_hashes_beta.txt
  4. Сравните: diff scene_hashes_stable.txt scene_hashes_beta.txt

Если изменились только метаданные (содержимое ваших сцен выглядит так же, но файлы отличаются), вы будете знать, чего ожидать при миграции на stable.

Ловушка 3: дрейф базовых показателей физической симуляции

Изменения физики — самая коварная категория регрессий. Ничего не падает. Ошибок нет. Персонаж просто ощущается на 2% медленнее, или снаряд летит по дуге на 5 пикселей ниже, чем раньше. Игроки могут не заметить. QA-команда поймает это в тестах на ощущения, только если будет внимательной.

Решение — тестовая сцена для проверки физических регрессий:

extends Node2D

## Physics Regression Test — Godot 4.8 Beta 3
## Attach this to a Node2D in an empty scene.
## Run the scene and compare the printed positions
## against values from your stable build.

func _ready() -> void:
	await get_tree().create_timer(0.1).timeout
	run_gravity_test()
	run_velocity_test()

func run_gravity_test() -> void:
	var body := CharacterBody2D.new()
	var collision := CollisionShape2D.new()
	var shape := RectangleShape2D.new()
	shape.size = Vector2(16, 32)
	collision.shape = shape
	body.add_child(collision)
	add_child(body)
	
	body.position = Vector2(200, 100)
	body.velocity = Vector2.ZERO
	
	# Simulate 1 second of free fall (60 physics frames)
	for i in range(60):
		body.velocity.y += body.get_gravity().y * (1.0 / 60.0)
		body.move_and_slide()
		await get_tree().physics_frame
	
	var fall_distance := body.position.y - 100.0
	print("[Gravity Test] Fell %.2f pixels in 60 frames" % fall_distance)
	print("  Compare against stable build — deviation > 1.0 px = investigate")
	print("  Expected range: 489.0 - 491.0 (default gravity 980 px/s²)")
	
	body.queue_free()

func run_velocity_test() -> void:
	var body := CharacterBody2D.new()
	var collision := CollisionShape2D.new()
	var shape := RectangleShape2D.new()
	shape.size = Vector2(16, 32)
	collision.shape = shape
	body.add_child(collision)
	add_child(body)
	
	body.position = Vector2(50, 300)
	body.velocity = Vector2(300, 0)
	
	# Move horizontally for 2 seconds
	for i in range(120):
		body.velocity = Vector2(300, 0)
		body.move_and_slide()
		await get_tree().physics_frame
	
	var horizontal_distance := body.position.x - 50.0
	print("[Velocity Test] Moved %.2f pixels horizontally in 120 frames" % horizontal_distance)
	print("  Expected: ~600.0 px (300 px/s × 2 seconds)")
	print("  Deviation > 2.0 px = physics engine behavior changed")
	
	body.queue_free()

Запишите вывод на stable 4.7.x. Запишите его на 4.8 beta 3. Если числа расходятся более чем на 1–2 пикселя, у вас физическая регрессия, о которой стоит сообщить.


Тестирование экспортированных билдов — то, что пропускают большинство разработчиков

Тестирование в редакторе ловит проблемы скриптов и сцен. У экспортированных билдов есть свой класс проблем:

Платформа Зона внимания Частая проблема в 4.x
Windows Компиляция шейдеров, загрузка DLL Кэш шейдеров инвалидируется между версиями Godot
Linux Совместимость Vulkan-драйверов Отличия драйверов Mesa в функциях Vulkan 1.3
Android Задержка touch-ввода, жизненный цикл приложения Пауза/возобновление Activity теряет состояние в новых версиях Android
Web Лимиты памяти, производительность GDScript Emscripten-сборки имеют более строгий потолок памяти
WebXR Переходы в immersive-режим Очистка после выхода из сессии может отличаться от desktop XR

Тест совместимости экспорта:

# Export your project for each target platform
# Save the export output with the Godot version in the filename

# Windows
godot --headless --export-release "Windows Desktop" build/godot471_win.exe
# Then repeat with beta 3:
godot --headless --export-release "Windows Desktop" build/godot48b3_win.exe

# Android APK
godot --headless --export-release "Android" build/godot471_android.apk
godot --headless --export-release "Android" build/godot48b3_android.apk

Запустите каждый билд и выполните стандартный 10-минутный игровой цикл. Обратите внимание на время загрузки, частоту кадров и на то, появляются ли визуальные артефакты, которых не было в stable.


Репорт регрессий, которые действительно исправляют

Трекер проблем Godot получает сотни репортов за каждый релиз. Те, которым быстро назначают разработчика, имеют общую структуру:

## Summary
CharacterBody2D.move_and_slide() produces 3.2% less vertical displacement 
on slopes steeper than 45° compared to Godot 4.7.1 stable.

## Environment
- OS: Windows 11, NVIDIA RTX 3070, driver 551.86
- Godot build: 4.8-beta3 (build hash from Help → Copy Build Info)
- Rendering method: Forward+

## Minimal Reproduction
1. Open attached project
2. Run scene `test_slope_regression.tscn`
3. Observe printed displacement: 456.2 px (expected: 471.3 px)

## Regression Marker
Verified behavior in Godot 4.7.1 stable: displacement is 471.3 px.
Likely introduced between commit [first known good] and [first known bad].

Ключевые элементы, которые делают репорты действенными:

  • Конкретные цифры, а не «кажется, медленнее»
  • Хэш билда из меню Help, а не просто «beta 3»
  • Один файл сцены, воспроизводящий проблему без всего вашего проекта
  • Сравнение со stable, показывающее точные ожидаемые и фактические значения
  • Информация о GPU и драйвере, потому что проблемы рендеринга зависят от железа

Если хотите найти точный коммит, склонируйте исходники Godot и используйте git bisect. Это самый эффективный способ определить, когда была внесена регрессия, и он сильно ускоряет исправления.


Лучшие практики миграции на Godot 4.8

  1. Ведите MIGRATION-4.8.md в репозитории — документируйте каждое изменение API и отличие в поведении, прикладывая строку GDScript и обходное решение. Когда выйдет stable, у вас будет полный гайд по миграции под ваш проект, а не повторное исследование проблем.

  2. Тестируйте циклы save/load — если ваша игра сериализует данные игрока через JSON.stringify() или ResourceSaver.save(), проверьте, что данные, записанные в 4.7.x, корректно загружаются в 4.8 beta 3 и наоборот. Изменения формата сериализации могут незаметно повредить прогресс игрока.

  3. Проверяйте совместимость аддонов — если вы используете GDExtension-плагины или GDScript-аддоны из Asset Library, посмотрите в их GitHub-репозиториях заметки о совместимости с 4.8. Многие мейнтейнеры аддонов не проверяют их на бетах, пока разработчики об этом не попросят. Станьте таким разработчиком.

  4. Тестируйте CI-пайплайн — если в проекте есть автоматические сборки, обновите версию Godot в CI-раннере до 4.8 beta 3 и прогоните весь пайплайн. Скрипты сборки, ссылающиеся на пути редактора или CLI-флаги, могут сломаться, если эти API изменились.

  5. Отдельная проверка рендеринга — запускайте игру с --rendering-driver vulkan, --rendering-driver opengl3 и --rendering-driver d3d12 (Windows), если применимо. Поведение рендер-драйверов расходится между версиями сильнее, чем у любой другой подсистемы.


Когда ваш бэкенд-стек должен пережить апгрейд

Миграции движка затрагивают не только игровой код. Если ваша игра хранит данные игрока удалённо — токены аутентификации, сохранённый прогресс, отправку результатов в лидерборды, — формат сериализации между клиентом и бэкендом должен оставаться согласованным.

Рассмотрим сценарий: в Godot 4.8 изменилась обработка точности чисел с плавающей запятой в значениях Dictionary при JSON.stringify(). Ваш payload облачного сейва меняется с {"x": 100.5} на {"x": 100.499999}. Бэкенду всё равно, но если вы делаете разрешение конфликтов на клиенте (сравнивая локальную и удалённую версии сейва), эта разница на эпсилон вызывает ложные merge-конфликты.

Именно поэтому при миграциях движка важны системы сохранений с учётом ревизий. horizOn предоставляет привязанный к аккаунту Cloud Save с чтением и записью с учётом ревизий, где конфликты разрешаются на клиенте. Когда поведение сериализации движка меняется между версиями, система с учётом ревизий избегает фантомных конфликтов, которые вызвало бы сравнение на равенство.


Ваши следующие шаги

  1. Скачайте Godot 4.8 beta 3 с официального снапшота или попробуйте веб-редактор для быстрого smoke-теста
  2. Создайте тестовую ветку и запустите скрипты миграционных тестов выше
  3. Откройте самые сложные сцены и убедитесь, что они выглядят и ведут себя корректно
  4. Экспортируйте и протестируйте на целевых платформах — не только в редакторе
  5. Репортите регрессии в трекер проблем Godot на GitHub с минимальными шагами воспроизведения

Стабильный релиз выйдет независимо от того, тестируете вы или нет. Разработчики, которые проверяют свои проекты на бетах, выпускают релиз в первый же день. Остальные дебажат проблемы продакшена прямо в окне запуска.


Источник: Dev-снапшот: Godot 4.8 beta 3