Zarządzanie informacjami o kompilacji i szczegółowość kontroli

Można uzyskać szczegółowe informacje o zakończonych kompilacji:

• Jak kompilacja została uruchomiona? Czy kompilacja się powiodła?Kiedy się rozpoczęła?Jak długo trwała kompilacja?Jak wykonanie tej kompilacji odnosi się względem poprzednich kompilacji?

• Co zostało skompilowane? Które rozwiązania, zestawy zmian i naprawy usterek zawarto w tej kompilacji?

• Co poszło źle? Jakie ostrzeżenia lub błędy wystąpiły?Które testy się nie powiodły?

Możesz systematycznie kontrolować szczegółowość informacji zapisywanych na temat każdej ukończonej kompilacji, podczas definiowania procesu kompilacji.Jako alternatywę, możesz kontrolować szczegółowość dla jednego uruchomienia kompilacji, podczas jej ręcznego kolejkowania.

W tym temacie

• Jak generowane są informacje o kompilacji i ich przepływ

  • Zdefiniowanie procesu kompilacji

  • Zakolejkowanie i uruchomienie procesu kompilacji

  • Informacje o kompilacji są przetwarzane, filtrowane i przechowywane

  • Pobierz informacje o kompilacji

• Ustawienie parametrów procesu kompilacji dla szczegółowości rejestrowania

• Najlepsza praktyka: Ustawiaj stopień szczegółowość tak nisko jak to możliwe

  • Używaj minimalnej szczegółowości uruchamiając kompilację

  • Używaj minimalnej szczegółowości, projektując niestandardowy szablon procesu kompilacji.

• Aby uzyskać więcej informacji

Jak generowane są informacje o kompilacji i ich przepływ

Zdefiniowanie procesu kompilacji

Możesz systematycznie kontrolować szczegółowość informacji podczas tworzenia procesu kompilacji.Kiedy tworzysz lub edytujesz definicje kompilacji, opartą na domyślnym szablonie lub szablonie uaktualnienia, wyświetl kartę Proces.W węźle Podstawowe, można wybrać wartość z listy Szczegółowość rejestrowania do określenia tego parametru dla procesu kompilacji.

W przypadkach, gdy wbudowane szablony nie spełniają potrzeb użytkownika, można zaprojektować niestandardowy szablon procesu kompilacji.Tworząc tego typu szablon, należy uważnie zapisywać informacje o kompilacji.Aby uzyskać więcej informacji, zobacz Używaj minimalnej szczegółowości, projektując niestandardowy szablon procesu kompilacji.

Zakolejkowanie i uruchomienie procesu kompilacji

Można ręcznie zastąpić ustawienie Szczegółowości rejestrowania, kolejkując definicję kompilacji, która jest oparta na domyślnym szablonie lub szablonie uaktualnienia.W oknie dialogowym Kolejkowanie kompilacji wybierz kartę Parametry, rozwiń węzeł Podstawowe, a następnie zaznacz wartość na liście Szczegółowość rejestrowania do określenia tego parametru dla procesu kompilacji.Wartość ta jest stosowana do pojedynczego uruchomienia kompilacji.

Informacje o kompilacji są przetwarzane, filtrowane i przechowywane

System kompilacji przekazuje wartość parametru procesu kompilacji Szczegółowość do Verbosity.Ta właściwość jest używana do filtrowania informacji kompilacji, że jest rejestrowane i przechowywane na Team Foundation Server, via Information z następujących źródeł:

• Działania przepływów pracy: kilka czynności przepływu pracy generuje wiadomość, gdy operacja powiedzie się lub ostrzeżenie lub błąd, gdy operacja nie powiedzie się.Na przykład, aktywność SyncWorkspace generuje wiadomości o Niskiej ważności, gdy pobiera kod źródłowy i inne pliki z serwera do agenta kompilacji.Aktywność ta generuje błędy, gdy nie może pobrać plików.Inny przykład, aktywność OpenWorkItem generuje ostrzeżenie, gdy nie uda jej się stworzyć elementu pracy.

  Można użyć innych aktywności przepływu pracy do bezpośredniego pisania własnych informacji o kompilacji.Aby uzyskać więcej informacji, zobacz Projektowanie niestandardowego szablonu, który zapisuje informacje z minimalną niezbędną szczegółowością.

• Kompilacja kodu: proces kompilacji używa aktywności MSBuild do wykorzystania MSBuild do kompilacji plików binarnych oraz wykonywania innych ważnych zadań.Właściwość Szczegółowość tej aktywności kontroluje szczegółowość informacji, które generuje ten proces i publikuje w następujących lokalizacjach:

  • Twój Team Foundation Server przechowuje wyniki kompilacji, błędy i ostrzeżenia.

  • W folderu przechowywania dziennika są przechowywane te same informacje, jak Team Foundation Server, wraz z wszystkie inne wiadomości, które MSBuild produkuje.

