Określanie zdarzeń kompilacji

Za pomocą zdarzeń kompilacji można określić polecenia uruchamiane przed rozpoczęciem kompilacji, przed procesem łączenia lub po zakończeniu kompilacji.

Zdarzenia kompilacji są wykonywane tylko wtedy, gdy kompilacja pomyślnie osiągnie te punkty w procesie kompilacji. Jeśli w kompilacji wystąpi błąd, zdarzenie po kompilacji nie wystąpi. Jeśli wystąpi błąd przed fazą łączenia, nie wystąpi ani połączenie wstępne, ani zdarzenie po kompilacji . Ponadto, jeśli nie trzeba łączyć plików, zdarzenie przed łączem nie występuje. Zdarzenie przed łączem nie jest również dostępne w projektach, które nie zawierają kroku łącza.

Jeśli nie trzeba kompilować żadnych plików, nie występują żadne zdarzenia kompilacji.

Aby uzyskać ogólne informacje na temat zdarzeń kompilacji, zobacz Opis niestandardowych kroków kompilacji i zdarzeń kompilacji.

Aby określić zdarzenie kompilacji

1. W Eksplorator rozwiązań wybierz projekt, dla którego chcesz określić zdarzenie kompilacji.

2. Otwórz okno dialogowe Strony właściwości projektu. Aby uzyskać więcej informacji, zobacz Set C++ compiler and build properties in Visual Studio (Ustawianie właściwości kompilatora języka C++ i kompilacji w programie Visual Studio).

3. W folderze Zdarzenia kompilacji wybierz stronę właściwości zdarzenia kompilacji.

4. Określ właściwości skojarzone ze zdarzeniem kompilacji:

   • W wierszu polecenia określ polecenie tak, jakby zostało określone w wierszu polecenia. Określ prawidłowe polecenie lub plik wsadowy oraz wszystkie wymagane pliki wejściowe lub wyjściowe. Określ wywołanie polecenia wsadowego przed nazwą pliku wsadowego, aby zagwarantować wykonanie wszystkich kolejnych poleceń.

     Wiele plików wejściowych i wyjściowych można określić symbolicznie za pomocą makr MSBuild. Aby uzyskać informacje na temat określania lokalizacji plików lub nazw zestawów plików, zobacz Typowe makra dla poleceń i właściwości kompilacji.

     Ponieważ znak "%" jest zarezerwowany przez program MSBuild, jeśli określisz zmienną środowiskową, zastąp każdy % znak ucieczki znakiem ucieczki %25 szesnastkowym. Na przykład zastąp ciąg %WINDIR% %25WINDIR%25. Program MSBuild zastępuje każdą sekwencję %25 znakiem % przed uzyskaniem dostępu do zmiennej środowiskowej.

   • W polu Opis wpisz opis tego zdarzenia. Opis jest drukowany w oknie Dane wyjściowe po wystąpieniu tego zdarzenia.

   • W obszarze Wykluczone z kompilacji określ wartość Tak , jeśli nie chcesz uruchamiać zdarzenia.

Zobacz też

Ogólne informacje o niestandardowych krokach budowania lub zdarzeniach kompilacji
Typowe makra dla właściwości i poleceń kompilacji
Rozwiązywanie problemów z dostosowaniami kompilacji