الفرق بين المراجعتين لصفحة: «Godot/best practices/version control systems»
Naser-dakhel (نقاش | مساهمات) طلا ملخص تعديل |
جميل-بيلوني (نقاش | مساهمات) طلا ملخص تعديل |
||
| سطر 3: | سطر 3: | ||
يهدف جودو ليكون متوافقًا مع أنظمة التحكم بالإصدار، وأن يُنتج ملفات مقروءة وقابلة للدمج قدر الإمكان. | يهدف جودو ليكون متوافقًا مع أنظمة التحكم بالإصدار، وأن يُنتج ملفات مقروءة وقابلة للدمج قدر الإمكان. | ||
إضافات التحكم بالإصدار | == إضافات التحكم بالإصدار == | ||
يدعم جودو استخدام أنظمة التحكم بالإصدار داخل المحرر، إلا أن ذلك يتطلب إضافة خاصة بنظام التحكم بالإصدار الذي تفضّله. | يدعم جودو استخدام أنظمة التحكم بالإصدار داخل المحرر، إلا أن ذلك يتطلب إضافة خاصة بنظام التحكم بالإصدار الذي تفضّله. | ||
إضافة جيت Git هي الإضافة الوحيدة المتوفرة حاليًا - يوليو 2023 - إلا أن مجتمع جودو قد يُنشئ إضافات لأنظمة تحكم بإصدار أخرى. | إضافة جيت Git هي الإضافة الوحيدة المتوفرة حاليًا - يوليو 2023 - إلا أن مجتمع جودو قد يُنشئ إضافات لأنظمة تحكم بإصدار أخرى. | ||
إضافة جيت الرسمية<blockquote>تحذير: لم تُحدَّث إضافة جيت لتعمل مع جودو إصدار 4.1 وما بعد (من يوليو 2023).</blockquote>استخدام جيت بداخل المحرر مدعوم باستخدام إضافة رسمية، ويمكنك إيجاد آخر إطلاق لها من [https://github.com/godotengine/godot-git-plugin/releases جيت هاب]. | === إضافة جيت الرسمية === | ||
<blockquote>'''تحذير''': لم تُحدَّث إضافة جيت لتعمل مع جودو إصدار 4.1 وما بعد (من يوليو 2023).</blockquote>استخدام جيت بداخل المحرر مدعوم باستخدام إضافة رسمية، ويمكنك إيجاد آخر إطلاق لها من [https://github.com/godotengine/godot-git-plugin/releases جيت هاب]. | |||
ويمكن إيجاد التوثيق المرتبط بكيفية استخدامها من [https://github.com/godotengine/godot-git-plugin/wiki موقعها]. | ويمكن إيجاد التوثيق المرتبط بكيفية استخدامها من [https://github.com/godotengine/godot-git-plugin/wiki موقعها]. | ||
== الملفات التي يجب استثناؤها من نظام التحكم بالإصدار == | == الملفات التي يجب استثناؤها من نظام التحكم بالإصدار == | ||
<blockquote>ملاحظة: سنذكر الملفات والمجلدات التي يجب تجاهلها من التحكم بالإصدار في جودو إصدار 4.1 وما بعد. | <blockquote>'''ملاحظة''': سنذكر الملفات والمجلدات التي يجب تجاهلها من التحكم بالإصدار في جودو إصدار 4.1 وما بعد. | ||
الملفات والمجلدات التي يجب أن تُتجاهل من قبل التحكم بالإصدار في جودو 3.x وجودو 4.0 مختلفة تمامًا، وهذا الأمر مهم بالنظر إلى أن جودو 3.x و4.0 قد يخزنان معلومات حساسة في <code>export_presets.cfg</code> (على خلاف جودو 4.1). | الملفات والمجلدات التي يجب أن تُتجاهل من قبل التحكم بالإصدار في جودو 3.x وجودو 4.0 مختلفة تمامًا، وهذا الأمر مهم بالنظر إلى أن جودو 3.x و4.0 قد يخزنان معلومات حساسة في <code>export_presets.cfg</code> (على خلاف جودو 4.1). | ||
تفقّد الإصدار 3.5 من التوثيق إذا كنت تستخدم جودو 3.</blockquote>هناك بعض الملفات والمجلدات الي تُنشئها جودو تلقائيًا عند إنشاء مشروع جديد في المحرر للمرة الأولى، ولتجنّب حشو مستودع التحكم بالإصدار ببيانات مولّدة، يجب عليك إضافتها إلى ملف التجاهل الخاص بنظام التحكم بالإصدار: | تفقّد الإصدار 3.5 من التوثيق الرسمي إذا كنت تستخدم جودو 3.</blockquote>هناك بعض الملفات والمجلدات الي تُنشئها جودو تلقائيًا عند إنشاء مشروع جديد في المحرر للمرة الأولى، ولتجنّب حشو مستودع التحكم بالإصدار ببيانات مولّدة، يجب عليك إضافتها إلى ملف التجاهل الخاص بنظام التحكم بالإصدار: | ||
* مجلد <code>.godot/</code>: يخزّن هذا المجلد بيانات مخزنة مؤقتًا متعلقة بالمشروع | * مجلد <code>.godot/</code>: يخزّن هذا المجلد بيانات مخزنة مؤقتًا متعلقة بالمشروع | ||
| سطر 25: | سطر 25: | ||
يمكنك جعل مدير مشروع جودو يولّد بيانات وصفية للتحكم بالإصدار بشكل تلقائي عند إنشاء ملف، وذلك عند تحديد خيار Git، مما يُنشئ ملفَي <code>.gitignore</code> و<code>.gitattributes</code> في جذر المشروع: | يمكنك جعل مدير مشروع جودو يولّد بيانات وصفية للتحكم بالإصدار بشكل تلقائي عند إنشاء ملف، وذلك عند تحديد خيار Git، مما يُنشئ ملفَي <code>.gitignore</code> و<code>.gitattributes</code> في جذر المشروع: | ||
[[ملف:git-godot-dialog.png|مركز|تصغير|إنشاء بيانات وصفية لنظام التحكم بالإصدار في نافذة مدير المشروع ضمن مشروع جديد]] | [[ملف:git-godot-dialog.png|مركز|تصغير|إنشاء بيانات وصفية لنظام التحكم بالإصدار في نافذة مدير المشروع ضمن مشروع جديد]] | ||
إذا أردت توليد البيانات وصفية لمشروع موجود مسبقًا، فيمكنك النقر على قائمة "المشروع" أعلى المحرر ومن ثم الذهاب إلى | إذا أردت توليد البيانات وصفية لمشروع موجود مسبقًا، فيمكنك النقر على قائمة "المشروع" أعلى المحرر ومن ثم الذهاب إلى '''إدارة الإصدارات Version Control''' > '''توليد بيانات وصفية للتحكم بالإصدار Create version control metadata'''. يُنشئ ذلك الملفات ذاتها التي ستُنشئ إذا ما اخترت الخيار السابق بداية المشروع. | ||
== العمل مع جيت على ويندوز == | == العمل مع جيت على ويندوز == | ||
المراجعة الحالية بتاريخ 12:04، 28 أكتوبر 2023
يهدف جودو ليكون متوافقًا مع أنظمة التحكم بالإصدار، وأن يُنتج ملفات مقروءة وقابلة للدمج قدر الإمكان.
إضافات التحكم بالإصدار
يدعم جودو استخدام أنظمة التحكم بالإصدار داخل المحرر، إلا أن ذلك يتطلب إضافة خاصة بنظام التحكم بالإصدار الذي تفضّله.
إضافة جيت Git هي الإضافة الوحيدة المتوفرة حاليًا - يوليو 2023 - إلا أن مجتمع جودو قد يُنشئ إضافات لأنظمة تحكم بإصدار أخرى.
إضافة جيت الرسمية
تحذير: لم تُحدَّث إضافة جيت لتعمل مع جودو إصدار 4.1 وما بعد (من يوليو 2023).
استخدام جيت بداخل المحرر مدعوم باستخدام إضافة رسمية، ويمكنك إيجاد آخر إطلاق لها من جيت هاب.
ويمكن إيجاد التوثيق المرتبط بكيفية استخدامها من موقعها.
الملفات التي يجب استثناؤها من نظام التحكم بالإصدار
ملاحظة: سنذكر الملفات والمجلدات التي يجب تجاهلها من التحكم بالإصدار في جودو إصدار 4.1 وما بعد.
الملفات والمجلدات التي يجب أن تُتجاهل من قبل التحكم بالإصدار في جودو 3.x وجودو 4.0 مختلفة تمامًا، وهذا الأمر مهم بالنظر إلى أن جودو 3.x و4.0 قد يخزنان معلومات حساسة في
export_presets.cfg(على خلاف جودو 4.1).تفقّد الإصدار 3.5 من التوثيق الرسمي إذا كنت تستخدم جودو 3.
هناك بعض الملفات والمجلدات الي تُنشئها جودو تلقائيًا عند إنشاء مشروع جديد في المحرر للمرة الأولى، ولتجنّب حشو مستودع التحكم بالإصدار ببيانات مولّدة، يجب عليك إضافتها إلى ملف التجاهل الخاص بنظام التحكم بالإصدار:
- مجلد
.godot/: يخزّن هذا المجلد بيانات مخزنة مؤقتًا متعلقة بالمشروع - ملفات
*.translation: هذه الملفات هي ملفات ثنائية للترجمة مولّدة من ملفات CSV
يمكنك جعل مدير مشروع جودو يولّد بيانات وصفية للتحكم بالإصدار بشكل تلقائي عند إنشاء ملف، وذلك عند تحديد خيار Git، مما يُنشئ ملفَي .gitignore و.gitattributes في جذر المشروع:
إذا أردت توليد البيانات وصفية لمشروع موجود مسبقًا، فيمكنك النقر على قائمة "المشروع" أعلى المحرر ومن ثم الذهاب إلى إدارة الإصدارات Version Control > توليد بيانات وصفية للتحكم بالإصدار Create version control metadata. يُنشئ ذلك الملفات ذاتها التي ستُنشئ إذا ما اخترت الخيار السابق بداية المشروع.
العمل مع جيت على ويندوز
معظم إصدارات جيت في ويندوز مضبوطة بحيث تكون قيمة core.autocrlf تساوي إلى true، مما يؤدي إلى تصنيف الملفات بكونها معدّل عليها دون حاجة، بتحويل نهاية سطرها من LF إلى CRLF تلقائيًا.
من الأفضل ضبط الخيار السابق إلى ما يلي:
git config --global core.autocrlf input
إنشاء بيانات وصفية للتحكم بالإصدار باستخدام مدير المشروع أو المحرر سيجبر نهايات لسطر LF تلقائيًا باستخدام ملف .gitattributes، وفي هذه الحالة ليس عليك تغيير ضبط جيت الخاص بك.