Porady: dodawanie niestandardowego kroku kompilacji do projektów MSBuild

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

Określić etap budowania niestandardowego pliku projektu (.vcxproj).Ten krok można określić wiersz polecenia, aby wykonać żadnych dodatkowych danych 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 polecenie.

Aby określić lokalizacji niestandardowej kompilacji kroku w sekwencji elementów docelowych kompilacji, użyj jednej lub obu z CustomBuildAfterTargets i CustomBuildBeforeTargets elementy XML w pliku projektu.Na przykład określić po elemencie docelowym narzędzie łącze i przed docelowego narzędzie manifestu jest uruchamiany kroku niestandardowej kompilacji.Rzeczywisty zestaw dostępnych obiektów docelowych zależy od konkretnej kompilacji.

Określ CustomBuildBeforeTargets element do wykonania kroku niestandardowej kompilacji przed upływem określonej lokalizacji docelowej, CustomBuildAfterTargets element, aby wykonać krok po uruchomieniu określonej lokalizacji docelowej lub oba te elementy do wykonania kroku między dwoma obiektami docelowymi sąsiadujących.Jeśli żaden element nie jest określony, narzędzie budowania niestandardowego wykonuje się w lokalizacji domyślnej, czyli po Link miejsce docelowe.

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

Aby zdefiniować, co jest wykonywane po kroku budowania niestandardowego

• Dodaj grupę właściwości do pliku projektu.W tej grupy właściwość określić polecenie, jego nakładów i wyników oraz komunikat, jak pokazano w następującym przykładzie.W tym przykładzie tworzy plik .cab z pliku main.cpp został utworzony w Wskazówki: Korzystanie z 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 zdefiniować, które w kompilacji krok tworzenia niestandardowej będzie wykonywał

• Dodaj następujące grupy właściwości do pliku projektu.Można określić zarówno cele, lub można pominąć jedną, jeśli chcesz tylko niestandardowy krok, aby wykonać przed lub po określonej lokalizacji docelowej.W tym przykładzie mówi MSBuild do wykonywania niestandardowy krok po kroku kompilacji, ale przed wykonaniem kroku łącze.

  <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 niestandardowych narzędzi kompilacji do projektów MSBuild