Przewodnik: publikowanie rozszerzenia programu Visual Studio

W tym przewodniku pokazano, jak opublikować rozszerzenie programu Visual Studio w witrynie Visual Studio Marketplace. Po dodaniu rozszerzenia do witryny Visual Studio Marketplace deweloperzy mogą używać rozszerzeń i aktualizacji do przeglądania nowych i zaktualizowanych rozszerzeń.

Wymagania wstępne

Aby wykonać czynności opisane w tym przewodniku, należy zainstalować zestaw Visual Studio SDK. Aby uzyskać więcej informacji, zobacz Instalowanie zestawu Visual Studio SDK.

Tworzenie rozszerzenia programu Visual Studio

W tym artykule jest używane domyślne rozszerzenie VSPackage, ale kroki są prawidłowe dla każdego rodzaju rozszerzenia.

• Utwórz pakiet VSPackage w języku C# o nazwie TestPublish z poleceniem menu. Aby uzyskać więcej informacji, zobacz Tworzenie pierwszego rozszerzenia: Hello World.

Zapakuj swoje rozszerzenie

1. Zaktualizuj rozszerzenie vsixmanifest , podając poprawne informacje o nazwie produktu, autorze i wersji.

   

2. Skompiluj rozszerzenie w trybie Release. Teraz rozszerzenie jest spakowane jako plik VSIX w folderze \bin\Release.

3. Możesz kliknąć dwukrotnie plik VSIX, aby zweryfikować instalację.

Testowanie rozszerzenia

Przed dystrybucją rozszerzenia skompiluj je i przetestuj, aby upewnić się, że jest on poprawnie zainstalowany w eksperymentalnym wystąpieniu programu Visual Studio.

1. W programie Visual Studio rozpocznij debugowanie, aby otworzyć eksperymentalne wystąpienie programu Visual Studio.

2. W wystąpieniu eksperymentalnym przejdź do menu Narzędzia i kliknij pozycję Rozszerzenia i aktualizacje. Rozszerzenie TestPublish powinno pojawić się w środkowym okienku i być włączone.

3. W menu Narzędzia upewnij się, że jest wyświetlane polecenie testowe.

Publikowanie rozszerzenia w witrynie Visual Studio Marketplace

1. Upewnij się, że skompilowano wersję Release rozszerzenia i że jest ona aktualna.

2. W przeglądarce internetowej przejdź do witryny Visual Studio Marketplace.

3. W prawym górnym rogu kliknij pozycję Zaloguj.

4. Zaloguj się przy użyciu konta Microsoft. Jeśli nie masz konta Microsoft, możesz go utworzyć w tym momencie.

5. Kliknij pozycję Publikuj rozszerzenia. Ta opcja powoduje przejście do strony zarządzania dla wszystkich rozszerzeń. Jeśli nie masz konta wydawcy, zostanie wyświetlony monit o jego utworzenie w tej chwili.

   

6. Wybierz wydawcę, którego chcesz wybrać do przesłania rozszerzenia. Można zmienić wydawcę, klikając na nazwy wydawców wymienione po lewej stronie. Kliknij pozycję Nowe rozszerzenie i wybierz pozycję Visual Studio.

7. W 1. Przekaż rozszerzenie, możesz przekazać plik VSIX bezpośrednio do witryny Visual Studio Marketplace lub po prostu dodać link do własnej witryny internetowej. W tym przykładzie rozszerzenie TestPublish.vsix jest przesyłane. Przeciągnij i upuść swoje rozszerzenie lub użyj linku kliknij, aby wyszukać plik. Znajdź rozszerzenie w folderze \bin\Release projektu. Kliknij przycisk Continue (Kontynuuj).

