Informacje o rozszerzalności Programu VisualStudio.Extensibility (wersja zapoznawcza)
VisualStudio.Extensibility to nowa struktura do tworzenia rozszerzeń programu Visual Studio, które koncentrują się głównie na rozszerzeniach, które wybiegają poza procesem ze środowiska IDE w celu zwiększenia wydajności i niezawodności. Oferuje nowoczesny, asynchroniczny interfejs API, który został usprawniony i starannie zaprojektowany, aby zmaksymalizować produktywność deweloperów. Rozszerzenie VisualStudio.Extensibility jest aktywne i jest dostępne jako wersja zapoznawcza.
W bieżącej wersji zapoznawczej możesz opracować szeroką gamę rozszerzeń programu Visual Studio, w tym tworzyć polecenia, pracować z kodem lub tekstem w edytorze, wyświetlać monity lub okna dialogowe dla użytkownika, tworzyć wizualizatory debugera i nie tylko!
Rozszerzenie VisualStudio.Extensibility ma na celu rozwiązanie wielu problemów, które deweloperzy doświadczają podczas korzystania z rozszerzeń i pisania ich w programie Visual Studio. Pisanie rozszerzeń przy użyciu rozszerzenia VisualStudio.Extensibility zapewnia następujące korzyści:
- Zwiększona niezawodność: program Visual Studio pozostaje dynamiczny i nie ulega awarii, jeśli rozszerzenie ulegnie awarii lub zawiesza się.
- Zmniejszona złożoność interfejsu API: rozszerzenie VisualStudio.Extensibility ma uproszczoną architekturę, spójne interfejsy API i przejrzystą dokumentację.
- Funkcja ładowania na gorąco: program Visual Studio nie musi być ponownie uruchamiany podczas instalowania rozszerzeń.
W końcu będzie można użyć zestawu SDK VisualStudio.Extensibility do napisania dowolnego rozszerzenia, które można napisać przy użyciu zestawu VS SDK. Jednak do tego czasu mogą wystąpić sytuacje, w których funkcje potrzebne w rozszerzeniu nie są jeszcze dostępne w programie VisualStudio.Extensibility. W takim przypadku można użyć zestawu VisualStudio.Extensibility SDK razem z zestawem VS SDK uruchomionym w procesie, aby pokryć wszelkie luki w funkcjach. Aby dowiedzieć się więcej, zobacz Rozszerzenia w proc.
Najnowsze informacje na temat rozszerzenia VisualStudio.Extensibility można znaleźć w repozytorium GitHub VSExtensibility w ogłoszeniach.
Nawigowanie po dokumentacji
| Artykuł | opis |
|---|---|
| Instalowanie rozszerzenia VisualStudio.Extensibility | Pobierz i zainstaluj najnowszą wersję zapoznawcza programu VisualStudio.Extensibility. |
| Rozpocznij | Zacznij od przewodników Szybki start dla początkujących i samouczków wprowadzających, jeśli wcześniej nie utworzono rozszerzenia. |
| Pojęcia | Utwórz model mentalny sposobu działania zestawu SDK i rozszerzeń. |
| Omówienia | Dowiedz się więcej, zapoznając się z omówieniem poszczególnych głównych obszarów funkcjonalności. |
| Samples | Zapoznaj się z przykładowym kodem demonstrującymi główne funkcje. |
| Dokumentacja interfejsu API | Przejrzyj dokumentację interfejsu API rozszerzenia VisualStudio.Extensibility. |
| Eksperymentalne interfejsy API i zmiany powodujące niezgodność | Dowiedz się więcej o naszym podejściu do interfejsów API stabilnych i eksperymentalnych oraz o zmianach powodujących niezgodność z poprzedniej wersji. |
| Znane problemy | Wyświetl znane problemy z zestawem VisualStudio.Extensibility SDK. |
| Tematy zaawansowane | Poznaj szczegóły implementacji zestawu VisualStudio.Extensibility SDK. |
Instalowanie rozszerzenia VisualStudio.Extensibility
Bieżąca wersja zapoznawcza programu VisualStudio.Extensibility współpracuje z programem Visual Studio 2022 w wersji 17.9 (wersja zapoznawcza 1 lub nowsza) z Visual Studio extension development zainstalowanym obciążeniem.
Rozpocznij
Poniższe artykuły ułatwiają zorientowanie się i rozpoczęcie pracy"
- Tworzenie pierwszego rozszerzenia programu Visual Studio pokazuje, jak utworzyć odpowiednik "Hello, world" jako rozszerzenie.
- Tworzenie prostego rozszerzenia pokazuje, jak utworzyć bardziej interesujące rozszerzenie, które dodaje identyfikator GUID do okna edytora.
Aby zrozumieć, jak pracować z programem VisualStudio.Extensibility, zalecamy dokładne zrozumienie programowania asynchronicznego za pomocą asynchronicznego i iniekcji zależności i oczekiwania. Ponadto interfejs użytkownika w programie VisualStudio.Extensibility jest oparty na programie Windows Presentation Foundation (WPF), więc warto przejrzeć dokumentację platformy WPF.
Pojęcia
Jeśli znasz zestaw Visual Studio SDK, zapoznaj się z artykułem Introduction to VisualStudio.Extensibility for VSSDK users (Wprowadzenie do programu VisualStudio.Extensibility dla użytkowników zestawu VSSDK).
Aby utworzyć model mentalny sposobu działania rozszerzeń programu Visual Studio, zobacz Części nowego rozszerzenia programu Visual Studio.
Aby dowiedzieć się, co jest zawarte w zestawie SDK, zobacz Obszary funkcjonalne zestawu SDK.
Kiedy i gdzie powinno pojawić się rozszerzenie w środowisku IDE? Rozszerzenia programu Visual Studio są wyświetlane w środowisku IDE po spełnieniu określonych warunków. Aby kontrolować sposób i czas wyświetlania rozszerzenia w środowisku IDE, zobacz Ograniczenia aktywacji opartej na regułach.
Rozszerzenia programu Visual Studio udostępniają swoje funkcje w programie Visual Studio za pośrednictwem współtworzenia. Aby uzyskać więcej informacji, zobacz Współtworzenie
Dowiedz się więcej o modelu zdalnego interfejsu użytkownika używanym w programie VisualStudio.Extensibility.
Omówienia
Zapoznaj się z omówieniem obszarów zestawu SDK, które mogą być potrzebne w projektach deweloperskich rozszerzeń.
- Utwórz polecenia i uwidocznij je użytkownikom w środowisku IDE, zobacz Polecenia.
- Praca z zawartością plików i dokumentów, zobacz Rozszerzenia edytora.
- Praca z reprezentacją tych dokumentów w pamięci, zobacz Dokumenty.
- Użyj okna danych wyjściowych w rozszerzeniu, zobacz okno Dane wyjściowe.
- Praca z oknami narzędzi, oknami z możliwością dokowania w środowisku IDE programu Visual Studio, zobacz Okna narzędzi.
- Użyj monitów z przyciskami z możliwością dostosowywania, aby wchodzić w interakcję z użytkownikiem, zobacz Monity użytkownika.
- Używanie okien dialogowych z niestandardowym interfejsem użytkownika do interakcji z użytkownikiem, zobacz Okna dialogowe
- Tworzenie niestandardowych wizualizacji danych podczas debugowania, zobacz Debugger Visualizers (Wizualizatory debugera)
- Wykonywanie zapytań lub modyfikowanie informacji o rozwiązaniach z piaskiem projektu, zobacz Project Query (Zapytanie projektu)
- Praca z serwerami językowymi/dostawcą LSP w celu uzyskania dodatkowej obsługi języka, zobacz Dostawca serwera językowego
Przykłady i samouczki
Rozwiązanie programu Visual Studio zawierające wszystkie przykłady można znaleźć w Samples.sln.
| Przykład | opis |
|---|---|
| Prosta procedura obsługi poleceń | Demonstruje podstawy pracy z poleceniami. Zobacz również samouczek Tworzenie pierwszego rozszerzenia programu Visual Studio. |
| Wstaw rozszerzenie guid | Pokazuje, jak wstawić tekst lub kod w edytorze kodu, jak skonfigurować polecenie z określonym warunkiem aktywacji oraz jak używać pliku zasobu do lokalizacji. Zobacz również samouczek Tworzenie prostego rozszerzenia . |
| Rodzicielstwo poleceń | Pokazuje, jak utworzyć polecenie, które może być nadrzędne dla różnych aspektów środowiska IDE. |
| Selektor dokumentów | Pokazuje, jak utworzyć rozszerzenie edytora, które ma zastosowanie tylko do plików pasujących do wzorca ścieżki pliku. |
| Okno danych wyjściowych | Pokazuje najbardziej podstawowe użycie interfejsu API okna danych wyjściowych |
| Okno narzędzi | Pokazuje, jak utworzyć okno narzędzia i wypełnić je zawartością. |
| Monit użytkownika | Pokazuje, jak wyświetlić monit dla użytkownika. |
| Okno dialogowe | Pokazuje, jak wyświetlić okno dialogowe z niestandardowym interfejsem użytkownika dla użytkownika. |
| Margines liczby wyrazów | Pokazuje, jak utworzyć rozszerzenie marginesu edytora, które wyświetla liczbę wyrazów w dokumencie. |
| Linter markdown | Pokazuje, jak wiele składników może współdziałać w ramach rozszerzenia i jak można rozszerzyć różne obszary programu Visual Studio. |
| Zapytanie projektu | Przedstawia kilka różnych rodzajów zapytań systemowych projektu, które można wykonać. |
| Usuwanie komentarzy | Przedstawia sposób korzystania z usług zestawu SDK programu Visual Studio za pomocą wstrzykiwania zależności platformy .NET i używania interfejsów API programu VisualStudio.Extensibility dla poleceń, wierszy i raportu postępu. |
| RegexMatchDebugVisualizer | Pokazuje, jak używać zdalnego interfejsu użytkownika do tworzenia wizualizatora debugera w celu wizualizacji dopasowań wyrażeń regularnych, które zostaną uruchomione w modalnym oknie dialogowym. |
| MemoryStreamDebugVisualizer | Pokazuje, jak utworzyć wizualizator debugera w celu wizualizacji obiektów MemoryStream uruchamianych w niemodalnym oknie narzędzi. |
| RustLanguageServiceProvider | Pokazuje, jak utworzyć rozszerzenie dostawcy serwera języka Rust, które dodaje funkcję IntelliSense i etykietki narzędzi po otwarciu pliku rust. |
Eksperymentalne interfejsy API i zmiany powodujące niezgodność
Począwszy od wersji 17.9, możemy oznaczyć zdecydowaną większość naszych interfejsów API jako stabilną. Oznacza to, że nie planujemy wprowadzać żadnych zmian powodujących niezgodność w tych interfejsach API. Wszelkie zmiany powodujące niezgodność, które mogą być konieczne, na przykład w odpowiedzi na opinie użytkowników dotyczące użyteczności, będą przekazywane formalnie i z dużą ilością informacji na naszej stronie zmian powodujących niezgodność.
Istnieje kilka naszych interfejsów API, które jeszcze nie spełniają tego paska ze względu na stabilność, z jednego z kilku powodów:
- Obszar funkcji to nowe, a dodatkowe funkcje i zmiany są oczekiwane w przyszłych wersjach.
- Interfejs API jest nowy i chcemy dołączyć opinie użytkowników do projektu przed oznaczeniem go stabilnym.
- Otrzymaliśmy opinię, że konkretny interfejs API jest trudny do użycia, dlatego planujemy zaktualizowanie go w przyszłych wersjach.
W przypadku tych interfejsów API jawnie oznaczyliśmy je za pomocą atrybutu [Experimental] , aby ułatwić autorom rozszerzeń tworzenie rozszerzeń z zaufaniem do zestawu SDK.
Aby uzyskać więcej informacji, w tym jak używać eksperymentalnych interfejsów API, zobacz naszą stronę eksperymentalnych interfejsów API.
Znane problemy
Doceniamy Twoje opinie i raporty o błędach w naszym trackerze problemów i pracujemy nad rozwiązaniem wszelkich problemów znalezionych w zestawie SDK.
Odwiedź naszą stronę Znane problemy , aby uzyskać informacje o wszelkich znanych problemach.
Tematy zaawansowane
| Artykuł | opis |
|---|---|
| Zaawansowany zdalny interfejs użytkownika | Szczegółowe informacje na temat zdalnego modelu interfejsu użytkownika |
| Rozszerzenia w proc | Krótki przewodnik po różnych opcjach korzystania z zestawu VisualStudio.Extensibility SDK w proc |
Dokumentacja interfejsu API
- Microsoft.VisualStudio.Rozszerzalność
- Microsoft.VisualStudio.Extensibility.Editor
- Microsoft.VisualStudio.ProjectSystem.Query
Wyślij opinię
Aktywnie szukamy opinii i zaangażowania. Faza wersji zapoznawczej to doskonały czas, aby uzyskać wkład społeczności, aby pomóc nam zidentyfikować problemy i możliwości. Możesz przekazać opinię i zgłosić usterki w naszym monitorze problemów.