Sdílet prostřednictvím

Informace o visualStudio.Extensibility (Preview)

  • Článek

VisualStudio.Extensibility je nová architektura pro vývoj rozšíření sady Visual Studio, která se zaměřuje především na rozšíření běžící mimo proces IDE, aby byl zajištěn lepší výkon a spolehlivost. Nabízí moderní asynchronní rozhraní API, které je zjednodušené a pečlivě navrženo tak, aby maximalizovalo produktivitu vývojářů. VisualStudio.Extensibility je v aktivním vývoji a je k dispozici ve verzi Preview.

S aktuální verzí Preview můžete vyvíjet širokou škálu rozšíření pro Visual Studio, včetně těchto rozšíření, ale nikoli pouze:

  • Vytváření příkazů
  • Práce s kódem nebo textem v editoru
  • Zobrazení výzev nebo dialogových oken pro uživatele
  • Vytváření vizualizérů ladicího programu

Cílem sady VisualStudio.Extensibility je řešit mnoho problémů, které vývojáři mají při používání a psaní rozšíření v sadě Visual Studio. Vytváření rozšíření pomocí sady VisualStudio.Extensibility poskytuje následující výhody:

  • Zvýšená spolehlivost: Sada Visual Studio zůstává pohotová a nespadne, pokud dojde k chybě nebo zablokování rozšíření.
  • omezené složitosti rozhraní API: VisualStudio.Extensibility má zjednodušenou architekturu, konzistentní rozhraní API a jasnou dokumentaci.
  • funkce okamžitého načítání: Visual Studio se při instalaci rozšíření nemusí restartovat.

Nakonec budete moct pomocí sady VisualStudio.Extensibility SDK napsat jakékoli rozšíření, které byste mohli napsat pomocí sady Visual Studio SDK. Do té doby ale můžete narazit na situace, kdy funkce, které potřebujete v rozšíření, ještě nejsou v sadě VisualStudio.Extensibility k dispozici. V takovém případě můžete sadu VisualStudio.Extensibility SDK použít společně se sadou Visual Studio SDK spuštěnou v procesu a pokrýt všechny mezery v funkcích. Další informace najdete v tématu rozšíření in-proc.

Nejnovější informace o VisualStudio.Extensibility naleznete v úložišti VSExtensibility na GitHubu v oznámeních .

Článek Popis
Nainstalujte VisualStudio.Extensibility Stáhněte a nainstalujte nejnovější verzi Preview sady VisualStudio.Extensibility.
Začínáme Začněte s rychlými starty pro začátečníky a úvodními kurzy, pokud jste ještě nevyvinuli rozšíření.
Koncepty Vytvořte si mentální model fungování sady SDK a rozšíření.
Přehledy Další informace najdete v přehledech jednotlivých hlavních oblastí funkčnosti.
ukázky Prozkoumejte ukázkový kód demonstrující hlavní funkce.
Referenční rozhraní API Projděte si dokumentaci k rozhraní VisualStudio.Extensibility API.
experimentálních rozhraní API a zásadních změn Přečtěte si o našem přístupu ke stabilním a experimentálním rozhraním API a o zásadních změnách oproti předchozí verzi.
známé problémy Zobrazení známých problémů se sadou VisualStudio.Extensibility SDK
pokročilá témata Přečtěte si podrobnosti o implementaci sady VisualStudio.Extensibility SDK.

Instalace rozšíření VisualStudio.Extensibility

Aktuální VisualStudio.Extensibility preview funguje s Visual Studio 2022 verze 17.9 Preview 1 nebo novější s nainstalovanou úlohou Visual Studio extension development.

Začněte

Následující články vám pomůžou orientovat se a začít"

Abyste pochopili, jak pracovat s VisualStudio.Extensibility, doporučujeme důkladně pochopit asynchronní programování pomocí asynchronního programování a očekávat a injektáž závislostí. Kromě toho je uživatelské rozhraní v sadě VisualStudio.Extensibility založené na technologii Windows Presentation Foundation (WPF), takže můžete chtít zkontrolovat dokumentaci WPF.

Koncepty

Pokud znáte sadu Visual Studio SDK, přečtěte si Úvod do sady VisualStudio.Extensibility pro uživatele sady VSSDK.

Pokud chcete vytvořit myšlenkový model fungování rozšíření sady Visual Studio, přečtěte si článek Části nového rozšíření sady Visual Studio, kde se dozvíte o architektuře rozšíření. Dále si můžete přečíst o Dependency Injection (injektáž závislostí), který se používá ke sdílení komponent mezi částmi rozšíření.

Informace o tom, co je součástí sady SDK, najdete v tématu Funkční oblasti sady SDK.

Kdy a kde se má vaše rozšíření objevit v integrovaném vývojovém prostředí(IDE)? Rozšíření sady Visual Studio se zobrazí v integrovaném vývojovém prostředí (IDE), pokud jsou splněny určité podmínky. Pokud chcete mít kontrolu nad tím, jak a kdy se vaše rozšíření zobrazí v integrovaném vývojovém prostředí, podívejte se na omezení aktivace na základě pravidel.

Rozšíření sady Visual Studio zpřístupní své funkce sadě Visual Studio prostřednictvím příspěvků. Další informace najdete v sekci Příspěvky

Přečtěte si o modelu vzdáleného uživatelského rozhraní používaném v sadě VisualStudio.Extensibility.

Přehledy

