أمر التفريع (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

إصدار العنصر الذي تريد إنشاء التفرع له. يمكنك تحديد إصدار بواسطة:

  • تاريخ/وقت ( 20 D10 2005)

  • رقم مجموعه التغييرات ( C1256)

  • التسميه( Lmylabel)

  • أحدث إصدار ( T )

  • مساحة العمل (Wworkspacename)

إذا لم يتم توفير إصدار، يستخدم Team Foundation المنطق التالي ليقرر أي عنصر إصدار ينسخ للفرع الجديد:

  • إذا كان مسار الخادم التحكم بالإصدار Team Foundation يتم تحديده، فإن Team Foundation يقوم بتفريع العنصر في أحدث إصدار الخادم التحكم بالإصدار Team Foundation. على سبيل المثال، يستخدم tf branch $/projects/help.cs إصدار الخادم.

  • إذا تم تحديد مسار محلي للمصدر، يستخدم Team Foundation إصدار مساحة العمل المحلي لإنشاء فرع جديد. على سبيل المثال، يستخدم tf branch C:\314.cs إصدار مساحة العمل المحلي.

إذا قمت بتفريع ملف ذى مساحة عمل خاصة أقدم من أحدث إصدار في الخادم التحكم بالإصدار Team Foundation ، يتفرع الملف للإصدار الأقدم

/lock

يمنع المستخدمين الآخرين من إيداع أو سحب العناصر إلى أن تقوم بالإيداع في الفرع المعلّق الخاص بك و التغييرات المقترنة به. لمزيد من المعلومات، راجع فهم أنواع التأمين.

خيارات القفل

  • لا يوجد

    يكون هذا هو الإعداد الافتراضي. لم يتم تطبيق التأمين. إذا كان هناك قفل على الملف الذي تريد إنشاء فرع له، يزيله هذا الخيار.

  • الإيداع

    غير ذلك المستخدمين يمكنك يسحب عناصر المحددة ولكن لا تحقق في المراجعات لملفات مؤمن حتى يتم تحرير المؤمّن بواسطة القيام بإيداع. إذا قام أى من المستخدمين الآخرين بتأمين أي من العناصر المحددة, تفشل عملية تأمين.

  • السحب

    يمنع المستخدمين الآخرين من فحص ing في "أو" ing فحص سحب واحد عناصر المحددة حتى يتم تحرير التأمين بواسطة القيام فحص-في. إذا قام أى من المستخدمين الآخرين بتأمين أي من العناصر المحددة, تفشل عملية تأمين.

/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

راجع أيضًا:

المهام

كيفية: فرع المجلدات والملفات

المرجع

أمر فروع

دمج الأوامر

المبادئ

العمل مع Changesets

موارد أخرى

TF أداة سطر أوامر