Sdílet prostřednictvím

Jak: přidat vlastní sestavení nástroje MSBuild projektů

  • Článek

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

Pro určitý soubor zadejte v souboru projektu (.vcxproj) na příkazovém řádku spustit žádné další vstupní nebo výstupní soubory a zprávy zobrazit.Pokud MSBuild Určuje výstupní soubory jsou zastaralé s ohledem na vstupní soubory, zobrazí zprávu a spustí nástroj příkazového řádku.

Určit při sestavení vlastní nástroj provede pomocí jednoho nebo obou CustomBuildBeforeTargets a CustomBuildAfterTargets prvků XML v souboru projektu.Může například určit, že nástroj pro vytváření vlastních spustit po jazyk MIDL kompilátor a před kompilátor C/C++.Zadat CustomBuildBeforeTargets prvek spustit nástroj před spuštěním určitého cíle; CustomBuildAfterTargets prvek spustit nástroj po konkrétní cíl; nebo oba prvky, spusťte nástroj mezi prováděním dvou cílů.Pokud není zadán žádný prvek, nástroj pro sestavení vlastní provede na výchozí umístění, které je před MIDL cíl.

Sestavení vlastní kroky a nástroje pro vytváření vlastních sdílet informace zadané v CustomBuildBeforeTargets a CustomBuildAfterTargets prvky XML.Určení těchto cílů jednou v souboru projektu.

Přidání sestavení vlastní nástroj

  • Přidat skupinu položek do souboru projektu a přidejte položku pro každé vstupní soubor.Jak je znázorněno zde zadejte příkaz, další vstupů, výstupů a zprávu jako metadata položky.Tento příklad předpokládá, že existuje soubor "faq.txt" ve stejném adresáři jako projekt.

      <ItemGroup>
    <CustomBuild Include="faq.txt">
      <Message>Copying readme...</Message>
      <Command>copy %(Identity) $(OutDir)%(Identity)</Command>
      <Outputs>$(OutDir)%(Identity)</Outputs>
    </CustomBuild>
  </ItemGroup>

Definujte, kde v sestavení nástroje pro vytváření vlastních provede

  • Přidejte následující skupiny vlastností do souboru projektu.Je nutné zadat alespoň jeden z cílů, ale ostatní lze vynechat, pokud vás zajímají pouze s vaší sestavení krok provést před (nebo po) určitý cíl.Tento příklad provádí vlastní krok po kompilaci, ale před propojením.

    <PropertyGroup>
  <CustomBuildAfterTargets>ClCompile</CustomBuildAfterTargets>
  <CustomBuildBeforeTargets>Link</CustomBuildBeforeTargets>
</PropertyGroup>

Viz také

Úkoly

Názorný postup: Vytvoření projektu Visual C++ pomocí nástroje MSBuild

Jak: použití sestavení událostí MSBuild projektů

Jak: přidat vlastní sestavení krok MSBuild projektů