• Testowanie kodu: proces kompilacji używa aktywności RunTests lub MSTest do uruchamiania testów.Wszystkie wiadomości, które dzienniku działania te są klasyfikowane o wysokiej wartości znaczenie, jeśli kontrolera kompilacja jest lokalnym lub niskie, jeśli używasz Gospodarzem kontroler budować...

Pobierz informacje o kompilacji

Podczas uruchomienia kompilacji i po jej ukończeniu, możesz pobrać zarówno podsumowanie, jak i szczegółowe informacje z okna wyników kompilacji.Możesz skopiować te informacje z okna do schowka.Można również połączyć się bezpośrednio do folderu wrzucania, aby pobrać dzienniki, pliki binarne i inne dane.

Parametr szczegółowości rejestrowania procesu kompilacji

W procesie kompilacji, opartym na domyślnym szablonie lub szablonie uaktualnienia, można użyć parametru Szczegółowość rejestrowania procesu kompilacji do zarządzania szczegółowością informacji rejestrowanych i przechowywanych.

W poniższej tabeli przedstawiono listę wartości szczegółowości rejestrowania i odpowiadające im efekty:

Wartość	Błędy	Ostrzeżenia	Wiadomości kompilacji o wysokiej ważności	Wiadomości o normalnej ważności	Wiadomości o niskiej ważności	Właściwości aktywności przepływu pracy (wejściowe i wyjściowe)
Minimalna	Y	N	N	N	N	N
Normalny	Y	Y	Y	N	N	N
Szczegółowa	Y	Y	Y	Y	N	N
Diagnostyczne (Tip: W większości przypadków należy użyć dzienników diagnostycznych.See Diagnozowanie problemów kompilacji.)	Y	Y	Y	Y	Lokalne zbudować kontrolera: Y Gospodarzem kontrolera kompilacja: N	Y

Najlepsza praktyka: Ustawiaj stopień szczegółowość tak nisko jak to możliwe

Chociaż informacje o kompilacji są ważne, proces kompilacji, który rejestruje zbyt wiele informacji, może powodować problemy.Problemy te mogą obejmować zużywa zbyt dużo pamięci masowej na Twój Team Foundation Server, powodując obniżenie wydajności programu Visual Studio i przeciążeniu członkom zespołu z większą ilością informacji, niż mogą obsłużyć.

Używaj minimalnej szczegółowości uruchamiając kompilację

Uruchamiając kompilację, należy zazwyczaj postępować według wskazówek najlepszej praktyki używania ustawienia najniższej szczegółowości, które nadal dostarcza informacji potrzebnych do osiągnięcia celu.

Używaj minimalnej szczegółowości, projektując niestandardowy szablon procesu kompilacji.

Użytkownicy procesu kompilacji polegają na filtrowaniu szczegółowości, aby ograniczyć przeciążenia spowodowane zbyt dużą ilością informacji.Można sprawić, że filtrowanie będzie bardziej skuteczne, poprzez podjęcie następujących środków:

• Upewnij się, że zaznaczono najbardziej odpowiednią aktywność do zapisywania wiadomości: Działanie WriteBuildMessage, Działanie WriteBuildWarning, Działanie WriteBuildError lub WriteBuildTestError.

• Kiedy używasz aktywności Działanie WriteBuildMessage do rejestrowania informacji, zastosuj umyślne i spójne podejście do ustawień właściwości Ważność.Używając wyższej wartości ważności dla wiadomości, należy pamiętać, że ilość danych przechowywanych i prezentowanych członkom zespołu, potencjalnie się zwiększa.

[!UWAGA]

Wpływ takich decyzji może być szczególnie znaczący, jeśli używasz takich aktywności wewnątrz struktury pętli, jak DoWhile, ForEach <T> lub While.

Aby uzyskać więcej informacji

Diagnozowanie problemów kompilacjiw tym artykule opisano, jak uzyskać dzienniki diagnostyczne.

Team Foundation Tworzenie działań opisuje czynności przepływu pracy procesu kompilacji, które wymieniono w tym temacie.

Zdefiniowanie procesu tworzenia, oparty na szablonie domyślne i Użyj procesy budowania Legacy dostarczają wskazówki na temat sposobu tworzenia i obsługiwania definicji kompilacji opartych na domyślnym szablonie i szablonie uaktualnienia.

Wyświetlanie wyników kompilacji dostarcza wskazówek dotyczących sposobu użycia okna wyników kompilacji.

IBuildDetail, BuildMessageImportance i BuildVerbosity opisują niektóre kluczowych elementy API Team Foundation Build, które dostarczają funkcjonalności informacji o kompilacji.

Informacje w wierszu polecenia programu MSBuild opisuje MSBuild.

Określ wyzwalaczy kompilacji i przyczyny i Kolejka kompilacji opisują sposób automatycznego i ręcznego kolejkowania kompilacji.