8. W punkcie 2: Podaj szczegóły rozszerzenia, niektóre pola są wypełniane automatycznie z pliku source.extension.vsixmanifest powiązanego z Twoim rozszerzeniem. Dowiedz się więcej o każdym z nich poniżej.

   • Nazwa wewnętrzna jest używana w adresie URL strony szczegółów rozszerzenia. Na przykład opublikowanie rozszerzenia pod nazwą wydawcy "myname" i określenie nazwy wewnętrznej jako "moje rozszerzenie" powoduje wyświetlenie adresu URL "marketplace.visualstudio.com/items?itemName=myname.myextension" dla strony szczegółów rozszerzenia.

   • Nazwa wyświetlana rozszerzenia. Ta nazwa jest wypełniana automatycznie z pliku source.extension.vsixmanifest .

   • Numer wersji przekazywanego rozszerzenia. Ta wersja jest wypełniana automatycznie z pliku source.extension.vsixmanifest .

   • Identyfikator VSIX to unikatowy identyfikator używany przez program Visual Studio dla rozszerzenia. Ten identyfikator jest wymagany, jeśli chcesz automatycznie zaktualizować rozszerzenie. Ten identyfikator jest wypełniany automatycznie z pliku source.extension.vsixmanifest .

   • Logo używane w Twoim rozszerzeniu. To logo jest automatycznie pobierane z pliku source.extension.vsixmanifest, w razie jego podania.

   • Krótki opis tego, co robi rozszerzenie. Ten opis jest wypełniany automatycznie z pliku source.extension.vsixmanifest .

   • Omówienie to dobre miejsce do uwzględnienia zrzutów ekranu i szczegółowych informacji o tym, co robi rozszerzenie.

   • Obsługiwane wersje programu Visual Studio umożliwiają wybranie wersji programu Visual Studio, nad którymi będzie działać rozszerzenie. Rozszerzenie jest instalowane tylko w tych wersjach.

   • Obsługiwana wersja programu Visual Studio umożliwia wybranie wersji programu Visual Studio, nad którymi będzie działać rozszerzenie. Rozszerzenie jest instalowane tylko w tych wersjach.

   • Typ. Najczęściej używanym typem rozszerzenia są narzędzia.

   • Kategorii. Wybierz maksymalnie trzy, które są najlepszym rozwiązaniem dla rozszerzenia.

   • Tagi to słowa kluczowe, które ułatwiają użytkownikom znajdowanie rozszerzenia. Tagi mogą pomóc zwiększyć trafność wyników wyszukiwania rozszerzeń w witrynie Visual Studio Marketplace.

   • Kategoria cenowa to koszt rozszerzenia.

   • Repozytorium kodu źródłowego umożliwia udostępnianie linku do kodu źródłowego społeczności.

   • Zezwalaj na pytania i odpowiedzi dla rozszerzenia umożliwia użytkownikom pozostawienie pytań na stronie wpisu rozszerzenia.

9. Kliknij Zapisz i Prześlij. Ta opcja powoduje powrót do strony zarządzania wydawcą. Rozszerzenie nie zostało jeszcze opublikowane.

10. Aby opublikować rozszerzenie, kliknij prawym przyciskiem myszy rozszerzenie i wybierz pozycję Ustaw jako publiczne. Aby zobaczyć, jak rozszerzenie będzie wyglądać w witrynie Visual Studio Marketplace, wybierz pozycję Wyświetl rozszerzenie. Aby uzyskać numery akwizycji, kliknij pozycję Raporty. Aby wprowadzić zmiany w rozszerzeniu, kliknij pozycję Edytuj.

    

11. Kliknij pozycję Ustaw jako publiczne, a rozszerzenie jest teraz publiczne. Wyszukaj rozszerzenie w witrynie Visual Studio Marketplace.

Aktualizowanie opublikowanego rozszerzenia w witrynie Visual Studio Marketplace

Przed rozpoczęciem upewnij się, że utworzono nową wersję wydania rozszerzenia i że jest ona aktualna.

1. W przeglądarce internetowej przejdź do witryny Visual Studio Marketplace.

2. W prawym górnym rogu kliknij pozycję Zaloguj się, a następnie zaloguj się przy użyciu konta Microsoft.

   

3. Kliknij pozycję Publikuj rozszerzenia, a następnie wybierz wydawcę, którego chcesz użyć do przekazania zaktualizowanego rozszerzenia.

   

4. Obok rozszerzenia, które chcesz zaktualizować, umieść wskaźnik myszy na trzech poziomych kropkach, a następnie wybierz pozycję Edytuj.

   

5. W 1: Przekaż rozszerzenie po nazwie pliku VSIX kliknij ikonę ołówka, aby edytować opublikowane rozszerzenie.

   

