Rozwiązywanie problemów: Jak mogę wydać nową wersję istniejącego rozszerzenia?

Ważne

Obecnie tworzenie nowych rozszerzeń nie jest oficjalnie obsługiwane w programie Visual Studio 2019 dla komputerów Mac.

15 stycznia 2021 r. zostanie przesunyny serwer repozytorium rozszerzenia Visual Studio dla komputerów Mac. To przeniesienie nie będzie miało wpływu na użytkowników, którzy już pobrali Twoje rozszerzenie, ale zmieni sposób publikowania nowych wersji rozszerzenia po tej dacie.

Jako autor istniejącego rozszerzenia musisz postępować zgodnie z innym przepływem pracy, aby wydać dalsze aktualizacje. Ten proces składa się z:

  • Konfigurowanie publicznego repozytorium GitHub dla każdego rozszerzenia
  • Udostępnianie adresu URL repozytorium zespołowi Visual Studio dla komputerów Mac za pośrednictwem listy adresowej publikowania rozszerzeń
  • Aktualizowanie rozszerzenia przy użyciu funkcji wydań w programie GitHub

Konfiguracja początkowa

Aby kontynuować publikowanie aktualizacji rozszerzeń, należy utworzyć publiczne GitHub repozytorium. Jeśli publikujesz wiele rozszerzeń, musisz mieć oddzielne repozytorium dla każdego z nich, chyba że zawsze będziesz je wersjonarować i publikować razem. W takim przypadku możesz użyć jednego repozytorium.

Uwaga

Chociaż GitHub dla rozszerzenia musi być publiczne, nie trzeba tam hostować żadnego kodu. Po tym procesie nie trzeba mieć żadnego kodu w GitHub.

Udostępnianie lokalizacji repozytorium

Po skonfigurowaniu repozytorium wyślij wiadomość e-mail na listę adresową publikowania rozszerzenia z adresem URL.

Wydanie nowej wersji

Użyjesz linku "Utwórz nową wersję" na stronie głównej repozytorium, aby rozpocząć proces aktualizowania rozszerzenia. Po wybraniu tego linku wykonaj następujące kroki:

  1. Dodaj informacje do wersji tagu wydania w następującym formacie

    v <releaseVersion> - vsm<targetVersion>

    Gdzie:

    • < releaseVersion > to numer wersji rozszerzenia
    • < targetVersion > jest minimalną wersją Visual Studio dla komputerów Mac określania wartości docelowej rozszerzenia
  2. (Opcjonalnie) Pola tytułu i opisu można wypełnić dowolnymi informacjami. Ten przepływ pracy nie używa informacji w tych polach.

  3. Upewnij się, że pole wyboru wersji wstępnej nie jest zaznaczone. Jeśli to pole zostanie zaznaczone, wydanie nie zostanie odebrane przez ten proces publikowania.

  4. Dołącz pliki mpack, które implementują twoje rozszerzenie w sekcji plików binarnych. Istnieje możliwość dołączenia wielu plików mpack w wydaniu.

Visual Studio dla komputerów Mac wyświetli najnowszą wersję rozszerzenia zgodną z instalacją programu Visual Studio dla komputerów Mac, która została użyta do uzyskania dostępu do repozytorium rozszerzeń.

Tak długo, jak zarejestrowano repozytorium GitHub u zespołu Visual Studio dla komputerów Mac, wydanie rozszerzenia zostanie odebrane Visual Studio dla komputerów Mac w ciągu 24 godzin.

Dodatkowe informacje

  • Wersje, które nie są zgodne z wymaganiami szczegółowymi powyżej, nie będą publikowane.
  • Po 15 stycznia 2021 r. aktualizacje rozszerzenia będą wyświetlane tylko w Visual Studio dla komputerów Mac 8.0 lub nowszej.
  • Istniejące rozszerzenia pozostaną dostępne dla Visual Studio dla komputerów Mac użytkowników bez żadnych działań po Twojej stronie. Aby opublikować nową wersję po 15 stycznia 2021 r., należy postępować zgodnie z instrukcjami w tym przewodniku.