Bloga Dön

Godot 4.8 Beta 3 Çıkıyor mu? Sahneleriniz Bozulmadan Önce Bu Migrasyon Testlerini Çalıştırın

Yayınlanma tarihi 13 Kasım 2026
Godot 4.8 Beta 3 Çıkıyor mu? Sahneleriniz Bozulmadan Önce Bu Migrasyon Testlerini Çalıştırın Yapay zekâ yardımıyla oluşturuldu

Özet olarak

Test edin: Godot 4.8 Beta 3 için kapsamlı migrasyon testlerini şimdi çalıştırın, sahne kırılmalarını önleyin ve regresyonları doğru raporlayın.

Godot 4.8 beta 3 anlık görüntüsü yayınlandı ve ekip, sürüm adayı aşamasına yaklaştıklarını söylüyor. Bu, regresyonları bulup raporlamak için pencerenin hızla daraldığı anlamına geliyor. Bir Godot projesi bakımını yapıyorsanız — ister önümüzdeki ay ister bir yıl sonra çıkacak olsun — şimdi kod tabanınızı bu derlemede açıp neyin bozulduğunu görme zamanı.

Çoğu geliştirici beta sürümlerini sistematik olarak test etmez. Derlemeyi kopyalar, projelerini açar, birkaç sahneye göz atar ve işi bitirir. Sonra kararlı sürüm çıkar, fizik farklı hissettirir, kayıt dosyaları hatalı deserialize olur ve bir oyuncu geliştirme sırasında asla tetiklenmeyen belirsiz bir GDScript ayrıştırma hatasıyla karşılaşır. Çözüm, lansman sonrası kahramanca hata ayıklama değil. Bu sorunları şimdi yakalayan tekrarlanabilir bir test protokolüdür.

Bu rehber size somut bir iş akışı sunuyor: bugün çalıştırabileceğiniz bir migrasyon test betiği, taramanız gereken üç belirli tuzak ve Godot ekibinin gerçekten dikkatini çeken bir regresyon raporlama yapısı.


Beta 3 Neden Test Son Tarihiniz?

Beta 3, Godot ekibinin sürüm adaylarına geçmeden önceki son betadır. Sürüm adayları cilalama içindir, move_and_slide()'in 45°'den dik yokuşlarda farklı davranmasını keşfetmek için değil. RC1 yayınlandığında, yeni regresyonlar yalnızca sürümü geciktirecek kadar ciddiyse engelleyici olarak sınıflandırılır.

Beta penceresi sırasında göreviniz basittir:

  • Regresyonları kararlı sürümde görünmez olmadan önce bulun
  • Projenizin kod tabanına özgü kırıcı değişiklikleri belgeleyin
  • Bakımcıların düzeltebilmesi için minimum yeniden üretim adımlarıyla hata raporlayın

Godot ekibi geçen hafta GodotFest'teydi ve hâlâ kalan sürüm engelleyicileri için düzeltmeler gönderiyordu. Tempo bu. 4.8'in lansmanda nasıl görüneceği konusunda söz sahibi olmak istiyorsanız, şimdi test edin.


Migrasyon Test Dalı Oluşturma

Beta 3'te hiçbir şey açmadan önce temiz bir test ortamı oluşturun:

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

Ayrı bir dal neden önemli: Godot sahne dosyaları (.tscn) metin tabanlıdır ve motora özgü meta veriler içerir. Bir sahneyi 4.8 beta 3'te açıp kaydettiğinizde dosya karması değişir. Farklı Godot sürümlerinde çalışan ekip üyeleriyle birleştirme yapıyorsanız, bu çözmesi acı verici birleştirme çakışmaları yaratır. Beta testini izole tutun.


Migrasyon Test Betiği Oluşturma

Geliştiricilerin karşılaştığı en büyük test açığı, bir temel çizginin olmamasıdır. Projeyi açarsınız, "iyi görünüyor" dersiniz ve devam edersiniz. Sorun şu: iyi görünüyor fizik kaymasını, shader derleme farklılıklarını ve yalnızca belirli koşullarda ortaya çıkan GDScript davranış değişikliklerini gözden kaçırır.

İşte herhangi bir Godot 4.x projesine ekleyebileceğiniz bir migrasyon test betiği. Temel motor davranışlarını beklenen değerlere karşı doğrular:

@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

Her iki derlemede de çalıştırın ve çıktıyı karşılaştırın:

# 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, aynı geçti/kaldı sonuçlarını gösteriyorsa, temel davranışlarınız yükseltmeden sağ çıkmış demektir. Farklılıklar sizi doğrudan API değişikliğine işaret eder.


Taramanız Gereken Üç Migrasyon Tuzağı

Tuzak 1: GDScript Ayrıştırma ve Tip Çıkarımı