6. Przejdź do pliku rozszerzenia VSIX, który został zaktualizowany. Kliknij plik, a następnie kliknij przycisk Otwórz.

   Twoje zaktualizowane rozszerzenie zostaje przesłane.

   

7. W 2: Podaj szczegóły rozszerzenia, niektóre szczegóły są tylko do odczytu podczas aktualizacji rozszerzenia lub są automatycznie wypełniane z pliku source.extension.vsixmanifest w twoim rozszerzeniu. Oto więcej informacji na temat szczegółów rozszerzenia:

   • Nazwa wewnętrzna* jest używana w adresie URL strony szczegółów rozszerzenia. Na przykład opublikowanie rozszerzenia pod nazwą wydawcy "myname" i określenie nazwy wewnętrznej jako "moje rozszerzenie" powoduje wyświetlenie adresu URL "marketplace.visualstudio.com/items?itemName=myname.myextension" dla strony szczegółów rozszerzenia.

   • Nazwa wyświetlana* rozszerzenia. Ta nazwa jest wypełniana automatycznie z pliku source.extension.vsixmanifest .

   • Numer wersji* przekazywanego rozszerzenia. Ta wersja jest wypełniana automatycznie z pliku source.extension.vsixmanifest .

   • Identyfikator VSIX* to unikatowy identyfikator używany przez program Visual Studio dla rozszerzenia. Ten identyfikator jest wymagany, jeśli chcesz automatycznie zaktualizować rozszerzenie. Ten identyfikator jest wypełniany automatycznie z pliku source.extension.vsixmanifest .

   • Logo* używane dla twojego rozszerzenia. To logo jest automatycznie pobierane z pliku source.extension.vsixmanifest, w razie jego podania.

   • Krótki opis* tego, co robi rozszerzenie. Ten opis jest wypełniany automatycznie z pliku source.extension.vsixmanifest .

   • Omówienie to dobre miejsce do uwzględnienia zrzutów ekranu i szczegółowych informacji o tym, co robi rozszerzenie.

   • Obsługiwane wersje programu Visual Studio* umożliwiają wybranie wersji programu Visual Studio, nad którymi będzie działać rozszerzenie. Rozszerzenie jest instalowane tylko w tych wersjach.

   • Obsługiwana wersja programu Visual Studio* umożliwia wybranie wersji programu Visual Studio, nad którymi będzie działać rozszerzenie. Rozszerzenie jest instalowane tylko w tych wersjach.

   • Typ. Najczęściej używanym typem rozszerzenia są narzędzia.

   • Kategorii. Wybierz maksymalnie trzy, które są najlepszym rozwiązaniem dla rozszerzenia.

   • Tagi to słowa kluczowe, które ułatwiają użytkownikom znajdowanie rozszerzenia. Tagi mogą pomóc zwiększyć trafność wyników wyszukiwania rozszerzeń w witrynie Visual Studio Marketplace.

   • Kategoria cenowa to koszt rozszerzenia.

   • Repozytorium kodu źródłowego umożliwia udostępnianie linku do kodu źródłowego społeczności.

   • Zezwalaj na pytania i odpowiedzi dla rozszerzenia umożliwia użytkownikom pozostawienie pytań na stronie wpisu rozszerzenia.

     * Nie można zmienić tych szczegółów w aktualizacji rozszerzenia.

8. Kliknij Zapisz i Prześlij. Ta opcja powoduje powrót do strony zarządzania wydawcą. Rozszerzenie nie zostało jeszcze opublikowane.

9. Aby opublikować rozszerzenie, kliknij prawym przyciskiem myszy rozszerzenie i wybierz polecenie Ustaw jako publiczne. Aby zobaczyć, jak rozszerzenie będzie wyglądać w witrynie Visual Studio Marketplace, wybierz pozycję Wyświetl rozszerzenie. W przypadku numerów nabycia kliknij pozycję Raporty. Aby wprowadzić zmiany w rozszerzeniu, kliknij przycisk Edytuj.

Dodawanie dodatkowych użytkowników do zarządzania kontem wydawcy

Program Visual Studio Marketplace obsługuje udzielanie dodatkowych użytkownikom uprawnień dostępu do konta wydawcy i zarządzania nim.