Přečtěte si přehled oblastí sady SDK, které možná budete potřebovat pro vývojové projekty rozšíření.

  • Vytváření příkazů a jejich zveřejnění uživatelům v integrovaném vývojovém prostředí najdete v tématu Příkazy.
  • Práce s obsahem souborů a dokumentů, viz Rozšíření editoru.
  • Pracujte s paměťovou reprezentací těchto dokumentů, viz Dokumenty.
  • Použijte výstupní okno v rozšíření, viz výstupní okno.
  • Práce s nástrojovými dokovatelnými okny v integrovaném vývojovém prostředí sady Visual Studio, viz nástrojová okna.
  • Pomocí výzev s přizpůsobitelnými tlačítky můžete pracovat s uživatelem, viz Výzvy uživatele.
  • Použijte dialogy s vlastním uživatelským rozhraním k interakci s uživatelem, viz Dialogy
  • Vytvořte vlastní vizualizace dat při ladění, viz Vizualizéry ladicího programu
  • Dotazování nebo úprava informací o projektech a řešeních, viz Project Query.
  • Definujte, čtěte a aktualizujte nastavení, viz Nastavení.
  • Pracujte s jazykovými servery nebo poskytovateli LSP pro další podporu jazyků, podívejte se na Poskytovatel jazykového serveru.

Ukázky a návody

Řešení sady Visual Studio, které obsahuje všechny ukázky, najdete v Samples.sln.

Ukázka Popis
Jednoduchý zpracovatel příkazů Demonstruje základy práce s příkazy. Viz také kurz Vytvoření prvního rozšíření sady Visual Studio.
vložení rozšíření guid Ukazuje, jak vložit text nebo kód v editoru kódu, jak nakonfigurovat příkaz s konkrétní podmínkou aktivace a jak použít soubor prostředků pro lokalizaci. Podívejte se také na kurz Vytvoření jednoduchého rozšíření.
Rodičovský vztah příkazů Ukazuje, jak vytvořit příkaz, který může být nadřazený různým aspektům integrovaného vývojového prostředí (IDE).
Selektor dokumentu Ukazuje, jak vytvořit příponu editoru, která se vztahuje pouze na soubory odpovídající vzoru cesty k souboru.
okno výstupu Zobrazuje nejzákladnější použití rozhraní API pro okno výstupu
okno nástroje Ukazuje, jak vytvořit okno nástroje a naplnit ho obsahem.
výzva uživatele Ukazuje, jak uživateli zobrazit výzvu.
dialogového okna Ukazuje, jak uživateli zobrazit dialogové okno s vlastním uživatelským rozhraním.
Okraj počtu slov Ukazuje, jak vytvořit rozšíření okrajů editoru, které zobrazuje počet slov v dokumentu.
Markdown linter Ukazuje, jak může více komponent vzájemně spolupracovat uvnitř rozšíření a jak lze rozšířit různé oblasti sady Visual Studio.
dotaz projektu Zobrazuje několik různých typů dotazů systému projektů, které můžete provést.
odstranění komentáře Ukazuje, jak využívat sady Visual Studio SDK služby prostřednictvím injektáže závislostí .NET a používat rozhraní API visualStudio.Extensibility pro příkazy, výzvy a sestavu průběhu.
RegexMatchDebugVisualizer Ukazuje, jak pomocí vzdáleného uživatelského rozhraní vytvořit vizualizér ladicího programu vizualiz ér ladicího programu k vizualizaci shody regulárních výrazů, které se spustí v modálním dialogovém okně.
MemoryStreamDebugVisualizer Ukazuje, jak vytvořit vizualizér pro ladicí program, který slouží k vizualizaci objektů MemoryStream a spouští se v nemodálním okně nástroje.
PoskytovatelSlužebJazykaRust Ukazuje, jak vytvořit rozšíření poskytovatele serveru pro jazyk Rust, které přidává funkce IntelliSense a nápovědy při otevření souboru ve formátu rust.

Experimentální rozhraní API a zásadní změny

Od verze 17.9 jsme připraveni označit většinu našich rozhraní API jako stabilní. To znamená, že v těchto rozhraních API neplánujeme provádět žádné zásadní změny. Všechny zásadní změny, jako jsou změny, které uživatel vyzve ke zpětné vazbě k použitelnosti, budou formálně oznámeny předem na našich zásadních změnách stránce s ample oznámením.

K dispozici je několik našich rozhraní API, která zatím nesplňují tento pruh pro stabilitu, a to z několika důvodů:

  • Oblast funkcí je nová a další funkce a změny se očekávají v budoucích verzích.
  • Rozhraní API je nové a chceme do návrhu začlenit zpětnou vazbu uživatelů, než ho označíme jako stabilní.
  • Obdrželi jsme zpětnou vazbu, že je obtížné použít konkrétní rozhraní API, takže ho plánujeme aktualizovat v budoucích verzích.

Tato rozhraní API jsou explicitně označena pomocí atributu [Experimental], aby autorům rozšíření pomohla vytvářet jejich rozšíření s důvěrou v sadu SDK.

Další informace, včetně použití experimentálních rozhraní API, najdete na stránce Experimentální rozhraní API.

Známé problémy

Vážíme si vašich názorů a zpráv o chybách v našem nástroji na sledování problémů a pracujeme na řešení všech zjištěných problémů v SDK.

Navštivte naši stránku známých problémů pro informace o aktuálních známých problémech.

Pokročilá témata

Článek Popis
další koncepty vzdáleného uživatelského rozhraní Další témata související s prací s modelem vzdáleného uživatelského rozhraní
rozšířené vzdálené uživatelské rozhraní Podrobné informace o modelu vzdáleného uživatelského rozhraní
rozšíření in-proc Rychlý návod k různým možnostem použití sady VisualStudio.Extensibility SDK v proc

Dokumentace k rozhraní API

Odeslání zpětné vazby

Aktivně hledáme zpětnou vazbu a zapojení. Fáze Preview je skvělou dobou, jak získat vstup komunity, abychom mohli identifikovat problémy a příležitosti. V našem sledovači problémů můžete poskytnout zpětnou vazbu a nahlásit chyby.