Jak: dodać niestandardowe narzędzia do projektów programu MSBuild

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

Dla danego pliku należy określić w pliku projektu (.vcxproj) w wierszu polecenia w celu wykonania, wszelkich dodatkowych danych wejściowych lub plików wyjściowych i komunikatu wyświetlanego.Jeśli MSBuild Określa 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ędzia niestandardowe kompilacji, użyj jednej lub obu z CustomBuildBeforeTargets i CustomBuildAfterTargets elementy XML w pliku projektu.Może na przykład określić, że narzędzie do budowania niestandardowego uruchamiane po MIDL, kompilator i przed kompilator c i C++.Określ CustomBuildBeforeTargets elementu do wykonania narzędzie przed wykonaniem określonego elementu docelowego; CustomBuildAfterTargets elementu do wykonania narzędzia po do określonego elementu docelowego; lub oba te elementy do uruchomienia narzędzia między wykonaniem dwóch obiektów docelowych.Jeżeli żaden element nie jest określony, narzędzie do budowania niestandardowego wykonuje się w lokalizacji domyślnej jest przed MIDL docelowej.

Czynności niestandardowe kompilacji i niestandardowe narzędzia udostępniać informacje określone w CustomBuildBeforeTargets i CustomBuildAfterTargets elementów XML.W pliku projektu, należy określić te cele jeden raz.

Aby dodać narzędzie niestandardowe kompilacji

• Dodaj grupę towarów w pliku projektu i Dodaj element dla każdego pliku wejściowego.Określić polecenie, dodatkowe dane wejściowe, wyjść i wiadomość jako element metadanych, jak pokazano poniżej.W tym przykładzie zakłada, że istnieje 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 określić, gdzie w kompilacji narzędzia niestandardowe kompilacja będzie wykonywał

• Dodaj następujące grupy właściwości do pliku projektu.Należy określić co najmniej jeden z celów, ale można pominąć pozostałe Jeśli interesuje Cię tylko mających swoje kroku budowania wykonać przed (lub) określonego elementu docelowego.W tym przykładzie wykonuje krok niestandardowe po kompilacji, ale przed łączenia.

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

Zobacz też

Zadania

Instruktaż: Przy użyciu programu MSBuild do tworzenia projektu Visual C++

Jak: użyć zdarzenia kompilacji w projektach programu MSBuild

Jak: Dodawanie kroku budowania niestandardowego do projektów programu MSBuild