خصائص بنية Team Foundation قابلة للتخصيص
MSBuild الخصائص هي أزواج key–value يمكنك استخدامها لتكوين بنيات. لمزيد من المعلومات، راجع خصائص MSBuild.
ملف Microsoft.TeamFoundation.Build.targets يعريف عدة MSBuild أهداف ومهام وخصائص بنية Team Foundation. يمكنك تعديل هذه الخصائص في ملف TFSBuild.proj إلي:
تمرير القيم إلي بنية Team Foundation أهداف والمهام
منع إجراءات بنية معينة.
للحصول على مزيد من المعلومات حول ملف TFSBuld.proj ، راجع فهم ملفات تكوين البناء الخاصة بـ Team Foundation.
في هذا المستند
تخصيص بنيات ++Visual C
الخصائص المستخدمة لتخصيص المهام.
الخصائص التي يمكن تجاوزها
يسرد الجدول التالي الخصائص التي تم تعريفها لــ بنية Team Foundation. يمكنك تجاوزهم في ملف TfsBuild.proj لتخصيص عملية البناء. لمزيد من المعلومات، راجع تخصيص عنصر المجموعة SolutionToBuild.
الخصائص |
الوصف |
|---|---|
BinariesRoot |
تعيين هذه الخاصية للإشارة إلى جذر الثنائيات لمجلد على بنية الكمبيوتر . |
CleanCompilationOutputOnly |
تعيين هذه الخاصية إلى true لحذف التجميعات الوسيطة من الدليل المصدر أثناء CoreClean تنفيذ الهدف. إذا تم تعيين هذه الخاصية إلى false, الكل سيتم حذف الدليل المصدر أثناء CoreClean تنفيذ الهدف. |
CustomizableOutDir |
عيِن هذه الخاصية إلى true عندما تريد المنع بنية Team Foundation من تعيين OutDir لكل الحل. ملاحظة يمكنك استخدام خاصية TeamBuildPublishDir لاسترداد القيمة بنية Team Foundation التي تم تعيينها لـ PublishDir إذا تم تعيينCustomizablePublishDirإلي false. |
CustomizablePublishDir |
عيِن هذه الخاصية إلى true عندما تريد منع بنية Team Foundation من تعيين المجلد PublishDir لكل الحل. ملاحظة يمكنك استخدام خاصية TeamBuildPublishDir لاسترداد القيمة بنية Team Foundation التي تم تعيينها لـ PublishDir إذا تم تعيينCustomizablePublishDirإلي false. |
CustomPropertiesForBuild |
يتم تعيين هذه الخاصية لتمرر قيم مخصصة في كل حل عندما بنية Team Foundation يستدعي الهدف الافتراضي (عادة Build). |
CustomPropertiesForClean |
يتم تعيين هذه الخصائص لتمرير قيم مخصصة في كل حل عند بنية Team Foundation إستدعاء Clean الهدف. |
GetAllowUnmapped |
يتم تعيين هذه الخاصية إلى false يجعل البناء يفشل إذا وجد ملفات غير معينة في مجموعة التغييرات (للحصول على دخول وبنيات خاصة). |
GetAutoMerge |
يتم تعيين هذه الخاصية إلى false يفشل البناء إذا كانت هناك أية تعارضات أثناء التحكم بالإصدار للحصول على العملية في بوابة إيداع أو بنية خاصة. |
GetNoCIOption |
قم بتعيين هذه خاصية إلى falseلاستثناء الإدراج من *** NO_CI *** السلسلة في الاختيار-في التعليقات عند تشغيل بوابة إيداع بنية. يجب أن تكون على علم أن تعيين هذه هذه الخاصية إلى false سوف تسبب تأثر بنيات التكامل بشكل مستمر ليتم وضعها في قائمة الانتظار. |
IncrementalBuild |
تعيين هذه الخاصية إلى true لتنفيذ بنية تزايدية. هذه هي خاصية الملاءمة التي تعين SkipClean إلى true SkipInitializeWorkspace إلى true ، و ForceGet إلى false. |
IncrementalGet |
تعيين هذه الخاصية إلى true لتنفيذ ناتج تزايدي. هذه هي خاصية الملاءمة التي تعين CleanCompilationOutputOnly إلى true SkipInitializeWorkspace إلى true ، و ForceGet إلى false. |
LabelComment |
يتم تعيين هذه الخاصيه لتعريف التعليق المستخدم بواسطة Label. |
LabelName |
تعيين إسم التسمية لتعريف الإسم المستخدم بواسطة Label. افتراضياً، يتم تعيين اسم التسمية إلي $(BuildNumber) في InitializeEndToEndIteration الهدف. |
OutDir |
تعيين هذه الخاصية لتعريف موقع ملفات الإخراج في بنية دليل العمل. |
PerformTestImpactAnalysis |
يتم تعيين هذه الخاصية إلى false لتعطيل تحليل إختبار التأثير. |
PublishTestResults |
يتم تعيين هذه الخاصية إلى false لتخطي نشر نتائج الإختبارات. |
SkipClean |
يتم تعيين هذه الخاصية لتخطي الهدف CoreClean. |
SkipDropBuild |
يتم تعيين هذه الخاصية لتخطي الهدف CoreDropBuild. |
SkipGet |
يتم تعيين هذه الخاصية لتخطي الهدف CoreGet. |
SkipGetChangesetsAndUpdateWorkItems |
يتم تعيين هذه الخاصية إلى true لتخطي اقتران مجموعة التغييرات وتحديث عناصر العمل للبنيات الناجحة. |
SkipInitializeWorkspace |
يتم تعيين هذه الخاصية لتخطي الهدف CoreInitializeWorkspace. |
SkipInvalidConfigurations |
يتم تعيين هذه الخاصية إلى false لإنشاء خطأ بدلاً من تحذير عندما يصادف المستخدم تكوين غير صالح. |
SkipLabel |
يتم تعيين هذه الخاصية لتخطي الهدف CoreLabel. |
SkipPostBuild |
يتم تعيين هذه الخاصية لتخطي تجميع مجموعة التغييرات المقترنة وعناصر العمل. |
SkipWorkItemCreation |
يتم تعيين هذه الخاصية لتخطي الهدف CoreCreateWorkItem. |
SolutionRoot |
تعيين هذه الخاصية للإشارة إلى جذر مجلد المصادر على بنية الكمبيوتر . |
StopOnFirstFailure |
يتم تعيين هذه الخاصية إلى true لإيقاف تنظيف أو ترجمة أو اختبار عند الفشل الأول أثناء تنفيذ البنية. |
UpdateAssociatedWorkItemsOnBuildBreak |
يتم تعيين هذه الخاصية إلى true لتحديث عناصر العمل المقترنة حتى بالنسبة للبنيات المقطوعة. |
تخصيص بنيات ++Visual C
بنية Team Foundation يعتمد أيضاً تخصيص بناء Visual C++ مشاريع 9.0. يمكنك استخدام الخصائص التالية لتعيين الخصائص المقابلة على VCBuild المهام المستخدمة من قبل MSBuild لبناء Visual C++ المشاريع. لمزيد من المعلومات، راجع المهام VCBuild.
خاصية بنية الفريق |
VCBuild خاصية المهمة |
الوصف |
|---|---|---|
VCBuildAdditionalLibPaths |
AdditionalLibPaths |
يحدد مسارات إضافية للبحث عن مكتبات قبل أن يتم البحث في مسارات متغير بيئة LIB (يتوافق مع خيار LIBPATH لـLINK.exe). |
VCBuildAdditionalOptions |
AdditionalOptions |
تحدد خيارات إضافية لسطر الأوامر التي ليس لديها معلمات المهمة مخصصة . |
VCBuildToolPath |
ToolPath |
تحديد الموقع التي تحمل منه مهمة VCBuildالملف الأساسي القابل للتنفيذ (VCBuild.exe). |
VCBuildUseEnvironment |
UseEnvironment |
يتم تعيين هذه القيمة إلى true لإستخدام متغيرات البيئة PATH و INCLUDE و LIBS و LIBPATH. وإلا, تعيِنها إلي false. هذه الخاصية تتوافق مع /useenv خيار VCBuild.exe. لمزيد من المعلومات، راجع /useenv. |
AdditionalVCOverrides |
لا يوجد |
استخدم هذه الخاصية لتحديد خيارات إضافية لملفات ورقة المهام الخاصة بـ VCBuild التي تم إنشاؤها بواسطة بنية Team Foundation و المحددة في خاصية التجاوز الخاصة بمهمة VCBuild. |
الخصائص المستخدمة لتخصيص المهام.
كل مهمة إفتراضية بنية Team Foundation في الملف Microsoft.TeamFoundation.Build.targets تتضمن مجموعة من الخصائص التي يمكنك استخدامها لتخصيص المهمة. للحصول على مزيد من المعلومات حول بنية Team Foundation المهام، راجع مهام بنية Team Foundation. على سبيل المثال، CreateNewWorkItem المهمة تعرف كما يلي.
<!-- Create WorkItem for build failure -->
<CreateNewWorkItem
TeamFoundationServerUrl="$(TeamFoundationServerUrl)"
BuildUri="$(BuildUri)"
BuildNumber="$(BuildNumber)"
Description="$(WorkItemDescription)"
TeamProject="$(TeamProject)"
Title="$(WorkItemTitle)"
WorkItemFieldValues="$(WorkItemFieldValues)"
WorkItemType="$(WorkItemType)"
ContinueOnError="true" />
لتخصيص عنصر العمل المنشأ على فشل البنية قم بتعيين WorkItemFieldValues في ملف TFSBuild.proj:
ملاحظة
يفترض التالي أن الخصائصAreapath و IterationPath قد تم تعيينها أيضاً.
<WorkItemFieldValues>Area Path=$(AreaPath);Iteration Path=$(IterationPath);Severity=1;Priority=0;Symptom=build break;Steps To Reproduce=Start the build using Team Build;Source=Development;How Found=Build Break;Assigned To=Active</WorkItemFieldValues>
راجع أيضًا:
المهام
كيفية القيام بما يلي: استخدام متغيرات بيئة في بنية