Porady: dodawanie niestandardowych narzędzi kompilacji do projektów MSBuild

Narzędzie niestandardowe kompilacji jest narzędziem wiersza polecenia, zdefiniowanych przez użytkownika skojarzonego z danym plikiem.

Dla określonego pliku określ w pliku projektu (.vcxproj) w wierszu polecenia do wykonywania żadnych dodatkowych danych wejściowych lub plików wyjściowych i komunikatu wyświetlanego.Jeśli MSBuild stwierdzi, że Twoje pliki wyjściowe są nieaktualne w odniesieniu do plików wejściowych, wyświetla komunikat i wykonuje narzędzie wiersza polecenia.

Aby określić, kiedy wykonuje narzędzie niestandardowej kompilacji, użyj jednej lub obu z CustomBuildBeforeTargets i CustomBuildAfterTargets elementy XML w pliku projektu.Na przykład określić, że Twoje narzędzie do budowania niestandardowego uruchomić po kompilator regionów i przed kompilatora języka C/C++.Określ CustomBuildBeforeTargets element wykonać narzędzie przed upływem określonego miejsce docelowe; CustomBuildAfterTargets element do wykonania narzędzia po określonej lokalizacji docelowej; lub oba te elementy do uruchomienia narzędzia między wykonaniem dwóch obiektów docelowych.Jeśli żaden element nie jest określony, narzędzie zwyczaj budowania wykonuje w lokalizacji domyślnej, czyli przed MIDL miejsce docelowe.

Kroki kompilacji niestandardowej i narzędzia do tworzenia niestandardowych udostępniać informacje określone w CustomBuildBeforeTargets i CustomBuildAfterTargets elementów XML.Określić cele te jeden raz w pliku projektu.

Aby dodać narzędzie do budowy niestandardowych

• Dodaj grupę towarów do pliku projektu i dodać element dla każdego pliku wejściowego.Określić polecenie, dodatkowych nakładów, wyników oraz wiadomość jako metadanych elementu, jak pokazano poniżej.W tym przykładzie założono, że plik "faq.txt" w tym samym katalogu co projektu.

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

Aby zdefiniować, gdzie w kompilacji narzędzia do tworzenia niestandardowych będzie wykonywał

• Dodaj następujące grupy właściwości do pliku projektu.Należy określić co najmniej jeden z obiektów docelowych, ale można pominąć drugiej, jeśli interesuje Cię tylko po kroku budowania wykonać przed (lub po) określonej lokalizacji docelowej.W tym przykładzie wykonuje niestandardowy krok po kompilacji, ale przed łączeniem.

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

Zobacz też

Zadania

Wskazówki: Korzystanie z MSBuild do tworzenia projektu Visual C++

Porady: korzystanie ze zdarzeń kompilacji w projektach MSBuild

Porady: dodawanie niestandardowego kroku kompilacji do projektów MSBuild