Postupy: Přidání vlastních nástrojů sestavení do projektů MSBuild

Článek
10/12/2023

Vlastní nástroj sestavení je uživatelsky definovaný nástroj příkazového řádku, který je přidružený k určitému souboru.

Pro konkrétní soubor zadejte do souboru projektu (.vcxproj) příkazový řádek, který se má spustit, všechny ostatní vstupní nebo výstupní soubory a zprávu, která se má zobrazit. Pokud nástroj MSBuild zjistí, že vaše výstupní soubory jsou zastaralé vzhledem k vašim vstupním souborům, zobrazí zprávu a spustí nástroj příkazového řádku.

Určení vlastních nástrojů sestavení a vlastních kroků sestavení

Chcete-li určit, kdy se vlastní nástroj sestavení spustí, použijte jeden nebo oba CustomBuildBeforeTargets prvky XML CustomBuildAfterTargets v souboru projektu. Můžete například určit, že se váš vlastní nástroj sestavení spustí po kompilátoru MIDL a před kompilátorem jazyka C/C++. Zadejte prvek, který CustomBuildBeforeTargets má nástroj spustit před spuštěním konkrétního cíle. Pomocí elementu CustomBuildAfterTargets spusťte nástroj po spuštění konkrétního cíle. Pomocí obou prvků spusťte nástroj mezi spuštěním dvou cílů. Pokud není zadaný žádný prvek, váš vlastní nástroj sestavení se spustí ve výchozím umístění, což je před cílem MIDL .

Vlastní kroky sestavení a vlastní nástroje sestavení sdílejí informace zadané v elementech CustomBuildBeforeTargets XML.CustomBuildAfterTargets Zadejte tyto cíle jednou v souboru projektu.

Přidání vlastního nástroje pro sestavení

Přidejte do souboru projektu skupinu položek a přidejte položku pro každý vstupní soubor. Zadejte příkaz a jeho vstupy, výstupy a zprávu jako metadata položek, jak je znázorněno zde. Tento příklad předpokládá, že soubor faq.txt existuje ve stejném adresáři jako váš projekt. Vlastní krok sestavení ho zkopíruje do výstupního adresáře.
```
<ItemGroup>
  <CustomBuild Include="faq.txt">
    <Message>Copying readme...</Message>
    <Command>copy %(Identity) $(OutDir)%(Identity)</Command>
    <Outputs>$(OutDir)%(Identity)</Outputs>
  </CustomBuild>
</ItemGroup>
```

Definování, kde se v sestavení spouští vlastní nástroje sestavení

Do souboru projektu přidejte následující skupinu vlastností. Musíte zadat alespoň jeden z cílů. Druhou možnost můžete vynechat, pokud vás zajímá, že se váš krok sestavení provede jenom před konkrétním cílem (nebo po). Tento příklad provede vlastní krok po kompilaci, ale před propojením.
```
<PropertyGroup>
  <CustomBuildAfterTargets>ClCompile</CustomBuildAfterTargets>
  <CustomBuildBeforeTargets>Link</CustomBuildBeforeTargets>
</PropertyGroup>
```

Viz také

Návod: Vytvoření projektu C++ pomocí nástroje MSBuild
Postupy: Použití událostí sestavení v projektech MSBuild
Postupy: Přidání vlastního kroku sestavení do projektů MSBuild
Běžná makra pro příkazy a vlastnosti nástroje MSBuild
Metadata známých položek nástroje MSBuild