Informace o visualStudio.Extensibility (Preview)
VisualStudio.Extensibility je nová architektura pro vývoj rozšíření sady Visual Studio, která se zaměřují především na rozšíření, která z integrovaného vývojového prostředí (IDE) zabíjejí, aby se zlepšil výkon a spolehlivost. Nabízí moderní asynchronní rozhraní API, které bylo zjednodušeno 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.
V aktuální verzi Preview můžete vyvíjet širokou škálu rozšíření sady Visual Studio, včetně vytváření příkazů, práce s kódem nebo textem v editoru, zobrazování výzev nebo dialogových oken pro uživatele, vytváření vizualizérů ladicího programu a dalších možností.
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á responzivní a pokud dojde k chybovému ukončení nebo zablokování rozšíření, nedojde k chybě.
- Omezená složitost rozhraní API: VisualStudio.Extensibility zjednodušuje architekturu, konzistentní rozhraní API a jasnou dokumentaci.
- Funkce horké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é můžete napsat pomocí sady SDK sady VS. 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 SDK sady VS 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 najdete v úložišti VSExtensibility na GitHubu v oznámeních.
Navigace v dokumentaci
| Článek | Popis |
|---|---|
| Instalace rozšíření 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ě nikdy nevypracovali 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í materiály k rozhraní API | Projděte si dokumentaci k rozhraní VisualStudio.Extensibility API. |
| Experimentální rozhraní API a zásadní změny | Přečtěte si o našem přístupu k rozhraním API stable-vs-experimentální a o zásadních změnách z předchozí verze. |
| 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í verze VisualStudio.Extensibility Preview funguje se sadou Visual Studio 2022 verze 17.9 Preview 1 nebo vyšší s nainstalovanou úlohou Visual Studio extension development .
Začínáme
Následující články vám pomůžou orientovat se a začít"
- Vytvoření prvního rozšíření sady Visual Studio ukazuje, jak vytvořit ekvivalent "Hello, world" jako rozšíření.
- Vytvoření jednoduchého rozšíření vám ukáže, jak vytvořit zajímavější rozšíření, které přidá identifikátor GUID do okna editoru.
Abyste pochopili, jak pracovat s VisualStudio.Extensibility, doporučujeme důkladně porozumět asynchronnímu programování pomocí asynchronního a očekávaného injektáže závislostí a injektáže 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, projdě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, podívejte se na části nového rozšíření sady Visual Studio.
Informace o tom, co je součástí sady SDK, najdete v části 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 tématu Příspěvky
Seznamte se s modelem vzdáleného uživatelského rozhraní používaným v rozšíření 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í (IDE) najdete v tématu Příkazy.
- Práce s obsahem souborů a dokumentů najdete v tématu Rozšíření editoru.
- Spolupracujte s reprezentací samotných dokumentů v paměti, viz Dokumenty.
- Použijte okno výstupu v rozšíření, viz okno Výstup.
- Práce s okny nástrojů, ukotvitelná okna v integrovaném vývojovém prostředí sady Visual Studio, viz Okna nástrojů.
- Pomocí výzev s přizpůsobitelnými tlačítky můžete s uživatelem pracovat, viz Výzvy uživatele.
- Použití dialogů s vlastním uživatelským rozhraním k interakci s uživatelem, viz Dialogy
- Vytváření vlastních vizualizací dat při ladění, viz Vizualizéry ladicího programu
- Dotazování nebo úprava informací o řešeních projektového písku, viz Project Query
- Práce s jazykovými servery nebo LSP pro další jazykovou podporu najdete v tématu Zprostředkovatel jazykového serveru.
Ukázky a výukové programy
Řešení sady Visual Studio, které obsahuje všechny ukázky, najdete v Samples.sln.
| Vzorek | Popis |
|---|---|
| Jednoduchá obslužná rutina příkazů | Demonstruje základy práce s příkazy. Podívejte se také na 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í . |
| Nadřazení 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 dokumentů | Ukazuje, jak vytvořit příponu editoru, která se vztahuje pouze na soubory odpovídající vzoru cesty k souboru. |
| Okno Výstup | Zobrazuje nejzásadnější použití rozhraní API okna 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é okno | Ukazuje, jak uživateli zobrazit dialogové okno s vlastním uživatelským rozhraním. |
| Word count margin | Ukazuje, jak vytvořit rozšíření okrajů editoru, které zobrazuje počet slov v dokumentu. |
| Linter Markdownu | 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. |
| Odebrání komentáře | Ukazuje, jak využívat služby sady Visual Studio SDK prostřednictvím injektáže závislostí .NET a používat rozhraní API visualStudio.Extensibility pro příkazy, výzvy a zprávu o průběhu. |
| RegexMatchDebugVisualizer | Ukazuje, jak pomocí vzdáleného uživatelského rozhraní vytvořit 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 ladicího programu pro vizualizaci objektů MemoryStream, které se spustí v nemodálním okně nástroje. |
| RustLanguageServiceProvider | Ukazuje, jak vytvořit rozšíření zprostředkovatele serveru jazyka Rust, které přidává IntelliSense a popisy při otevření souboru rust. |
Experimentální rozhraní API a zásadní změny
Od verze 17.9 jsme připraveni označovat velkou 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, které by mohly být potřeba udělat, například v reakci na zpětnou vazbu uživatelů o použitelnosti, budou formálně oznámeny a s velkým množstvím oznámení na naší stránce zásadních změn .
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 plánujeme aktualizaci v budoucích verzích.
Pro tato rozhraní API jsme je explicitně označili pomocí atributu [Experimental] , který autorům rozšíření pomáhá vytvářet rozšíření s jistotou v sadě SDK.
Další informace, včetně toho, jak používat experimentální rozhraní API, najdete na stránce Experimentální rozhraní API .
Známé problémy
Vážíme si vaší zpětné vazby a hlášení chyb v našem sledování problémů a pracujeme na řešení jakýchkoli problémů zjištěných v sadě SDK.
Informace o aktuálních známých problémech najdete na naší stránce Známé problémy .
Pokročilá témata
| Článek | Popis |
|---|---|
| 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
- Microsoft.VisualStudio.Extensibility
- Microsoft.VisualStudio.Extensibility.Editor
- Microsoft.VisualStudio.ProjectSystem.Query
Odeslat názory
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 sledování problémů můžete poskytnout zpětnou vazbu a nahlásit chyby.