العودة إلى المدونة

Godot 4.8 Beta 3 وشيك؟ نفّذ اختبارات الترحيل هذه قبل أن تتعطل مشاهدك

نُشر في 13 نوفمبر 2026
Godot 4.8 Beta 3 وشيك؟ نفّذ اختبارات الترحيل هذه قبل أن تتعطل مشاهدك تم إنشاؤها بمساعدة الذكاء الاصطناعي

باختصار

اكتشف الآن كيف تختبر مشروع Godot مع إصدار 4.8 Beta 3 باستخدام سكربتات اختبار الترحيل الجاهزة، وتجنب كسر مشاهدك قبل وصول الإصدار المستقر النهائي.

لقد صدرت للتو لقطة Godot 4.8 beta 3، ويقول الفريق إنهم يقتربون من مرحلة الإصدار المرشح. هذا يعني أن نافذة اكتشاف الانحدارات والإبلاغ عنها تتقلص بسرعة. إذا كنت تحافظ على مشروع Godot — سواء كان سيُطلق الشهر القادم أو بعد عام من الآن — فهذا هو الوقت المناسب لفتح قاعدة الكود الخاصة بك في هذا الإصدار ومعرفة ما الذي سينكسر.

معظم المطورين لا يختبرون الإصدارات التجريبية بشكل منهجي. يستنسخون البناء، يفتحون مشروعهم، يلقون نظرة سريعة على بضع مشاهد، ويعتبرون الأمر منتهيًا. ثم يصدر الإصدار المستقر، فنجد أن الفيزياء أصبحت مختلفة، وملفات الحفظ تُفك تسلسلها بشكل غير صحيح، ويصطدم لاعب بخطأ غامض في تحليل GDScript لم يحدث أبدًا أثناء التطوير. الحل ليس تصحيحًا بطوليًا بعد الإطلاق، بل بروتوكول اختبار قابل للتكرار يلتقط هذه المشكلات الآن.

يقدم لك هذا الدليل سير عمل ملموسًا: سكربت اختبار ترحيل يمكنك تشغيله اليوم، وثلاثة مزالق محددة يجب فحصها، وهيكل للإبلاغ عن الانحدارات يلفت انتباه فريق Godot فعليًا.


لماذا Beta 3 هو موعدك النهائي للاختبار

Beta 3 هو آخر إصدار تجريبي قبل انتقال فريق Godot إلى الإصدارات المرشحة. الإصدارات المرشحة مخصصة للصقل، وليست لاكتشاف أن move_and_slide() تتصرف بشكل مختلف على المنحدرات الأكثر انحدارًا من 45°. بحلول وقت إصدار RC1، لن تُصنف الانحدارات الجديدة على أنها عوائق إلا إذا كانت شديدة بما يكفي لتأخير الإصدار.

مهمتك خلال نافذة الإصدار التجريبي واضحة:

  • اكتشف الانحدارات قبل أن تصبح غير مرئية في الإصدار المستقر
  • وثّق التغييرات الجذرية الخاصة بقاعدة كود مشروعك
  • أبلغ عن الأخطاء بخطوات إعادة إنتاج بسيطة ليتمكن المشرفون من إصلاحها

كان فريق Godot في GodotFest الأسبوع الماضي وما زالوا يدفعون بإصلاحات للعوائق المتبقية قبل الإصدار. هذا هو الإيقاع. إذا كنت تريد رأيًا في شكل 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 مختلفة، فسيؤدي ذلك إلى تعارضات دمج مؤلمة لحلها. أبقِ اختبار beta معزولًا.


بناء سكربت اختبار الترحيل

أكبر فجوة اختبارية يصطدم بها المطورون هي عدم وجود خط أساس. تفتح المشروع، يبدو «جيدًا»، وتنتقل إلى التالي. المشكلة: أن يبدو جيدًا يفوّت انحراف الفيزياء، واختلافات ترجمة الـ Shader، وتغيرات سلوك 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

إذا أظهرت المقارنة نتائج نجاح/فشل متطابقة، فهذا يعني أن سلوكياتك الأساسية نجت من الترقية. أما الاختلافات فتشير مباشرة إلى تغيير الـ API.


ثلاثة مزالق ترحيل يجب فحصها

المزلقة الأولى: تحليل 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])

طريقة الاكتشاف: ابحث في مشروعك عن هذه الأنماط:

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

المزلقة الثانية: البيانات الوصفية لملفات المشاهد

عندما تفتح ملف .tscn في محرر 4.8 beta 3، يُعاد حفظ المشهد ببيانات وصفية محدثة. قد يتغير عدد load_steps، وقيم uid، وترتيب قسم [resource]. هذا عادةً غير ضار، لكنه يكسر git blame ويزيد تعارضات الدمج سوءًا.

قبل فتح المشاهد في 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

إذا تغيرت البيانات الوصفية فقط (محتوى مشاهدك يبدو نفسه لكن الملفات مختلفة)، فستعرف ما المتوقع عند الترحيل على الإصدار المستقر.

المزلقة الثالثة: انحراف خط أساس محاكاة الفيزياء

تغيرات الفيزياء هي أكثر فئات الانحدار خداعًا. لا شيء ينهار. لا تظهر أخطاء. شخصيتك فقط تشعر أنها أبطأ بنسبة 2%، أو أن مقذوفك ينخفض 5 بكسل عن السابق. قد لا يلاحظ اللاعبون ذلك. فريق ضمان الجودة لديك لن يلتقطه في اختبار الإحساس إلا إذا كان منتبهًا.

الحل — مشهد اختبار انحدار الفيزياء:

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

