عرض مصدر Godot/migrating/upgrading to godot 4.1

<noinclude>{{DISPLAYTITLE: الترقية من جودو 4.0 إلى جودو 4.1}}</noinclude>

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

== التغييرات التي تتسبب بمشكلات ==
ستؤثر عليك التغييرات التي تعطي مشاكل المذكورة هنا إذا كنت تنتقل من 4.0 إلى 4.1، تم تجميع التغييرات حسب الموقع/النظام<blockquote>تنبيه: إن واجهة برمجة التطبيقات الخاصة بـ GDExtention تعطي مشاكل توافق في 4.1 لذا هي غير مذكورة في الجداول التالية. راجع قسم تحديث GDExtentintion الخاص بك إلى 4.1 لمزيد من المعلومات.</blockquote>تشير هذه القائمة إذا ما كان يؤثر التغيير الذي يعطي المشاكل على GDScript وإذا كان متوافق مع الثنائي أو متوافق مع المصدر

* '''متوافق مع الملف الثنائي''' -  سيُحمل ويُنفذ الثنائي الموجود بنجاح بدون إعادة تصريف ولن بتغير سلوك وقت التنفيذ
* '''متوافق مع المصدر''' - سيتم تصريف الشيفرة المصدرية بشكل ناجح بدون تغييرات عند تحديث جودو

