git-flow cheatsheet

macOS

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 موفر.

git flow init

ستحتاج إلى الإجابة عن بعض الأسئلة المتعلقة بنظام تسمية فروعك.
من المستحسن استخدام القيم الافتراضية.

بدء ميزة جديدة

تبدأ عملية برمجة ميزات جديدة انطلاقا من فرع '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

إبدأ الإصدار

لكي تبدأ إصدارا استخدم أوامر الإصدار لـ 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

بدأ إصلاح

كمثل أوامر git flow الأخرى تبدأ إصلاح بالأمر:

git flow hotfix start VERSION [BASENAME]

يمثل المعامل VERSION اسم الإصلاح الجديد. اختياريا يمكنك تحديد basename أي إصدار يطبق الإصلاح.

إنهاء الإصلاح

عند الانتهاء من الإصلاح فإنه يتم دمجها نحو develop و master. بالإضافة إلى ذلك يتم تسمية دمج master بنسخة الإصلاح.

git flow hotfix finish VERSION