Przegląd

Rozszerzenie VisualStudio.Extensibility Diagnostics Explorer zostało zaprojektowane tak, aby ułatwić debugowanie rozszerzeń VisualStudio.Extensibility podczas ich opracowywania. Docelowi odbiorcy tego rozszerzenia to autorzy rozszerzeń, a nie odbiorcy rozszerzeń. To rozszerzenie zapewnia interfejs do sprawdzania punktów rozszerzalności, z którymi wchodzą w interakcję rozszerzenia, a także jakie obiekty konfiguracji rozszerzenia dostarczają środowisku IDE oraz metadane tych obiektów konfiguracji.

Rozpocznij

Postępuj zgodnie z tymi instrukcjami, aby zainstalować, uruchomić i skonfigurować Eksploratora diagsnotics.

Instalowanie rozszerzenia

Eksplorator diagnostyki można pobrać bezpośrednio za pośrednictwem Menedżera rozszerzeń w Visual Studio lub z Visual Studio Marketplace tutaj.

Notatka

Rozszerzenie VisualStudio.Extensibility Diagnostics Explorer jest zgodne z programem Visual Studio 2022 17.12 i nowszym.

Otwieranie Eksploratora diagnostyki w programie Visual Studio

Aby uruchomić Eksploratora diagnostyki w programie Visual Studio, wybierz pozycję VisualStudio.Extensibility Diagnostics Explorer w menu Rozszerzenia.

Włączanie zbierania diagnostyki

Eksplorator diagnostyki jest domyślnie skonfigurowany do zbierania odpowiednich danych diagnostycznych z rozszerzeń. Jeśli chcesz wyłączyć lub ponownie włączyć zbieranie tych danych, możesz przełączyć włącz zbieranie diagnostyki w lewym dolnym rogu okna narzędzia. Aby zmiany tego ustawienia zaczęły obowiązywać, wymagane jest ponowne uruchomienie programu Visual Studio.

Strony diagnostyczne

Lewy panel okna narzędzia Eksplorator diagnostyki zawiera listę różnych stron diagnostycznych . Istnieją dwa typy stron diagnostycznych — rozszerzalne funkcje i infrastruktura rozszerzalności. Rozszerzalne strony funkcji zawierają informacje diagnostyczne dotyczące określonego rozszerzalnego składnika w programie Visual Studio, na przykład polecenia. pl-PL: Strony infrastruktury rozszerzalności zapewniają informacje diagnostyczne, które są istotne niezależnie od tego, do których punktów rozszerzeń podłącza się Twoje rozszerzenie. Strona Zdarzenia, będąca podglądem na żywo dla zdarzeń związanych z rozszerzalnością, oraz strona kontekstów klienta, która pokazuje odpowiedni stan IDE, aby ułatwić tworzenie ograniczeń aktywacji, to dwie strony infrastruktury rozszerzalności.

Rozszerzalne strony funkcji

Rozszerzalne strony funkcji mają pole ComboBox w lewym górnym rogu dla różnych punktów rozszerzalności w tym obszarze funkcji, z których każdy może być mapowany bezpośrednio na obiekty konfiguracji w rozszerzeniu. Na przykład na stronie Polecenia znajduje się Punkt Rozszerzalności dotyczący Menu i Pasków Narzędzi , który pokazuje wszystkie menu i paski narzędzi rozpoznane przez Visual Studio w rozszerzeniach VisualStudio.Extensibility.

Dane są aktualizowane w czasie rzeczywistym, gdy właściwości są aktualizowane w rozszerzeniach. Natychmiast, jeśli na przykład jedno z rozszerzeń zmienia nazwę wyświetlaną jednego z jego poleceń w czasie wykonywania, nowa nazwa tego polecenia jest pokazywana w komórce w kolumnie Nazwa wyświetlana dla tego polecenia.

Punkt rozszerzalności ComboBox ma również element o nazwie Log, który pokazuje widok na żywo tych aktualizacji. Przycisk Wyczyść wszystkie obok pola ComboBox może służyć do czyszczenia wszystkich wierszy aktualnie wyświetlanych w widoku.