GDScript ayrıştırıcısı her küçük sürümde güncellenir. 4.8'de şu belirli alanlara dikkat edin:

  • Tipli dizi zorlaması — Array[int] ile PackedByteArray dönüştürme davranışı son sürümlerde sıkılaştırıldı. Kodunuz tipli diziler ile paketlenmiş diziler arasında örtük dönüştürmeye dayanıyorsa, bu kod yollarını açıkça test edin.
  • @tool betik değerlendirme sırası — Belirli bir başlatma sırasına bağlı EditorScript'ler, değerlendirici zamanlaması değiştiyse farklı davranabilir.
  • Sinyal bağlantı sözdizimi — signal.connect(callable) deseni kararlıdır, ancak dize tabanlı bağlantılar ("signal_name") kullanımdan kaldırılmıştır ve uyarı veya hata verebilir.
# 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])

Tespit yaklaşımı: Projenizde şu desenleri arayın:

# 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 ':'

Tuzak 2: Sahne Dosyası Meta Verileri

Bir .tscn dosyasını 4.8 beta 3 düzenleyicisinde açtığınızda, sahne güncellenmiş meta verilerle yeniden kaydedilir. load_steps sayısı, uid değerleri ve [resource] bölüm sıralaması değişebilir. Bu genellikle zararsızdır, ancak git blame'i bozar ve birleştirme çakışmalarını kötüleştirir.

Beta 3'te sahneleri açmadan önce:

  1. Mevcut sahne karmalarınızı dışa aktarın: git ls-files '*.tscn' | xargs md5sum > scene_hashes_stable.txt
  2. Projeyi beta 3'te açın, birkaç sahneye göz atın, kaydedin
  3. Yeniden dışa aktarın: git ls-files '*.tscn' | xargs md5sum > scene_hashes_beta.txt
  4. Karşılaştırın: diff scene_hashes_stable.txt scene_hashes_beta.txt

Yalnızca meta veriler değiştiyse (sahnelerinizin içeriği aynı görünüyor ancak dosyalar farklıysa), kararlı sürümde geçiş yaptığınızda ne bekleyeceğinizi bilirsiniz.

Tuzak 3: Fizik Simülasyonu Temel Çizgi Kayması

Fizik değişiklikleri en sinsi regresyon kategorisidir. Hiçbir şey çökmez. Hata görünmez. Karakteriniz sadece %2 daha yavaş hissettirir veya merminiz eskisinden 5 piksel daha alçaktan uçar. Oyuncular fark etmeyebilir. QA ekibiniz, yalnızca dikkat ediyorlarsa his testinde bunu yakalayacaktır.

Çözüm — bir fizik regresyon test sahnesi:

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()

Çıktıyı kararlı 4.7.x'ten kaydedin. 4.8 beta 3'ten kaydedin. Sayılar 1-2 pikselden fazla farklıysa, raporlamaya değer bir fizik regresyonunuz var demektir.


Dışa Aktarılan Derlemeleri Test Etme — Çoğu Geliştiricinin Atladığı Kısımlar

Düzenleyici testleri, betik ve sahne sorunlarını yakalar. Dışa aktarılan derlemelerin kendine özgü sorunları vardır:

Platform Odak Alanı Yaygın 4.x Tuzağı
Windows Shader derleme, DLL yükleme Shader önbelleği Godot sürümleri arasında geçersiz kılınır
Linux Vulkan sürücü uyumluluğu Mesa sürücüsü farklılıkları Vulkan 1.3 özellikleriyle
Android Dokunmatik giriş gecikmesi, uygulama yaşam döngüsü Daha yeni Android sürümlerinde Activity duraklatma/devam ettirme durum kaybı
Web Bellek sınırları, GDScript performansı Emscripten ile derlenen derlemeler daha katı bellek tavanına sahiptir
WebXR Sürükleyici mod geçişleri Oturumdan çıkış temizliği masaüstü XR'dan farklı olabilir

Dışa aktarma uyumluluk testi:

# 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

Her derlemeyi çalıştırın ve standart 10 dakikalık bir oynanış döngüsü gerçekleştirin. Yükleme sürelerine, kare hızına ve kararlı sürümde olmayan görsel bozuklukların ortaya çıkıp çıkmadığına dikkat edin.


Düzeltilen Regresyonları Raporlama

Godot'un hata izleyicisi her sürümde yüzlerce rapor alır. Hızlıca bir geliştirici atananlar ortak bir yapıya sahiptir:

## 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].

Raporları eyleme dönüştürülebilir kılan temel öğeler:

  • Belirli sayılar, "daha yavaş görünüyor" değil
  • Yardım menüsünden derleme karması, yalnızca "beta 3" değil
  • Sorunu tüm projeniz olmadan yeniden üreten tek sahne dosyası
  • Beklenen ve gerçek değerleri gösteren kararlı sürümle karşılaştırma
  • İşleme sorunları donanıma bağlı olduğundan GPU ve sürücü bilgisi

