أمر التفريع (Branch)
الأمر branch ينسخ عنصراً أو مجموعة من العناصر بما في ذلك بيانات التعريف و محفوظات التحكم بالإصدار من موقع للآخر فى الخادم التحكم بالإصدار Team Foundation و في مساحة العمل المحلية.
ملاحظة
نتائج هذا الأمر لا تنعكس في الخادم التحكم بالإصدار Team Foundation حتى تقوم بإجراء عملية الإيداع . لمزيد من المعلومات، راجع كيفية: إيداع التغييرات المعلقة.
الأذونات المطلوبة.
لاستخدام الأمر branch يجب أن يكون لديك إذن القراءة لعنصر المصدر و إذن السحب لمجلد الهدف معيّناً إلى السماح. لمزيد من المعلومات، راجع أذونات خادم أساس الفريق.
tf branch olditem newitem [/version:versionspec] [/noget] [/lock:none|checkin|checkout] [/noprompt]
المعلمات
الوسيطة |
الوصف |
---|---|
olditem |
تعين اسم ملف المصدر أو المجلد اللذين يتم تفريعهما. قد يحتوي olditem أيضاً على معلومات الإصدار بالتنسيق item;version. |
newitem |
تعين اسم ملف أو مجلد الوجهة أو مجلد الأصل الخاص بالوجهة. إذا كان newitem موجوداً بالفعل و هو مجلد خادم التحكم بالإصدار Team Foundation، يقوم Team Foundation بإنشاء العناصر المتفرعة بداخله. وإلا, فيقوم newitem بتعيين اسم ملف أو مجلد الوجهة. يمكن أن تحدث تعارضات أثناء الإيداع إذا كانت الوجهة موجودة بالفعل. |
versionspec |
توفر قيمة للخيار /version. للحصول على مزيد من المعلومات حول كيفية قيام Team Foundation بتحليل مواصفات الإصدار لتحديد أي من العناصر داخل النطاق الخاص به, راجع بناء جملة سطر الأوامر (التحكم بالإصدار). |
الخيار |
الوصف |
---|---|
/version |
إصدار العنصر الذي تريد إنشاء التفرع له. يمكنك تحديد إصدار بواسطة:
إذا لم يتم توفير إصدار، يستخدم Team Foundation المنطق التالي ليقرر أي عنصر إصدار ينسخ للفرع الجديد:
إذا قمت بتفريع ملف ذى مساحة عمل خاصة أقدم من أحدث إصدار في الخادم التحكم بالإصدار Team Foundation ، يتفرع الملف للإصدار الأقدم |
/lock |
يمنع المستخدمين الآخرين من إيداع أو سحب العناصر إلى أن تقوم بالإيداع في الفرع المعلّق الخاص بك و التغييرات المقترنة به. لمزيد من المعلومات، راجع فهم أنواع التأمين. خيارات القفل
|
/noget |
إذا تم تحديد هذا الخيار، لا يتم إنشاء نسخ محلية من الملفات و المجلدات التى فى الفرع الجديد في مساحة العمل المحلية. على الرغم من ذلك، سيتم استرداد النسخ المحلية إلى مساحة العمل في المرة التالية التي تقوم فيها بتنفيذ عملية Get متداخلة.
ملاحظة
يمكنك منع العناصر مثل محتويات مجلد /images من أن يتم استردادها إلى مساحة العمل الخاصة بك أثناء Get العودية و عمليات Get الحديثة بواسطة تغطية مجلد مساحة العمل.لمزيد من المعلومات، راجع أمر workfold.
|
/noprompt |
يمنع أي مطالبات إدخال منك. |
ملاحظات
إذا قمت بتحديد مسار محلي مثل c:\00101 ولكن لم تقم بتحديد versionspec، يستخدم Team Foundation إصدار مساحة العمل المحلي كأساس لإنشاء الفرع الجديد.
ومع ذلك، إذا قمت بتحديد مسار خادم مثل $/00101/*.cs و لم تقم بتحديد versionspec، يستخدم Team Foundation أحدث إصدار الخادم التحكم بالإصدار Team Foundation كأساس لإنشاء فرع جديد بدلاً من ذلك.
للحصول على مزيد من المعلومات حول كيفية العثور على أداة سطر الأوامر TF، راجع TF أداة سطر أوامر.
أمثلة
يقوم المثال التالي بإنشاء ملف فرع يحتوي على أحدث إصدار مساحة عمل لـ 314.cs، و يطلق عليه الاسم "314_branch" و يحفظه في الدليل الحالي على القرص وأيضاً على مجلد الخادم التحكم بالإصدار Team Foundation الذي تتعيّن إليه.
c:\projects>tf branch 314.cs 314_branch
المثال التالي ينسخ كافة الملفات بدون عمليات تحرير معلقة في إصدار مساحة العمل لـ 314. cs من مجلد الخادم الحالي التحكم بالإصدار Team Foundation إلى مجلد خادم اختبار البيانات(testdata) التحكم بالإصدار Team Foundation و من الدليل الحالي على القرص إلى مجلد العمل الذي يتعيّن إلى مجلد الخادم testdata التحكم بالإصدار Team Foundation.
c:\projects>tf branch C:\314.cs $/testdata
المثال التالي ينسخ كافة الملفات بدون عمليات التحرير المعلقة في إصدار مساحة العمل الحالي من مجلد testfiles و الملفات التي يحتوي عليها لكافة العناصر من مجلد الخادم الحالي التحكم بالإصدار Team Foundation إلى مجلد خادم testfiles_branch التحكم بالإصدار Team Foundation ومن c:\testfiles إلى المجلد المحلي الذي يعيّن لمجلد خادم testfiles_branch التحكم بالإصدار Team Foundation.
c:\projects>tf branch C:\testfiles $/testfiles_branch
يقوم المثال التالي بإنشاء فرع لـ 314. cs كما كان موجوداً في مجموعة التغييرات # 4 للملف. في مجلد العمل على القرص, كما في الخادم التحكم بالإصدار Team Foundation، يتم إنشاء ملف فرع يسمي csharp_branch.
c:\projects>tf branch C:\314.cs;C4 csharp_branch
يقوم المثال التالي بإنشاء فرع جديد من 314. cs كـ w كـ في 12/12/مارس. في مجلد العمل تشغيل dهوk كما في التحكم بالإصدار Team Foundationالملقم، 314_branch ملف المسمى فرع هو تاريخ الإنشاء.
c:\projects>tf branch 314.cs;D12/12/03 314_branch
المثال التالي يفرّع إصدار cs 314. الذي تم تطبيق التسمية "Beta1" عليه يسمي "Beta1branch" و يقوم بحفظه إلى الدليل الحالي على القرص بالإضافة إلى مجلد الخادم التحكم بالإصدار Team Foundation الذي يتم تعيين الدليل الحالي إليه.
c:\projects>tf branch 314.cs;LBeta1 314_Beta1branch