فهم ملفات تكوين البناء الخاصة بـ Team Foundation

يشرح هذا الموضوع ملفات التكوين التي يتم استخدامها بواسطة قالب الترقية. للحصول على مزيد من المعلومات حول قالب الترقية راجع تعريف بنية بإستخدام قالب الترقية. الميزات التي يتم استخدامها لإنتاج هذه الملفات مثل معالج إنشاء ملف مشروع MSBuild،تكون متوفرة فقط في Visual Studio Team System 2008.

عند معالجة بنية قالب الترقية ، بنية Team Foundation يستخدم المشغل MSBuild . يتم التحكم في العملية من قبل مجموعة من ملفات XML التي تتوافق مع مخطط ملف المشروع MSBuild . تعتبر العناصر التالية في ملفات الـ XML هذه هامة لعملية البناء:

• Target element   The Target element defines how the project هو built. Targetعناصر تحتوي على التعيين من المهام التيMSBuildيعمل بشكل متسلسل. لمزيد من المعلومات حول الأهداف راجع الأهداف ‏‫MSBuild.

• عناصر المهامالعنصر Task يعين التعليمات البرمجية التي يتم تشغيلها أثناء عملية البناء. للحصول على مزيد من المعلومات حول المهام ، راجع مهام ‏‫MSBuild .

  يتضمن MSBuild مجموعة من المهام الشائعة التي يمكنك استخدامها لتخصيص عملية البناء. لمزيد من المعلومات، راجع مرجع MSBuild المهام.

• عنصر UsingTask   العنصر UsingTask يحدد التجميع الذي يحتوي على المهام المستخدمة في عملية البناء.

ملفات البرامج النصية الخاصة بـMSBuild يمكن أن تستورد ملفات برامج نصية أخرى. على سبيل المثال، يمكنك تعريف تكوين شائعة في ملف واحد ثم تضمينه في التكوينات الأخرى. لمزيد من المعلومات، راجع كيفية القيام بما يلي: استخدم الهدف نفسه في ملفات مشروع متعددة.

الملفات الثلاثة تتحكم في عملية الـ بنية Team Foundation:

• Microsoft.TeamFoundation.Build.targets

  هذا الملف يُعرِف مجموعة المهام الإفتراضية والأهداف المضمنة مع بنية Team Foundation. على سبيل المثال، Clean, DropBuild و Compile. يحتوي كل هدف على المهام التي سوف يتم إستدعائها لذلك الهدف المعين. تعتمد بعض الأهداف في هذا الملف على أهداف أخرى لتكون سلسلة من الأهداف لتنفيذها بترتيب معين. على سبيل المثال، يعتمد الهدف Compile على الهدف BeforeCompile بحيث يتم تعريف أية مهام في الهدف BeforeCompile ليتم تنفيذها قبل Compile. ليست كافة الأهداف المعرفة في هذا الملف يتم تنفيذ بالضرورة في كل بناء. على سبيل المثال، بنيات سطح المكتب لا تقوم بتنفيذ الهدف Clean.

  يتم تضمين Microsoft.TeamFoundation.Build.targets في Visual Studio Application Lifecyle Management ويمكن العثور عليها في الدليل < الجذر >: \Program Files\MSBuild\Microsoft\VisualStudio\TeamBuild\. هناك نسخة واحدة فقط من هذا الملف على جهاز كمبيوتر وهو مشترك بين كافة البنيات التي تعمل على ذلك الكمبيوتر.

  هام

  لا تقم بتعديل Microsoft.TeamFoundation.بنية.targets. If thهو ملف هو modified, each build definition هو affected. لتخصيص تعريفات البناء يجب تعديل الملف TfsBuild.proj المقترن معها.

• TfsBuild.proj

  هذا هو ملف التكوين الأساسي لـ بنية Team Foundation. يمكن اقترانه مع تعريف بناء واحد فقط أو يمكن مشاركته بين تعريفات بناء متعددة. هذا الملف يقوم بتخزين معلمات التكوين التي توفرها في معالج إنشاء ملف المشروع MSBuild . يتضمن هذا مشروع الفريق ، نوع عنصر العمل الذي تم إنشاؤه على فاصل البناء، التكوين المستهدف بناؤه والحلول المستهدف بناؤها. معالج إنشاء ملف المشروع MSBuild يقوم بإنشاء هذا الملف عند إنشاء ملف مشروع لتعريف بناء جديد. لمزيد من المعلومات، راجع إنشاء تعريف بناء أساسي. هذا الملف يقوم باستيراد Microsoft.TeamFoundation.Build.targets و يتم تمريره لـMSBuild. أية تغييرات تجريها على هذا الملف تؤثر على البنيات الخاصة بكافة تعريفات البناء المقترنة به. هذا الملف يتم افتراضياً تخزينه في عنصر تحكم المصدر ضمن المجلد $ \ MyProject \TeamBuildTypes\ BuildDefinition فـ MyProject هو اسم مشروع الفريق و BuildDefinition هو اسم تعريف البناء. يمكنك أيضاً تخزين هذا الملف في موقع مختلف عن طريق تحديده في مربع الحوار تعريف البناء.

  الملف TfsBuild.proj يتضمن أمثلة الاستخدام في نص التعليق. تتضمن هذه الأمثلة كيفية استدعاء الأهداف المخصصة في العنصر SolutionToBuild وكيف يتم تمرير خصائص مخصصة لعناصر أخرى.

• TfsBuild.rsp

  هذا ملف فارغ تم إنشاؤها بواسطة معالج إنشاء ملف المشروع MSBuild . يمكن استخدام هذا الملف لتحديد مسجل مخصص أو لمنع خصائصMSBuild. لمزيد من المعلومات، راجع ملفات الاستجابة MSBuild.

الأهداف ،الخصائص والمهام

تصف المواضيع التالية الأهداف ، المهام والخصائص الافتراضية التي تم تعريفها في Microsoft.TeamFoundation.Build.targets.

• أهداف بنيات Team Foundationالقابلة للتخصيص
  يسرد الأهداف المعرفة في Microsoft.TeamFoundation.Build.targets والتي يمكنك منعها بكتابة المهام المخصصة. يتضمن هذا الموضوع الأمثلة التي توضح كيفية تخصيص عملية البناء.

• خصائص بنية Team Foundation قابلة للتخصيص
  تسرد الخصائص الافتراضية التي تم تعريفها في Microsoft.TeamFoundation.Build.targets والتي يمكنك منعها في الملف TfsBuild.proj. يتضمن هذا الموضوع أمثلة أيضاً.

• مهام بنية Team Foundation
  سرد المهام الافتراضية المعرفة في Microsoft.TeamFoundation.Build.targets والتي يمكنك تعديلها في الملف TfsBuild.proj لتخصيص تعريفات البناء. يتضمن هذا الموضوع أمثلة أيضاً.