تخصيص عنصر المجموعة SolutionToBuild

بنية Team Foundation ملف المشروع ، يمكن تخصيص TFSBuild.proj بتمرير الخصائص والأهداف إلى البنية في SolutionToBuild عنصر المجموعة. يمكنك أيضاً إضافة أو إزالة حلول البناء في SolutionToBuild عنصر المجموعة. للحصول على مزيد من المعلومات حول ملف TFSBuld.proj ، راجع فهم ملفات تكوين البناء الخاصة بـ Team Foundation.

الأذونات المطلوبة.

لإكمال هذه الإجراءات, يجب أن يكون لديك أذونات إيداعو سحب معينة إلي السماح.

تحريرملف بنية المشروع Team Foundation

قبل أن تتمكن من تحرير الملف TFSBuild.proj تحتاج لسحبه من عنصر التحكم بالمصادر.

لتحرير الملف TFSBuild.proj

  1. على قائمة عرض انقر فوق نوافذ أخرىثم انقر فوق مستكشف التحكم بالمصادر.

  2. في "مستكشف التحكم مصدر" قم بتوسيع مشروع الفريق الخاص بك في جزء المجلدات وحدد TeamBuildTypes.

  3. للحصول على أحدث إصدار من TFSBuild.proj ، انقر علي اليمين فوق المجلد TeamBuildType ثم انقر فوق الحصول على أحدث إصدار .

    هذا الإجراء يجعل الملفات متوفرة لتسحب للتحرير.

  4. في جزء "عرض" ، انقر نقراً مزدوجاً فوق اسم تعريف البنية التي تريدها تعديلها ،انقر علي اليمين فوق TFSBuild.proj ثم انقر فوق السحب للتحرير . في مربع الحوار سحب حدد بلا - السماح للسحب المشترك ، ثم أنقر سحب .

    تظهر علامة اختيار حمراء بجانب الملف TFSBuild.proj وتشير إلى حالة عنصر التحكم بالمصادر الخاصة به.

  5. أنقر نقرا مزدوجا فوق الملف TFSBuild.proj لفتحه في Visual Studio محرر الـXML

تمرير الخصائص في عنصر مجموعة SolutionToBuild

بنية Team Foundation يتضمن خاصيتين محجوزتين يمكن استخدامهم لتخصيص تعريفات البنية:

  • CustomPropertiesForClean بتمرير قيم مخصصة إلى كل حل عندبنية Team Foundation إستدعاءClean الهدف.

  • CustomPropertiesForBuild بتمرير قيم مخصصة في كل حل عندبنية Team Foundation إستدعاء الهدف الافتراضي (عادة Build).

لتمرير خصائص في عنصر مجموعة SolutionToBuild

  1. حدد موقع العلامة <SolutionToBuild> في الملف TFSBuild.proj.

  2. لإضافة خاصية مخصص لهدف إفتراضي اكتب التالي بين العلامات <SolutionToBuild> و </SolutionToBuild>. فعلى سبيل المثال:

    <SolutionToBuild Include="$(SolutionRoot)\HelloWorld.sln">
      <CustomPropertiesForBuild>
        Context=TeamBuild;RootDirectory=$(SolutionDir)
      </CustomPropertiesForBuild>
    </SolutionToBuild>
    

    يجعل هذا الـXML خصائص البنية تشير إلي RootDirectory الخاصية الافتراضية SolutionDir .

    استخدم نفس بناء الجملة لتمرير خصائص مخصصة في CustomPropertiesForClean الخاصية.

  3. (اختياري) يمكنك تمرير خصائص مخصصة إلى SolutionToBuild عناصر فردية بتحديدها في بيانات التعريف.

    فعلى سبيل المثال:

    <SolutionToBuild Include="$(SolutionRoot)\HelloWorld.sln">
      <Properties>
        OutDir=$(BinariesRoot)\$(Solution)\$(Platform)\$(Configuration)
      </Properties>
    </SolutionToBuild>
    

    يعيّن هذا XML دليل الإخراج لتعريف البنية أو التعريفات المرتبطة بهذا الملف TFSBuild.proj.

    ملاحظة

    إضافة العلاماتCustomPropertiesForBuild و CustomPropertiesForClean يؤدي إلي التحقق من صحة التحذيرات في المخطط XML Visual Studio. يمكنك بشكل آمن تجاهل هذه التحذيرات.

إضافة حلول وحذفها من عنصر مجموعة SolutionToBuild.

يمكنك تحرير SolutionToBuild عنصر المجموعة لإضافة أو إزالة الحلول التي سوف يتم إنشاؤها بواسطة تعريف البنية أو تعريفات المرتبطة بنية Team Foundation بملف المشروع ، TFSBuild.proj.

لإضافة أو إزالة حلول للبناء.

  1. حدد موقع العلامة <SolutionToBuild> في الملف TFSBuild.proj.

    إذا تم تعيين تعريف البنية إلي بناء حل واحد فقط SolutionToBuild فالإدخال سوف يكون مشابه للـXML التالي:

    <ItemGroup>
    <SolutionToBuild Include="$(BuildProjectFolderPath)\path\MySolution.sln" />
      <Targets></Targets>
      <Properties></Properties>
    </SolutionToBuild>
    </ItemGroup>
    
  2. لإضافة حل آخر أدخل مجموعة أخرى من <SolutionToBuild></SolutionToBuild> العلامات بعد الفتح <ItemGroup> وقبل علامات الإغلاق </ItemGroup> .

    <SolutionToBuild Include="$(BuildProjectFolderPath)\path\MySolution.sln" />
      <Targets></Targets>
      <Properties></Properties>
    </SolutionToBuild>
    <SolutionToBuild Include="$(BuildProjectFolderPath)\path\MySecondSolution.sln" />
      <Targets></Targets>
      <Properties></Properties>
    </SolutionToBuild>
    
  3. لإزالة حل قم بإزالة <SolutionToBuild></SolutionToBuild> العلامات و كل شيء بين علامات الحل فلم تعد ترغب في البنية.

استدعاء هدف مخصص في عنصر مجموعة SolutionToBuild

يمكنك استدعاء الأهداف المخصصة SolutionToBuild لعناصر فردية بتحديدها في بيانات التعريف.

لإستدعاء هدف مخصص في عنصر مجموعة SolutionToBuild

  1. حدد موقع العلامة <SolutionToBuild> في الملف TFSBuild.proj.

  2. استخدم بناء الجملة التالي لإستدعاء هدف و تمرير خصائص.

    <SolutionToBuild Include="$(BuildProjectFolderPath)\path\MySolution.sln">
      <Targets>MyCustomTarget1;MyCustomTarget2</Targets>
      <Properties>Property1=Value1;PropertyTwo=Value2</Properties>
    </SolutionToBuild>
    

    هذا الـXML يستدعي أهداف MyCustomTarget1 و MyCustomTarget2 ويمرر في الخصائص Property1 و Property2.

راجع أيضًا:

المهام

إنشاء تعريف بناء أساسي

موارد أخرى

أهداف البنيات ،مهام وخصائص Team Foundation