Přizpůsobení všech sestavení .NET

  • Článek

Techniky v tomto článku jsou užitečné, když chcete přizpůsobit všechna sestavení spuštěná na konkrétním počítači, virtuálním počítači nebo kontejneru. Když například nastavíte buildovací server, budete možná muset nakonfigurovat nastavení nástroje MSBuild globálně pro všechna sestavení na serveru. V zásadě můžete změnit globální soubory Microsoft.Common.Targets nebo Microsoft.Common.Props , ale existuje lepší způsob. Můžete ovlivnit všechna sestavení určitého typu projektu (například všechny projekty jazyka C#) pomocí určitých vlastností nástroje MSBuild a přidáním určitých vlastních .targets a .props souborů.

Před a po standardních souborech .props a .targets

Chcete-li ovlivnit všechny sestavení jazyka C# nebo Visual Basic, které se řídí instalací nástroje MSBuild nebo sady Visual Studio, vytvořte soubor Custom.Before.Microsoft.Common.Targets nebo Custom.After.Microsoft.Common.Targets s cíli, které budou spuštěny před nebo po microsoft.Common.targets, nebo soubor Custom.Before.Microsoft.Common.Props nebo Custom.After.Microsoft.Common.Props s vlastnostmi, které budou zpracovány před nebo po microsoft.Common.props.

Umístění těchto souborů můžete zadat pomocí následujících vlastností nástroje MSBuild:

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

Běžné verze těchto vlastností ovlivňují projekty jazyka C# i Visual Basic. Tyto vlastnosti můžete nastavit na příkazovém řádku NÁSTROJE MSBuild.

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

Upozorňující

Visual Studio používá vlastní .targets soubory nebo .props soubory, pokud je najde ve složce MSBuild pokaždé, když sestaví jakýkoli projekt odpovídajícího typu. To může mít nezamýšlené důsledky a v případě nesprávného provedení může zakázat možnost sady Visual Studio sestavovat na vašem počítači.

Nahrazení běžného souboru props

Vlastnosti můžete použít AlternateCommonProps také k zadání vlastního .props souboru, který se má použít místo Microsoft.Common.props. Pokud jste někdy cítili potřebu přizpůsobit Microsoft.Common.props úpravou přímo, můžete místo toho zkopírovat standardní verzi tohoto souboru do jiného souboru a pak provést změny pouze v alternativní verzi.

Nejlepší přístup závisí na vašem scénáři. Pomocí rozšíření sady Visual Studio můžete přizpůsobit systém sestavení a poskytnout mechanismus pro instalaci a správu přizpůsobení.

Pokud máte vyhrazený server sestavení a chcete zajistit, aby se určité cíle vždy spouštěly na všech sestaveních odpovídajícího typu projektu, který se na daném serveru spouští, pak použití globálního vlastního .targets souboru nebo .props souboru dává smysl. Pokud chcete, aby se vlastní cíle spouštěly pouze při použití určitých podmínek, použijte jiné umístění souboru a nastavte cestu k ho souboru nastavením příslušné vlastnosti MSBuild na příkazovém řádku MSBuild pouze v případě potřeby.

Související obsah