حول
+ ++ git-flow هي إضافات لـ git لتوفير عمليات متطورة على المستودع لنموذج الفروع لفانسين دريسنز. + للمزيد +
+★ ★ ★
+ +هذه المذكرة تشرح أساسيات استعمال عمليات git-flow وتأثيراتها.
+ +★ ★ ★
+نصائح أساسية
+-
+
- +أوامر ومخرجات الـ git-flow توفر تسهيلات مهمة جدا. إقرأها بعناية لكي تفهم ماذا يحدث... + +
- +يعتبر تطبيق الـ OSX/Windows سورستري + واجهة مستخدم ممتازة لـ git الذي يدعم git-flow. + +
- + Git-flow هي حل مبني على عمليات الدمج. التي لاتترك قاعدة على الفروع الوظيفية. + +
★ ★ ★
+التنصيب
+-
+
- + تحتاج إلى تنصيب git متوفر كشرط أساسي. + +
- Git flow يعمل في كل من OSX، الينوكس والويندوز. +
★ ★ ★
+OSX
+ Homebrew ++ $ brew install git-flow-avh ++ Macports +
+ $ port install git-flow-avh ++
اللينيكس
++ $ apt-get install git-flow ++
الويندوز (Cygwin)
++ $ wget -q -O - --no-check-certificate + https://raw.github.com/petervanderdoes/gitflow-avh/develop/contrib/gitflow-installer.sh install stable | bash ++
ستحتاج إلى wget و util-linux لكي تقوم بتنصيب git-flow.
++ لتفسير مفصل عن التنصيب زر موقع git flow wiki. +
+ +الشروع في العمل
++ Git flow .يحتاج للتهييء كي تخصص تنصيب مشروعك +
+★ ★ ★
+التهييء
+ ++ ابدأ باستعمال git-flow عن طريق التهييء داخل مستودع git موفر. +
++ git flow init ++
+ ستحتاج إى الإجابة عن بعض الأسئلة المتعلقة بنظام تسمية فروعك.
+ من المستحسن استخدام القيم الافتراضية.
+
+ ميزات Features +
+ +-
+
- + طور ميزات جديدة للإصدارات القادمة. + +
- + توجد عادة في مستودع المبرمجين فقط. + +
★ ★ ★
+ +بدء ميزة جديدة
++ تبدأ عملية برمجة ميزات جديدة انطلاقا من فرع 'develop'. +
++ إبدأ عملية برمجة ميزة جديدة بتنفيذ الأمر +
++ git flow feature start MYFEATURE ++
+ هذه العملية تصنع فرع ميزة جديد انطلاقا من فرع 'develop' وينتقل إليه. +
+ + +إتمام الميزة
+ ++ إتمام تطوير ميزة. هذه العملية تقوم بتنفيذ ما يلي: +
+-
+
- + دمج MYFEATURE نحو فرع 'develop' + +
- + تحذف فرع الميزة. + +
- + تحول إلى فرع 'develop' + +
+ git flow feature finish MYFEATURE ++
نشر ميزة
+ +
+ هل تقوم بتطوير ميزة بالتعاون مع مجموعة مبرمجين؟
+
+ أنشر الميزة إلى نطاق السيرفر لكي يستطيع بقية المبرمجين استخدامها.
+
+ git flow feature publish MYFEATURE ++
الحصول على ميزة منشورة
+ ++ الحصول على ميزة منشورة من طرف مستخدم آخر. +
+ ++ git flow feature pull origin MYFEATURE ++ +
يمكنك تتبع ميزة على الأصل باستخدام git flow feature track MYFEATURE
اصنع إصدارا Release
+ +-
+
- + دعم إعداد إنتاج اصدار جديد. + +
- + السماح باصلاحات أخطاء طفيفة وإعداد بيانات وصفية لإصدار. + +
★ ★ ★
+إبدأ الإصدار
+ ++ لكي تبدأ إصدارا استخدم أوامر الإصدار لـ git flow. أنشىء فرع إصدار إنطلاقا من فرع 'develop' + +
++ git flow release start RELEASE [BASE] ++
يمكنك اختياريا اضافة التوريد [BASE]
ايداع sha-1 hash كي تبدأ من خلالها الإصدار.
+ الإيداع يجب أن يكون في فرع 'develop'
+
★ ★ ★
++ من الأفضل نشر فرع الإصدار بعد إنشائه للسماح للمبرمجين بإيداع الإصدار. قم بنفس الشيء للميزات المنشورة باستخدام الأمر: +
++ git flow release publish RELEASE ++
يمكنك متابعة الاصدار على السرفر باستخدام git flow release track RELEASE
إتمام إصدار
+ ++ إتمام إصدار هي من أهم الخطوات في فروع git. +
+-
+
- + دمج فرع الإصدار نحو فرع 'master' + +
- + تسمية فرع الإصدار باسمه. + +
- + رجع دمج فرع الإصدار نحو فرع 'develop' + +
- + حذف فرع الإصدار + +
+ git flow release finish RELEASE ++
لا تنسى دفع مسمياتك بتنفيذgit push --tags
الإصلاحات Hotfixes
+ +-
+
- + تنشأ الإصلاحات من ضرورة العمل فورا على حالة غير مرغوب فيها من نسخة الانتاج الحية. + +
- + يمكن الاعتماد على تسمية فرع الإنتاج 'master' لإشارة على نسخة الإنتج الحية. + +
★ ★ ★
+بدأ إصلاح
+ +كمثل أوامر git flow الأخرى تبدأ إصلاح بالأمر:
++ git flow hotfix start VERSION [BASENAME] ++
+ يمثل المعامل VERSION اسم الإصلاح الجديد. اختياريا يمكنك تحديد basename أي إصدار يطبق الإصلاح. +
+إنهاء الإصلاح
+ ++ عند الانتهاء من الإصلاح فإنه يتم دمجها نحو develop و master. بالإضافة إلى ذلك يتم تسمية دمج master بنسخة الإصلاح. +
++ git flow hotfix finish VERSION ++
الأوامر
+ +الأعمال المعلقة
+★ ★ ★
+-
+
- ليست كل الأوامر مذكورة هنا، فقط الأساسية. +
- + يمكنك الاستمرار في استخدام git وجميع الأوامر بشكل طبيعي كما عاهدتهم، git flow ليست سوى مجموعة أدواة + +
- ميزة "دعم" لا تزال بيتا، لا ينصح باستخدامها. +
- إذا كنت تريد إضافة ترجمة لهذه الوثيقة، سوف أدرجها بكل سرور. +
★ ★ ★
+