Elementy w widoku można filtrować przy użyciu Extensions ComboBox. Po wybraniu Wszystkie w tym kombiBox są wyświetlane dane dla każdego zainstalowanego rozszerzenia VisualStudio.Extensibility. Jeśli zmienisz to pole kombi na identyfikator określonego rozszerzenia, zostaną wyświetlone tylko elementy związane z tym rozszerzeniem. Wartość tego pola ComboBox jest zachowywana nawet podczas nawigacji między stronami z funkcjami rozszerzalnymi.

Niektóre komórki w usłudze DataGrid wyświetlają [kliknij, aby rozwinąć]. Ten komunikat oznacza, że metadane związane z tą właściwością są zbyt rozwlekłe, aby można było starannie wyświetlić je w komórce DataGrid. Kliknięcie komórki powoduje otwarcie modalnego okna dialogowego z rzeczywistą wartością tej komórki.

Rozszerzalne strony infrastruktury

Strona zdarzeń

Strona zdarzeń pokazuje, kiedy "coś się stanie" w środowisku IDE. Każde zdarzenie jest wyświetlane jako nowy wiersz w usłudze DataGrid wraz z wszelkimi właściwościami powiązanymi z tym zdarzeniem. Na przykład, gdy polecenie jest wykonywane, w widoku pojawia się zdarzenie Polecenia — wykonywanie, pokazujące identyfikator rozszerzenia, do którego należy polecenie, oraz identyfikator wykonanego polecenia.

Możesz użyć Event ComboBox, aby filtrować widok tak, aby zawierał tylko zdarzenia o określonej nazwie. Po wybraniu opcji Wszystko, wszystkie zdarzenia zostaną wyświetlone. W przypadku wybrania określonego zdarzenia wszystkie właściwości zdarzenia są wyświetlane w widoku. Niektóre właściwości należy rozszerzyć, klikając [Kliknij, aby rozwinąć], jeśli są one zbyt szczegółowe, aby wyświetlić je w jednej komórce.

Contract ComboBox filtruje widok tak, aby pokazywał tylko zdarzenia związane z określoną funkcją rozszerzalną. Filtruje również Event ComboBox tak, aby zawierała tylko nazwy zdarzeń związanych z konkretną funkcją rozszerzalną.

Kliknięcie przycisku wyczyść wszystkie powoduje usunięcie wszystkich zdarzeń aktualnie wyświetlanych w widoku.

Opisy kolumn

Identyfikator rozszerzenia

Kolumna Identyfikator rozszerzenia pokazuje identyfikator rozszerzenia, z którym jest powiązane wystąpienie zdarzenia. Ta komórka może być pusta dla niektórych zdarzeń, jeśli nie należą do określonego rozszerzenia, ale zamiast tego ma zastosowanie do całego środowiska IDE.

Identyfikator elementu

Kolumna Identyfikator elementu zawiera identyfikator elementu rozszerzenia, z którą jest powiązane wystąpienie zdarzenia. Na przykład identyfikator elementu dla poleceń — wykonanie zdarzenia będzie identyfikatorem wykonanego polecenia.

Właściwości

Kolumna właściwości zawiera zestaw właściwości powiązanych z tym wystąpieniem zdarzenia, które można wyświetlić w jednej komórce w usłudze DataGrid. Bardziej szczegółowe właściwości będą widoczne tylko w oknie dialogowym Więcej informacji lub przez zmianę ComboBox zdarzenia na nazwę konkretnego zdarzenia, które cię interesuje.

Więcej informacji

Kolumna Więcej informacji zawiera bardziej szczegółowe metadane związane ze zdarzeniem. Kliknięcie komórki w tej kolumnie powoduje otwarcie modalnego okna dialogowego zawierającego wszystkie metadane związane ze zdarzeniem reprezentowanym przez ten wiersz.

Strona kontekstów klienta

Strona kontekstów klienta przedstawia stan różnych właściwości związanych z samym środowiskiem IDE. Context ComboBox zmienia dane w widoku, aby wyświetlić wszystkie ograniczenia aktywacji związane z aktualnie wybranym elementem w Konteksty klienta ComboBox, albo dziennik wszystkich zmian tych właściwości od czasu otwarcia okna narzędzia. Po wybraniu kontekstu zdarzeń można użyć przycisku Wyczyść wszystkie, aby usunąć wszystkie zdarzenia aktualnie wyświetlane w widoku.