سجّل المخرجات من 4.7.x المستقر. سجّلها من 4.8 beta 3. إذا اختلفت الأرقام بأكثر من 1-2 بكسل، فلديك انحدار فيزيائي يستحق الإبلاغ.


اختبار البناءات المُصدَّرة — الأجزاء التي يتجاهلها معظم المطورين

اختبار المحرر يلتقط مشكلات السكربتات والمشاهد. البناءات المُصدَّرة لها فئة مشكلات خاصة بها:

المنصة مجال التركيز المزلقة الشائعة في 4.x
Windows ترجمة الـ Shader، تحميل DLL ذاكرة التخزين المؤقت للـ Shader تُبطل بين إصدارات Godot
Linux توافق برامج تشغيل Vulkan اختلافات برامج تشغيل Mesa مع ميزات Vulkan 1.3
Android زمن استجابة اللمس، دورة حياة التطبيق فقدان الحالة عند إيقاف/استئناف النشاط في إصدارات Android الأحدث
Web حدود الذاكرة، أداء GDScript البناءات المترجمة عبر Emscripten لديها سقف ذاكرة أكثر صرامة
WebXR انتقالات الوضع الغامر تنظيف الخروج من الجلسة قد يختلف عن سطح المكتب 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 دقائق. انتبه إلى أوقات التحميل، ومعدل الإطارات، وما إذا ظهرت أي تشوهات بصرية لم تكن موجودة في الإصدار المستقر.


الإبلاغ عن الانحدارات التي يتم إصلاحها

يتلقى متتبع مشكلات 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»
  • ملف مشهد واحد يعيد إنتاج المشكلة دون مشروعك بالكامل
  • مقارنة بالإصدار المستقر تُظهر القيم المتوقعة مقابل الفعلية بدقة
  • معلومات GPU وبرنامج التشغيل لأن مشكلات العرض تعتمد على العتاد

إذا أردت تحديد commit الدقيق، استنسخ مصدر Godot واستخدم git bisect. إنها الطريقة الأكثر كفاءة لتحديد متى تم إدخال الانحدار وتسرّع الإصلاحات بشكل كبير.


أفضل الممارسات لترحيل Godot 4.8 لديك

  1. احتفظ بملف MIGRATION-4.8.md في مستودعك — كل تغيير في الـ API تصادفه، وكل اختلاف في السلوك، وثّقه مع سطر GDScript والحل البديل. عندما يصدر الإصدار المستقر، سيكون لديك دليل ترحيل كامل خاص بمشروعك بدلًا من إعادة اكتشاف المشكلات.
  2. اختبر دورات الحفظ/التحميل — إذا كانت لعبتك تسلسل بيانات اللاعب باستخدام 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 قد تنكسر إذا تغيرت هذه الـ APIs.
  5. تحقق من العرض بشكل منفصل — شغّل لعبتك باستخدام --rendering-driver vulkan و--rendering-driver opengl3 و--rendering-driver d3d12 (على Windows) إذا كان ذلك ممكنًا. سلوك برامج تشغيل العرض يتباعد بين الإصدارات أكثر من أي نظام فرعي آخر.

عندما تحتاج حزمة الـ Backend لديك إلى النجاة من الترقية

ترحيل المحرك يؤثر على أكثر من مجرد كود اللعب. إذا كانت لعبتك تخزن بيانات اللاعب عن بُعد — رموز المصادقة، التقدم المحفوظ، إرسال لوحات الصدارة — فيجب أن يظل تنسيق التسلسل بين عميلك والـ Backend متسقًا.

تأمل هذا السيناريو: Godot 4.8 يغيّر كيفية تعامل JSON.stringify() مع دقة الفاصلة العائمة في قيم Dictionary. تتحول حمولة الحفظ السحابي من {"x": 100.5} إلى {"x": 100.499999}. الـ Backend لديك لا يهتم، لكن إذا كنت تقوم بحل التعارضات من جهة العميل (مقارنة النسخ المحلية والبعيدة من بيانات الحفظ)، فإن فرق إبسيلون هذا يسبب تعارضات دمج زائفة.

لهذا السبب تهم أنظمة الحفظ المدركة للتنقيحات أثناء ترحيل المحرك. horizOn يوفر Cloud Save مرتبطًا بالحساب مع قراءة وكتابة مدركة للتنقيحات، حيث يتولى العميل حل التعارضات. عندما يتغير سلوك التسلسل في محركك بين الإصدارات، يتجنب النظام المدرك للتنقيحات التعارضات الوهمية التي قد تسببها المقارنة القائمة على المساواة.


خطواتك التالية

  1. حمّل Godot 4.8 beta 3 من اللقطة الرسمية أو جرّب محرر الويب لاختبار سريع
  2. أنشئ فرع الاختبار الخاص بك وشغّل سكربتات اختبار الترحيل أعلاه
  3. افتح أكثر مشاهدك تعقيدًا وتحقق من أنها ما تزال تبدو وتتصرف بشكل صحيح
  4. صدّر واختبر على منصاتك المستهدفة — وليس في المحرر فقط
  5. أبلغ عن الانحدارات في متتبع مشكلات Godot على GitHub بخطوات إعادة إنتاج بسيطة

الإصدار المستقر قادم سواء اختبرت أم لا. المطورون الذين يتحققون من الإصدارات التجريبية يُطلقون في اليوم الأول. أما البقية فيتوجب عليهم تصحيح مشكلات الإنتاج خلال نافذة إطلاقهم.


المصدر: لقطة تطويرية: Godot 4.8 beta 3