1. Poproś członka, który chcesz dodać, aby zalogował się do swojego konta w witrynie Marketplace i uzyskaj identyfikator użytkownika. Identyfikator użytkownika będzie widoczny, umieszczając wskaźnik myszy na wiadomości e-mail, jak pokazano na poniższej ilustracji:

   

2. Członek może skopiować identyfikator użytkownika, klikając przycisk kopiuj do schowka, a następnie udostępnić go Tobie.

3. Przejdź do konta wydawcy, do którego chcesz dodać dodatkowych użytkowników.

4. Wybierz pozycję Członkowie i kliknij pozycję Dodaj.

   

5. Następnie możesz określić identyfikator użytkownika, który chcesz dodać, i przyznać odpowiedni poziom dostępu w obszarze Wybierz rolę. Możesz wybrać jedną z następujących opcji:

   • Twórca: użytkownik może publikować rozszerzenia, ale nie może wyświetlać rozszerzeń opublikowanych przez innych użytkowników ani zarządzać nimi.

   • Czytelnik: użytkownik może wyświetlać rozszerzenia, ale nie może publikować rozszerzeń ani zarządzać nimi.

   • Współautor: użytkownik może publikować rozszerzenia i zarządzać nimi, ale nie może edytować ustawień wydawcy ani zarządzać dostępem.

   • Właściciel: użytkownik może publikować rozszerzenia i zarządzać nimi, edytować ustawienia wydawcy i zarządzać dostępem.

Rozwiązywanie problemów z dodawaniem użytkownika do konta wydawcy

Po dodaniu użytkownika do profilu wydawcy przy użyciu jego adresu e-mail może zostać wyświetlony błąd TF14045: The identity could not be found.

Aby uniknąć tego błędu, użyj identyfikatora użytkownika zamiast adresu e-mail, aby dodać użytkownika do konta wydawcy. Aby znaleźć identyfikator użytkownika użytkownika, w witrynie Visual Studio Marketplace umieść wskaźnik myszy na nazwie użytkownika w górnej części okienka. Wybierz ikonę kopiowania, aby skopiować identyfikator użytkownika.

Następnie możesz dodać nowego użytkownika przy użyciu jego identyfikatora użytkownika.

Instalowanie rozszerzenia z witryny Visual Studio Marketplace

Teraz, po opublikowaniu rozszerzenia, zainstaluj je w programie Visual Studio i przetestuj je tam.

1. W programie Visual Studio w menu Narzędzia kliknij pozycję Rozszerzenia i aktualizacje.

2. Kliknij pozycję Online , a następnie wyszukaj pozycję TestPublish.

3. Kliknij pozycję Pobierz. Następnie planowane jest zainstalowanie rozszerzenia.

4. Aby ukończyć instalację, zamknij wszystkie instancje programu Visual Studio.

Usuwanie rozszerzenia

Rozszerzenie można usunąć z witryny Visual Studio Marketplace i z komputera.

Aby usunąć/cofnąć publikowanie rozszerzenia z witryny Visual Studio Marketplace

1. Przejdź do witryny Visual Studio Marketplace.

2. W prawym górnym rogu kliknij pozycję Publikuj rozszerzenia. Wybierz wydawcę użytego do opublikowania (np. TestPublish). Zostanie wyświetlona lista rozszerzeń.

3. Kliknij przycisk menu rozszerzenia, → kliknij przycisk Usuń. Zostanie wyświetlony monit o potwierdzenie, czy chcesz usunąć rozszerzenie.

Aby zapobiec przypadkowemu cofnięciu publikowania, musisz potwierdzić operację usuwania, podając nazwę rozszerzenia w oknie dialogowym z ostrzeżeniem. Pamiętaj, że akcja usuwania/cofania publikowania nie jest odwracalna

Aby usunąć rozszerzenie z komputera

1. W programie Visual Studio w menu Narzędzia kliknij pozycję Rozszerzenia i aktualizacje.

2. Wybierz pozycję TestPublish , a następnie kliknij pozycję Odinstaluj. Następnie zaplanowano jego odinstalowanie.

3. Aby ukończyć odinstalowywanie, zamknij wszystkie wystąpienia programu Visual Studio.