عرض مصدر Godot/best practices/version control systems

<noinclude>{{DISPLAYTITLE:أنظمة التحكم بالإصدار في جودو}}</noinclude>

يهدف جودو ليكون متوافقًا مع أنظمة التحكم بالإصدار، وأن يُنتج ملفات مقروءة وقابلة للدمج قدر الإمكان.

== إضافات التحكم بالإصدار ==
يدعم جودو استخدام أنظمة التحكم بالإصدار داخل المحرر، إلا أن ذلك يتطلب إضافة خاصة بنظام التحكم بالإصدار الذي تفضّله.

إضافة جيت Git هي الإضافة الوحيدة المتوفرة حاليًا - يوليو 2023 - إلا أن مجتمع جودو قد يُنشئ إضافات لأنظمة تحكم بإصدار أخرى.

=== إضافة جيت الرسمية ===
<blockquote>'''تحذير''': لم تُحدَّث إضافة جيت لتعمل مع جودو إصدار 4.1 وما بعد (من يوليو 2023).</blockquote>استخدام جيت بداخل المحرر مدعوم باستخدام إضافة رسمية، ويمكنك إيجاد آخر إطلاق لها من [https://github.com/godotengine/godot-git-plugin/releases جيت هاب].

ويمكن إيجاد التوثيق المرتبط بكيفية استخدامها من [https://github.com/godotengine/godot-git-plugin/wiki موقعها].

== الملفات التي يجب استثناؤها من نظام التحكم بالإصدار ==
<blockquote>'''ملاحظة''': سنذكر الملفات والمجلدات التي يجب تجاهلها من التحكم بالإصدار في جودو إصدار 4.1 وما بعد.

الملفات والمجلدات التي يجب أن تُتجاهل من قبل التحكم بالإصدار في جودو ‎3.x وجودو 4.0 مختلفة تمامًا، وهذا الأمر مهم بالنظر إلى أن جودو ‎3.x‎ و4.0 قد يخزنان معلومات حساسة في <code>export_presets.cfg</code> (على خلاف جودو 4.1).

تفقّد الإصدار 3.5 من التوثيق الرسمي إذا كنت تستخدم جودو 3.</blockquote>هناك بعض الملفات والمجلدات الي تُنشئها جودو تلقائيًا عند إنشاء مشروع جديد في المحرر للمرة الأولى، ولتجنّب حشو مستودع التحكم بالإصدار ببيانات مولّدة، يجب عليك إضافتها إلى ملف التجاهل الخاص بنظام التحكم بالإصدار:

* مجلد <code>‎.godot/‎</code>: يخزّن هذا المجلد بيانات مخزنة مؤقتًا متعلقة بالمشروع
* ملفات ‎<code>*.translation</code>: هذه الملفات هي ملفات ثنائية [[Godot/i18n/internationalizing games|للترجمة]] مولّدة من ملفات CSV

يمكنك جعل مدير مشروع جودو يولّد بيانات وصفية للتحكم بالإصدار بشكل تلقائي عند إنشاء ملف، وذلك عند تحديد خيار Git، مما يُنشئ ملفَي <code>‎.gitignore</code> و<code>‎.gitattributes</code> في جذر المشروع:
[[ملف:git-godot-dialog.png|مركز|تصغير|إنشاء بيانات وصفية لنظام التحكم بالإصدار في نافذة مدير المشروع ضمن مشروع جديد]]
إذا أردت توليد البيانات وصفية لمشروع موجود مسبقًا، فيمكنك النقر على قائمة "المشروع" أعلى المحرر ومن ثم الذهاب إلى '''إدارة الإصدارات Version Control''' > '''توليد بيانات وصفية للتحكم بالإصدار Create version control metadata'''. يُنشئ ذلك الملفات ذاتها التي ستُنشئ إذا ما اخترت الخيار السابق بداية المشروع.

== العمل مع جيت على ويندوز ==
معظم إصدارات جيت في ويندوز مضبوطة بحيث تكون قيمة <code>core.autocrlf</code> تساوي إلى <code>true</code>، مما يؤدي إلى تصنيف الملفات بكونها معدّل عليها دون حاجة، بتحويل نهاية سطرها من LF إلى CRLF تلقائيًا.

من الأفضل ضبط الخيار السابق إلى ما يلي:<syntaxhighlight lang="bash">
git config --global core.autocrlf input
</syntaxhighlight>إنشاء بيانات وصفية للتحكم بالإصدار باستخدام مدير المشروع أو المحرر سيجبر نهايات لسطر LF تلقائيًا باستخدام ملف <code>‎.gitattributes</code>، وفي هذه الحالة ليس عليك تغيير ضبط جيت الخاص بك.
== مصادر ==
* [https://docs.godotengine.org/en/stable/tutorials/best_practices/version_control_systems.html صفحة Version Control Systems في توثيق جودو الرسمي.]
[[تصنيف:Godot|{{SUBPAGENAME}}]]
[[تصنيف:Godot Best Practices|{{SUBPAGENAME}}]]