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

Etap budowania niestandardowego jest krokiem kompilacji zdefiniowane przez użytkownika.Etap budowania niestandardowego zachowuje się jak każdy inny polecenia narzędzia krok, takich jak standardowe kroku narzędzie kompilacji lub łącza.

W pliku projektu (.vcxproj), należy określić etap budowania niestandardowego.Kroku można określić wiersz polecenia do wykonywania żadnych dodatkowych danych wejściowych lub plików wyjściowych i komunikatu wyświetlanego.Jeśli MSBuild Określa, że pliki wyjściowe są nieaktualne w odniesieniu do plików wejściowych, wyświetla komunikat i wykonuje polecenie.

Określenie lokalizacji niestandardowej budowania kroku w sekwencji cele kompilacji, użyj jednej lub obu z CustomBuildAfterTargets i CustomBuildBeforeTargets elementy XML w pliku projektu.Można na przykład określić, że etap budowania niestandardowego jest uruchamiana po docelowego narzędzie łącze i przed docelowego narzędzie manifestu.Rzeczywisty zestaw dostępnych obiektów docelowych, zależy od określonego budowania.

Określ CustomBuildBeforeTargets elementu do wykonania kroku budowania niestandardowych, przed wykonaniem określonego elementu docelowego, CustomBuildAfterTargets element, aby wykonać krok po uruchomieniu określonego elementu docelowego lub oba te elementy do wykonywania kroku między dwóch sąsiadujących obiektów docelowych.Jeżeli żaden element nie jest określony, narzędzie do budowania niestandardowego wykonuje się w lokalizacji domyślnej, po Link docelowej.

Czynności niestandardowe kompilacji i niestandardowe narzędzia udostępniać informacje określone w CustomBuildBeforeTargets i CustomBuildAfterTargets elementów XML.W związku z tym określ te cele tylko jeden raz w pliku projektu.

Aby zdefiniować wykonane etap budowania niestandardowego

• Grupa właściwości należy dodać do pliku projektu.Z tej grupy właściwość określić polecenie, wejść i wyjść i wiadomości, jak pokazano w poniższym przykładzie.To przykładowe polecenie tworzy plik .cab z pliku main.cpp, utworzone w Instruktaż: Przy użyciu programu MSBuild do tworzenia projektu Visual C++.

    <ItemDefinitionGroup>
      <CustomBuildStep>
        <Command>makecab.exe $(ProjectDir)main.cpp $(TargetName).cab</Command>
        <Outputs>$(TargetName).cab</Outputs>
        <Inputs>$(TargetFileName)</Inputs>
      </CustomBuildStep>
    </ItemDefinitionGroup>
  

Aby określić, gdzie w kompilacji etap budowania niestandardowego zostanie wykonany

• Dodaj następujące grupy właściwości do pliku projektu.Można określić zarówno cele, lub można jeden pominąć, jeśli chcesz tylko niestandardowych krok, aby wykonać przed lub po określonego elementu docelowego.Informuje o tym, w tym przykładzie MSBuild do wykonywania niestandardowej krok po kroku kompilacji, ale przed wykonaniem kroku łącze.

  <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: dodać niestandardowe narzędzia do projektów programu MSBuild