Přehled

Rozšíření VisualStudio.Extensibility Diagnostics Explorer je navržené tak, aby při vývoji pomohlo ladit rozšíření VisualStudio.Extensibility. Cílovou cílovou skupinou pro toto rozšíření jsou autoři rozšíření, nikoli uživatelé rozšíření. Toto rozšíření poskytuje rozhraní pro kontrolu bodů rozšiřitelnosti, s nimiž rozšíření interagují, a ukazuje, jaké konfigurační objekty rozšíření poskytují IDE, a metadata těchto konfiguračních objektů.

Začněte

Podle těchto pokynů nainstalujte, spusťte a nakonfigurujte Průzkumníka diagnostiky.

Instalace rozšíření

Průzkumníka diagnostiky můžete získat přímo prostřednictvím Správce rozšíření v sadě Visual Studio nebo z webu Visual Studio Marketplace zde.

Poznámka

Rozšíření VisualStudio.Extensibility Diagnostics Explorer je kompatibilní se sadou Visual Studio 2022 17.12 a novější.

Otevřete Průzkumníka diagnostiky v sadě Visual Studio

Pro spuštění Průzkumníka diagnostiky ve Visual Studiu vyberte v nabídce Rozšíření možnost VisualStudio.Extensibility Diagnostics Explorer.

Povolit shromažďování diagnostiky

Průzkumník diagnostiky je nakonfigurovaný tak, aby ve výchozím nastavení shromažďoval relevantní diagnostická data z vašich rozšíření. Pokud chcete shromažďování těchto dat zakázat nebo znovu povolit, můžete v levém dolním rohu okna nástroje přepnout políčko Povolit shromažďování diagnostických údajů. Aby se změny tohoto nastavení projevily, vyžaduje se restartování sady Visual Studio.

Diagnostické stránky

Levé panel okna nástroje Průzkumník diagnostiky obsahuje seznam různých stránek pro diagnostiku . Existují dva typy diagnostických stránek – rozšiřitelné funkce a infrastruktura rozšiřitelnosti. Stránky rozšiřitelných funkcí poskytují diagnostické informace o konkrétní rozšiřitelné komponentě v sadě Visual Studio, jako jsou příkazy. Stránky infrastruktury rozšiřitelnosti poskytují diagnostické informace, které jsou relevantní bez ohledu na to, do kterých bodů rozšiřitelnosti odkazuje vaše rozšíření. Stránka Události, živý prohlížeč událostí souvisejících s rozšiřitelností a stránka Kontexty klienta, která zobrazuje relevantní stav integrovaného vývojového prostředí, který vám pomůže vytvořit omezení aktivace, jsou dvě stránky infrastruktury rozšiřitelnosti.

Rozšiřitelné stránky funkcí

Rozšiřitelné stránky funkcí mají ComboBox v levém horním rohu pro různé body rozšiřitelnosti v dané oblasti funkcí, z nichž každý může být mapován přímo na konfigurační objekty ve vašem rozšíření. Například na stránce Příkazy je bod rozšiřitelnosti pro nabídky a panely nástrojů , který ukazuje jednotlivé nabídky a panely nástrojů, které sada Visual Studio zjistila v rozšířeních visualStudio.Extensibility.

Data se aktualizují v reálném čase, protože vlastnosti se aktualizují v rozšířeních. Pokud například rozšíření změní zobrazovaný název jednoho ze svých příkazů za běhu, zobrazí se nový zobrazovaný název tohoto příkazu v buňce ve sloupci Zobrazovaný název pro tento příkaz okamžitě.

Bod rozšiřitelnosti ComboBox má také položku s názvem Log, která ukazuje živé zobrazení těchto aktualizací. Tlačítko Vymazat vše vedle pole ComboBox lze použít k vymazání všech aktuálně zobrazených řádků v zobrazení.

Položky v zobrazení můžete filtrovat pomocí Extensions ComboBox. Když v tomto comboBoxu vyberete Všechny, zobrazí se data pro každé nainstalované rozšíření VisualStudio.Extensibility. Pokud změníte tuto položku ComboBox na ID konkrétního rozšíření, zobrazí se pouze položky související s tímto konkrétním rozšířením. Hodnota tohoto pole ComboBox je zachována i při navigaci mezi rozšiřitelnými stránkami funkcí.

Některé buňky v DataGridu zobrazují [Kliknutím rozbalit]. Tato zpráva znamená, že metadata související s touto vlastností jsou příliš podrobná, aby byla přehledně zobrazena v buňce DataGrid. Kliknutím na buňku se otevře modální dialogové okno zobrazující skutečnou hodnotu této buňky.

Rozšiřitelné stránky infrastruktury

Stránka Události

Na stránce událostí se zobrazí, když se v integrovaném vývojovém prostředí (IDE) něco stane. Každá událost se v DataGridu zobrazí jako nový řádek spolu s vlastnostmi souvisejícími s danou událostí. Například když je vykonán příkaz, zobrazí se v zobrazení událost Příkazy - Provádění, která ukazuje ID rozšíření, k němuž příkaz patří, a ID příkazu, který byl vykonán.

Pomocí Event ComboBox můžete vyfiltrovat zobrazení tak, aby obsahovalo pouze události s určitým názvem. Když vyberete Všechny, zobrazí se všechny události. Pokud je vybrána konkrétní událost, zobrazí se v zobrazení všechny vlastnosti události. Některé vlastnosti je potřeba rozbalit kliknutím na [Kliknutím rozbalit], pokud jsou příliš podrobné, aby se zobrazily v jedné buňce.

Contract ComboBox filtruje zobrazení tak, aby zobrazoval pouze události související s konkrétní rozšiřitelnou funkcí. Filtruje také Event ComboBox tak, aby obsahoval pouze názvy událostí souvisejících s konkrétní rozšiřitelnou funkcí.

Kliknutím na tlačítko Vymazat vše odstraníte všechny události, které jsou aktuálně zobrazeny v zobrazení.

Popisy sloupců

ID rozšíření

Sloupec id rozšíření zobrazuje ID rozšíření, se kterým souvisí instance události. Tuto buňku je možné pro některé události vyprázdnit, pokud nepatří do konkrétního rozšíření, ale místo toho platí pro integrované vývojové prostředí (IDE) jako celek.

ID položky

Sloupec ID položky zobrazuje ID položky rozšíření, se kterou souvisí instance události. Například ID položky pro příkazy – Spuštění události by bylo ID příkazu, který byl proveden.

Vlastnosti

Sloupec Vlastnosti zobrazuje sadu vlastností souvisejících s danou instancí události, která by mohla být zobrazena v jedné buňce v DataGridu. Další podrobné vlastnosti by se zobrazovaly jenom v dialogovém okně Další informace nebo změnou Event ComboBox na název konkrétní události, která vás zajímá.

Více

Sloupec Další informace zobrazuje více podrobných metadat souvisejících s událostí. Kliknutím na buňku v tomto sloupci se otevře modální dialogové okno obsahující všechna metadata související s událostí reprezentovanou daným řádkem.

Stránka Klientské kontexty

Na stránce kontextů klienta se zobrazuje stav různých vlastností souvisejících se samotným integrovaným vývojovém prostředím (IDE). Context ComboBox změní data v zobrazení tak, aby zobrazoval buď všechna omezení aktivace související s aktuálně vybranou položkou v kontextech klienta ComboBoxu, nebo protokol všech změn těchto vlastností od chvíle, kdy bylo okno nástroje otevřeno. Pokud je vybrán kontext Události, lze tlačítko Vymazat vše použít k odstranění všech aktuálně zobrazených událostí v zobrazení.