=== النواة ===
{| class="wikitable"
|التغيير
|التوافق مع GDScript
|التوافق مع C#‎‎ ثنائي
|التوافق مع C#‎‎ المصدري
|تم تقديمه
|-
|'''Basis'''
|
|
|
|
|-
|أصبح لدى التابع <code>looking_at</code> معامل اختياري جديد <code>use_model_front</code>
|✔️
|✔️
|✔️
|[https://github.com/godotengine/godot/pull/76082 GH-76082]
|-
|'''Object'''
|
|
|
|
|-
|تغير نوع الإعادة للتابع <code>get_meta_list</code> من <code>PackedStringArray</code> إلى <code>Array[StringName‎]‎‏‎</code>
|✔️
|❌
|❌
|[https://github.com/godotengine/godot/pull/76418 GH-76418]
|-
|'''Transform3D'''
|
|
|
|
|-
|أصبح لدى التابع <code>looking_at</code> معامل اختياري جديد <code>use_model_front</code>
|✔️
|✔️
|✔️
|[https://github.com/godotengine/godot/pull/76082 GH-76082]
|-
|'''UndoRedo'''
|
|
|
|
|-
|أصبح لدى التابع <code>create_action</code> معامل اختياري جديد <code>backward_undo_ops</code>
|✔️
|✔️
|✔️
|[https://github.com/godotengine/godot/pull/76688 GH-76688]
|-
|'''WorkerThreadPool'''
|
|
|
|
|-
|تغير نوع الإعادة للتابع <code>wait_for_task_completion</code> من <code>void</code> إلى <code>Error</code>
|✔️
|❌
|✔️
|[https://github.com/godotengine/godot/pull/77143 GH-77143]
|}

=== التحريك ===
{| class="wikitable"
|التغيير
|التوافق مع GDScript
|التوافق مع C#‎ ثنائي
|التوافق مع C#‎ المصدري
|تم تقديمه
|-
|'''AnimationNode'''
|
|
|
|
|-
|أصبح لدى التابع ‎<code>_process</code> معامل جديد <code>test_only</code>
|❌
|❌
|❌
|[https://github.com/godotengine/godot/pull/75759 GH-75759]
|-
|أصبح لدى التابع <code>blend_input</code> معامل اختياري جديد <code>test_only</code>
|✔️
|✔️
|✔️
|[https://github.com/godotengine/godot/pull/75759 GH-75759]
|-
|أصبح لدى التابع <code>blend_node</code> معامل اختياري جديد <code>test_only</code>
|✔️
|✔️
|✔️
|[https://github.com/godotengine/godot/pull/75759 GH-75759]
|-
|'''AnimationNodeStateMachinePlayback'''
|
|
|
|
|-
|تغير نوع الإعادة للتابع <code>get_travel_path</code> من <code>PackedStringArray</code> إلى <code>Array[StringName‎]‎</code>‏‎
|✔️
|❌
|❌
|[https://github.com/godotengine/godot/pull/76418 GH-76418]
|}

=== العقد ثنائية البعد ===
{| class="wikitable"
|التغيير
|التوافق مع GDScript
|التوافق مع C#‎ ثنائي
|التوافق مع C#‎ المصدري
|تم تقديمه
|-
|'''PathFollow2D'''
|
|
|
|
|-
|تم إزالة الخاصية <code>lookahead</code>
|❌
|❌
|❌
|[https://github.com/godotengine/godot/pull/72842 GH-72842]
|}

=== العقد ثلاثية الأبعاد ===
{| class="wikitable"
|التغيير
|التوافق مع GDScript
|التوافق مع C#‎ ثنائي
|التوافق مع C#‎ المصدري
|تم تقديمه
|-
|'''Geometry3D'''
|
|
|
|
|-
|يغير المعامل <code>segment_intersects_convex</code> نوع المعامل <code>planes</code> من <code>Array</code> غير مكتوبة إلى <code>Array[plane]</code>‎
|✔️
|✔️
|❌
|[https://github.com/godotengine/godot/pull/76418 GH-76418]
|-
|'''MeshInstance3D'''
|
|
|
|
|-
|أصبح لدى التابع <code>create_multiple_conves_collisions</code> معامل اختياري جديد <code>settings</code>
|✔️
|✔️
|✔️
|[https://github.com/godotengine/godot/pull/72152 GH-72152]
|-
|'''Node3D'''
|
|
|
|
|-
|أصبح لدى التابع <code>look_at</code> معامل اختياري جديد <code>use_model_front</code>
|✔️
|✔️
|✔️
|[https://github.com/godotengine/godot/pull/76082 GH-76082]
|-
|أصبح لدى التابع <code>look_at_from_position</code> معامل اختياري جديد <code>use_model_front</code>
|✔️
|✔️
|✔️
|[https://github.com/godotengine/godot/pull/76082 GH-76082]
|}

=== عقد الواجهة الرسومية ===
{| class="wikitable"
|التغيير
|التوافق مع GDScript
|التوافق مع C#‎ ثنائي
|التوافق مع C#‎ المصدري
|تم تقديمه
|-
|'''CodeEdit'''
|
|
|
|
|-
|أصبح لدى التابع <code>add_code_completion_option</code> معامل اختياري جديد <code>location</code>
|✔️
|✔️
|✔️
|[https://github.com/godotengine/godot/pull/75746 GH-75746]
|-
|'''RichTextLabel'''
|
|
|
|
|-
|أصبح لدى التابع <code>push_list</code> معامل اختياري جديد <code>bullet</code>
|✔️
|✔️
|✔️
|[https://github.com/godotengine/godot/pull/75017 GH-75017]
|-
|أصبح لدى التابع <code>push_paragraph</code> معامل اختياري جديد <code>justification_flags</code>
|✔️
|✔️
|✔️
|[https://github.com/godotengine/godot/pull/75250 GH-75250]
|-
|أصبح لدى التابع <code>push_paragraph</code> معامل اختياري جديد <code>tab_stops</code>
|✔️
|✔️
|✔️
|[https://github.com/godotengine/godot/pull/76401 GH-76401]
|-
|'''Tree'''
|
|
|
|
|-
|أصبح لدى التابع <code>edit_selected</code> معامل اختياري جديد <code>force_edit</code>
|✔️
|✔️
|✔️
|[https://github.com/godotengine/godot/pull/76794 GH-76794]
|}

=== الفيزياء ===
{| class="wikitable"
|التغيير
|التوافق مع GDScript
|التوافق مع C#‎ ثنائي
|التوافق مع C#‎ المصدري
|تم تقديمه
|-
|'''Area2D'''
|
|
|
|
|-
|تغير نوع الخاصية <code>priority</code> من <code>float</code> إلى <code>int</code>
|❌
|❌
|❌
|[https://github.com/godotengine/godot/pull/72749 GH-72749]
|-
|'''Area3D'''
|
|
|
|
|-
|تغير نوع الخاصية <code>priority</code> من <code>float</code> إلى <code>int</code>
|❌
|❌
|❌
|[https://github.com/godotengine/godot/pull/72749 GH-72749]
|-
|'''PhysicsDirectSpaceState2D'''
|
|
|
|
|-
|تغير نوع الإعادة للتابع <code>collide_shape</code> من <code>Array[PackedVector2Array]‎</code> إلى <code>Array[Vector2‎]‎‏‎</code>
|❌
|❌
|❌
|[https://github.com/godotengine/godot/pull/75260 GH-75260]
|-
|'''PhysicsDirectSpaceState3D'''
|
|
|
|
|-
|تغير نوع الإعادة للتابع <code>collide_shape</code> من <code>Array[PackedVector3Array]‎</code> إلى <code>Array[Vector3‎]‎‏‎</code>
|❌
|❌
|❌
|[https://github.com/godotengine/godot/pull/7526 GH-7526]
|}

=== التصيير ===
{| class="wikitable"
|التغيير
|التوافق مع GDScript
|التوافق مع C#‎ ثنائي
|التوافق مع C#‎ المصدري
|تم تقديمه
|-
|'''RDShaderFile'''
|
|
|
|
|-
|تغير نوع الإعادة للتابع <code>get_version_list</code> من <code>PackedStringArray</code> إلى <code>Array[StringName‎]‎</code>‏‎
|✔️
|❌
|❌
|[https://github.com/godotengine/godot/pull/76418 GH-76418]
|-
|'''RenderingDevice'''
|
|
|
|
|-
|يغير المعامل <code>draw_list_begin</code> نوع المعامل <code>storage_textures</code> من <code>Array</code> غير مكتوبة إلى <code>Array[RID]‎</code>
|✔️
|✔️
|❌
|[https://github.com/godotengine/godot/pull/76418 GH-76418]
|-
|'''RenderingServer'''
|
|
|
|
|-
|تغير نوع الإعادة للتابع <code>global_shader_parameter_get_list</code> من <code>PackedStringArray</code> إلى <code>Array[StringName‎]‎</code>‏‎
|✔️
|❌
|❌
|[https://github.com/godotengine/godot/pull/76418 GH-76418]
|-
|'''SurfaceTool'''
|
|
|
|
|-
|تغير المعامل <code>add_triangle_fan</code> نوع المعامل <code>tangents</code> من <code>Array</code> غير مكتوبة إلى <code>Array[Plane]‎</code>
|✔️
|✔️
|❌
|[https://github.com/godotengine/godot/pull/76418 GH-76418]
|}

=== الحركة ===
{| class="wikitable"
|التغيير
|التوافق مع GDScript
|التوافق مع C#‎ ثنائي
|التوافق مع C#‎ المصدري
|تم تقديمه
|-
|'''NavigationAgent2D'''
|
|
|
|
|-
|تم استبدال التابع <code>set_velocity</code> بالخاصية <code>velocity</code>
|✔️
|❌
|❌
|[https://github.com/godotengine/godot/pull/69988 GH-69988]
|-
|تم تقسيم الخاصية <code>time_horizon</code> إلى <code>time_horizon_agents</code> و<code>time_horizon_obstacles</code>
|❌
|❌
|❌
|[https://github.com/godotengine/godot/pull/69988 GH-69988]
|-
|'''NavigationAgent3D'''
|
|
|
|
|-
|تم إعادة تسمية الخاصية <code>agent_height_offset</code> إلى <code>path_height_offset</code>
|❌
|❌
|❌
|[https://github.com/godotengine/godot/pull/69988 GH-69988]
|-
|تم إزالة الخاصية <code>ignore_y</code>
|❌
|❌
|❌
|[https://github.com/godotengine/godot/pull/69988 GH-69988]
|-
|تم استبدال التابع <code>set_velocity</code> بالخاصية <code>velocity</code>
|✔️
|❌
|❌
|[https://github.com/godotengine/godot/pull/69988 GH-69988]
|-
|تم تقسيم الخاصية <code>time_horizon</code> إلى <code>time_horizon_agents</code> و<code>time_horizon_obstacles</code>
|❌
|❌
|❌
|[https://github.com/godotengine/godot/pull/69988 GH-69988]
|-
|'''NavigationObstacle2D'''
|
|
|
|
|-
|تم إزالة الخاصية <code>estimate_radius</code>
|❌
|❌
|❌
|[https://github.com/godotengine/godot/pull/69988 GH-69988]
|-
|تم إعادة تسمية الخاصية <code>get_rid</code> إلى <code>get_agent_rid</code>
|❌
|❌
|❌
|[https://github.com/godotengine/godot/pull/69988 GH-69988]
|-
|'''NavigationObstacle3D'''
|
|
|
|
|-
|تم إزالة الخاصية <code>estimate_radius</code>
|❌
|❌
|❌
|[https://github.com/godotengine/godot/pull/69988 GH-69988]
|-
|تم إعادة تسمية الخاصية <code>get_rid</code> إلى <code>get_agent_rid</code>
|❌
|❌
|❌
|[https://github.com/godotengine/godot/pull/69988 GH-69988]
|-
|'''NavigationServer2D'''
|
|
|
|
|-
|تم إعادة تسمية الخاصية <code>agent_set_callback</code> إلى <code>agent_set_avoidance_callback</code>
|❌
|❌
|❌
|[https://github.com/godotengine/godot/pull/69988 GH-69988]
|-
|تم إزالة التابع <code>agent_set_target_velocity</code>
|❌
|❌
|❌
|[https://github.com/godotengine/godot/pull/69988 GH-69988]
|-
|تم تقسيم التابع <code>agent_set_time_horizon</code> إلى <code>agent_set_time_horizon_agents</code> و<code>agent_set_time_horizon_obstacles</code>
|❌
|❌
|❌
|[https://github.com/godotengine/godot/pull/69988 GH-69988]
|-
|'''NavigationServer3D'''
|
|
|
|
|-
|تم إعادة تسمية الخاصية <code>agent_set_callback</code> إلى <code>agent_set_avoidance_callback</code>
|❌
|❌
|❌
|[https://github.com/godotengine/godot/pull/69988 GH-69988]
|-
|تم إزالة التابع <code>agent_set_target_velocity</code>
|❌
|❌
|❌
|[https://github.com/godotengine/godot/pull/69988 GH-69988]
|-
|تم تقسيم التابع <code>agent_set_time_horizon</code> إلى <code>agent_set_time_horizon_agents</code> و<code>agent_set_time_horizon_obstacles</code>
|❌
|❌
|❌
|[https://github.com/godotengine/godot/pull/69988 GH-69988]
|}

=== الشبكة ===
{| class="wikitable"
|التغيير
|التوافق مع GDScript
|التوافق مع C#‎ ثنائي
|التوافق مع C#‎ المصدري
|تم تقديمه
|-
|'''WebRTCPeerConnectionExtension'''
|
|
|
|
|-
|تغير نوع الإعادة للتابع ‎<code>_‎create_data_channel</code> من <code>Object</code> إلى <code>WebRTCDataChannel</code>
|✔️
|❌
|✔️
|[https://github.com/godotengine/godot/pull/78237 GH-78237]
|}

=== ملحقات المعدل ===
{| class="wikitable"
|التغيير
|التوافق مع GDScript
|التوافق مع C#‎ ثنائي
|التوافق مع C#‎ المصدري
|تم تقديمه
|-
|'''AnimationTrackEditPlugin'''
|
|
|
|
|-
|تم إزالة النوع <code>AnimationTrackEditPlugin</code>
|❌
|❌
|❌
|[https://github.com/godotengine/godot/pull/76413 GH-76413]
|-
|'''EditorInterface'''
|
|
|
|
|-
|تم تغيير نوع الوراثة للنوع <code>EditorInterface</code> من <code>Node</code> إلى <code>Object</code>
|✔️
|❌
|❌
|[https://github.com/godotengine/godot/pull/76176 GH-76176]
|-
|تم استبدال التابع <code>set_movie_maker_enabled</code> بالخاصية <code>movie_maker_enables</code> 
|✔️
|❌
|❌
|[https://github.com/godotengine/godot/pull/76176 GH-76176]
|-
|تم استبدال التابع <code>is_movie_maker_enabled</code> بالخاصية <code>movie_maker_enables</code> 
|✔️
|❌
|❌
|[https://github.com/godotengine/godot/pull/76176 GH-76176]
|-
|'''EditorResourcePreviewGenerator'''
|
|
|
|
|-
|تم إضافة نوع <code>metadata</code> للتابع ‎<code>_genrate</code>
|❌
|❌
|❌
|[https://github.com/godotengine/godot/pull/64628 GH-64628]
|-
|تم إضافة نوع <code>metadata</code> للتابع ‎<code>_genrate_from_path</code>
|❌
|❌
|❌
|[https://github.com/godotengine/godot/pull/64628 GH-64628]
|-
|'''EditorUndoRedoManager'''
|
|
|
|
|-
|أصبح لدى التابع <code>create_action</code> معامل اختياري جديد <code>backward_undo_ops</code>
|✔️
|✔️
|✔️
|[https://github.com/godotengine/godot/pull/76688 GH-76688]
|}

== تحديث GDExtention الخاص بك إلى 4.1 ==
لا يزال GDExtention في مرحلة بيتا. سيحصل مشاكل في التوافقية عند التحديث إلى إصدار صغير جديد من جودو حتى يتم اعتباره مستقر 

يجب علينا في جودو 4.1 لمعالجة بعض المشاكل الخطيرة كسر توافقية الثنائية بشكل كبير وتوافقية المصدر بشكل قليل

هذا يعني أن GDExtention المعمول به لجودو 4.0 سيحتاج لإعادة تصريف من أجل جودو 4.1 (باستخدام فرع <code>4.1</code> من godot-ccp) مع تغيير بسيط في الشيفرة المصدرية الخاصة به

تبدو دالة "entry_symbol" في جودو 4.0 كالتالي:<syntaxhighlight lang="py">
GDExtensionBool GDE_EXPORT example_library_init(const GDExtensionInterface *p_interface, const GDExtensionClassLibraryPtr p_library, GDExtensionInitialization *r_initialization) {
    godot::GDExtensionBinding::InitObject init_obj(p_interface, p_library, r_initialization);

    init_obj.register_initializer(initialize_example_module);
    init_obj.register_terminator(uninitialize_example_module);
    init_obj.set_minimum_library_initialization_level(MODULE_INITIALIZATION_LEVEL_SCENE);

    return init_obj.init();
}
</syntaxhighlight>ولكن في جودو 4.1 تبدو كالتالي<syntaxhighlight lang="py">
GDExtensionBool GDE_EXPORT example_library_init(GDExtensionInterfaceGetProcAddress p_get_proc_address, const GDExtensionClassLibraryPtr p_library, GDExtensionInitialization *r_initialization) {
    godot::GDExtensionBinding::InitObject init_obj(p_get_proc_address, p_library, r_initialization);

    init_obj.register_initializer(initialize_example_module);
    init_obj.register_terminator(uninitialize_example_module);
    init_obj.set_minimum_library_initialization_level(MODULE_INITIALIZATION_LEVEL_SCENE);

    return init_obj.init();
}
</syntaxhighlight>هناك فرقان بسيطان:

# تغير الوسيط الأول من <code>const GDExtensionInterface *p_interface</code> إلى <code>GDExtensionInterfaceGetProcAddress p_get_proc_address</code>
# يحصل الباني من أجل المتغير init_obj على <code>p_get_proc_address</code> كمعامل أول

ستحتاج لإضافة سطر <code>compability_minimum</code> إضافي إلى ملف <code>‎.gdextention</code> ليصبح كالتالي:<syntaxhighlight lang="py">
[configuration]

entry_symbol = "example_library_init"
compatibility_minimum = 4.1
</syntaxhighlight>هذا يُعلم جودو أنه قد تم تحديث GDExtention وهو آمن للتحميل في جودو4.1
== مصادر ==
* [https://docs.godotengine.org/en/stable/tutorials/migrating/upgrading_to_godot_4.1.html صفحة Upgrading to Godot 4.1 في توثيق جودو الرسمي.]
[[تصنيف:Godot|{{SUBPAGENAME}}]]
[[تصنيف:Godot Migrating|{{SUBPAGENAME}}]]
{{DEFAULTSORT:Godot/migrating/upgrading to godot 4.1}}