Delen via

Alle .NET-builds aanpassen

De technieken in dit artikel zijn handig als u alle builds wilt aanpassen die worden uitgevoerd op een specifieke computer, virtuele machine of container. Wanneer u bijvoorbeeld een buildserver instelt, moet u mogelijk de MSBuild-instellingen globaal configureren voor alle builds op de server. In principe kunt u de algemene bestanden Microsoft.Common.Targets of Microsoft.Common.Props wijzigen, maar er is een betere manier. U kunt van invloed zijn op alle builds van een bepaald projecttype (zoals alle C#-projecten) met behulp van bepaalde MSBuild-eigenschappen en het toevoegen van bepaalde aangepaste .targets bestanden..props

Voor en na standaard .props en .targets bestanden

Als u invloed wilt hebben op alle C# of Visual Basic-builds die worden beheerd door een installatie van MSBuild of Visual Studio, maakt u een bestand Custom.Before.Microsoft.Common.Targets of Custom.After.Microsoft.Common.Targets met doelen die vóór of na Microsoft.Common.targets worden uitgevoerd, of een bestand Custom.Before.Microsoft.Common.Props of Custom.After.Microsoft.Common.Props met eigenschappen die vóór of na Microsoft.Common.props worden verwerkt.

U kunt de locaties van deze bestanden opgeven met behulp van de volgende MSBuild-eigenschappen:

  • CustomBeforeMicrosoftCommonProps
  • CustomBeforeMicrosoftCommonTargets
  • CustomAfterMicrosoftCommonProps
  • CustomAfterMicrosoftCommonTargets
  • CustomBeforeMicrosoftCSharpTargets
  • CustomBeforeMicrosoftVisualBasicTargets
  • CustomAfterMicrosoftCSharpTargets
  • CustomAfterMicrosoftVisualBasicTargets

De algemene versies van deze eigenschappen zijn van invloed op zowel C# als Visual Basic-projecten. U kunt deze eigenschappen instellen in de MSBuild-opdrachtregel.

msbuild /p:CustomBeforeMicrosoftCommonTargets="C:\build\config\Custom.Before.Microsoft.Common.Targets" MyProject.csproj

Waarschuwing

Visual Studio gebruikt de aangepaste .targets bestanden of .props bestanden als deze worden gevonden in de map MSBuild wanneer er een project van het overeenkomende type wordt gemaakt. Deze aanpassing kan onbedoelde gevolgen hebben en, indien onjuist gedaan, kan de mogelijkheid van Visual Studio om te bouwen op uw computer uitschakelen.

Algemene props-bestand vervangen

U kunt ook de eigenschappen AlternateCommonProps gebruiken om uw eigen .props bestand op te geven dat moet worden gebruikt in plaats van Microsoft.Common.props. Als u ooit de noodzaak voelde om Microsoft.Common.props aan te passen door het rechtstreeks te wijzigen, kunt u in plaats daarvan de standaardversie van dat bestand naar een ander bestand kopiëren en vervolgens alleen uw wijzigingen aanbrengen in de alternatieve versie.

De beste benadering is afhankelijk van uw scenario. Met Visual Studio Extensibility kunt u het buildsysteem aanpassen en een mechanisme bieden voor het installeren en beheren van de aanpassingen.

Als u een toegewezen buildserver hebt en ervoor wilt zorgen dat bepaalde doelen altijd worden uitgevoerd op alle builds van het juiste projecttype dat op die server wordt uitgevoerd, is het zinvol om een globaal aangepast .targets bestand of .props bestand te gebruiken. Als u wilt dat de aangepaste doelen alleen worden uitgevoerd wanneer bepaalde voorwaarden van toepassing zijn, gebruikt u een andere bestandslocatie en stelt u het pad naar dat bestand in door de juiste MSBuild-eigenschap in te stellen in de MSBuild-opdrachtregel alleen wanneer dat nodig is.

Verwante inhoud

  • Last updated on