Tam commit'i bisect etmek istiyorsanız, Godot kaynağını klonlayın ve git bisect kullanın. Bir regresyonun ne zaman eklendiğini belirlemenin en verimli yolu budur ve düzeltmeleri büyük ölçüde hızlandırır.


Godot 4.8 Migrasyonunuz için En İyi Uygulamalar

  1. Deponuzda bir MIGRATION-4.8.md tutun — Karşılaştığınız her API değişikliğini, her davranış farkını, GDScript satırı ve geçici çözümle belgeleyin. Kararlı sürüm çıktığında, sorunları yeniden keşfetmek yerine eksiksiz, projeye özel bir migrasyon rehberiniz olur.

  2. Kaydetme/yükleme döngülerini test edin — Oyununuz oyuncu verilerini JSON.stringify() veya ResourceSaver.save() ile serileştiriyorsa, 4.7.x ile yazılan verilerin 4.8 beta 3'te doğru yüklendiğini ve bunun tersini doğrulayın. Serileştirmedeki biçim değişiklikleri oyuncu ilerlemesini sessizce bozabilir.

  3. Eklenti uyumluluğunu kontrol edin — Asset Library'den GDExtension eklentileri veya GDScript eklentileri kullanıyorsanız, GitHub depolarında 4.8 uyumluluk notlarını kontrol edin. Birçok eklenti bakımcısı, geliştiriciler talep etmedikçe beta sürümlere karşı test etmez. O geliştirici siz olun.

  4. CI hattınızı test edin — Projenizin otomatik derlemeleri varsa, CI çalıştırıcınızdaki Godot sürümünü 4.8 beta 3'e güncelleyin ve tüm hattınızı çalıştırın. Düzenleyici yollarına veya CLI bayraklarına başvuran derleme betikleri, bu API'ler değiştiyse bozulabilir.

  5. Ayrı işleme doğrulaması — Oyununuzu uygunsa --rendering-driver vulkan, --rendering-driver opengl3 ve --rendering-driver d3d12 (Windows) ile çalıştırın. İşleme sürücüsü davranışı, sürümler arasında diğer tüm alt sistemlerden daha fazla farklılık gösterir.


Backend Yığınınızın Yükseltmeden Sağ Çıkması Gerektiğinde

Motor migrasyonları yalnızca oynanış kodunu etkilemez. Oyununuz oyuncu verilerini uzaktan depoluyorsa — kimlik doğrulama belirteçleri, kayıtlı ilerleme, lider tablosu gönderimleri — istemciniz ile backend'iniz arasındaki serileştirme biçimi tutarlı kalmalıdır.

Şu senaryoyu düşünün: Godot 4.8, JSON.stringify()'in Dictionary değerlerinde kayan nokta hassasiyetini nasıl ele aldığını değiştiriyor. Bulut kayıt yükünüz {"x": 100.5} yerine {"x": 100.499999} olur. Backend'iniz umursamaz, ancak istemci tarafında çakışma çözümü yapıyorsanız (kayıt verilerinin yerel ve uzak sürümlerini karşılaştırma), bu epsilon farkı sahte birleştirme çakışmalarına neden olur.

Bu yüzden motor migrasyonları sırasında revizyon farkında kayıt sistemleri önemlidir. horizOn, istemcinin çakışma çözümünü üstlendiği, revizyon farkında okuma ve yazma işlemleriyle hesaba bağlı Cloud Save sağlar. Motorunuzun serileştirme davranışı sürümler arasında değiştiğinde, revizyon farkında bir sistem, eşitlik tabanlı karşılaştırmanın tetikleyeceği hayalet çakışmaları önler.


Sonraki Adımlarınız

  1. Godot 4.8 beta 3'ü resmi anlık görüntüden indirin veya hızlı bir duman testi için web düzenleyicisini deneyin
  2. Test dalınızı oluşturun ve yukarıdaki migrasyon test betiklerini çalıştırın
  3. En karmaşık sahnelerinizi açın ve hâlâ doğru görünüp davrandıklarını doğrulayın
  4. Dışa aktarın ve test edin hedef platformlarınızda — yalnızca düzenleyicide değil
  5. Minimum yeniden üretim adımlarıyla Godot GitHub hata izleyicisine regresyon bildirin

Kararlı sürüm, test etseniz de etmeseniz de geliyor. Beta sürümlere karşı doğrulama yapan geliştiriciler ilk gün yayınlar. Geri kalanlar, lansman penceresi sırasında üretim sorunlarını hata ayıklamak zorunda kalır.


Kaynak: Geliştirici anlık görüntüsü: Godot 4.8 beta 3